Javadoc references missing CreatesSwipeAction interface

[darina-techery]

Hello guys,

I have recently updated to java-client 5.0, beta 8, and I started seeing warnings about SwipeElementDirection being deprecated.
When I looked through classes and methods providing swipe functionality, I could see all of them were marked as @Deprecated.

In TouchableElement I saw the following:

@Deprecated
/**
* This method is deprecated and it is going to be removed.
* Please use the {@link CreatesSwipeAction#swipe(WebElement, SwipeElementDirection, int, int, int)}
* instead.
*/
void swipe(SwipeElementDirection direction, int offsetFromStartBorder, int offsetFromEndBorder,
int duration) throws IllegalCoordinatesException;

but there is no interface CreatesSwipeAction, at least not in your github repo or in javadocs. It only shows up in 1 commit: https://github.com/appium/java-client/commit/34a718bcc5eb8966b196df7c610d15390b8f3bab

Should we expect any replacement for Swipe, a renovation of this interface maybe, or is it just combination of press-moveTo-release now?

[in-ishan]

i think it will be combination of press-move-wait-release:- https://discuss.appium.io/t/java-client-5-0-0-beta1-released/13984

[darina-techery]

Then the JavaDoc should be cleaned up in order not to mislead the users.

[olyv]

Yeah, javadoc seems to be abandoned. Another example of deprecated (but not deprecated in javadoc) is findElementByName() https://appium.github.io/java-client/io/appium/java_client/MobileElement.html#findElementByName-java.lang.String-