Selenium 4 Support with python-client v2.0.0

• Deprecate the TouchAction keywords
• Deprecate launch_application, quit_application, reset_application according to Appium Python Client
• Rename Activate App to Activate Application for consistency
• Rename Background App to Background Application for consistency
• Rename Stop App to Stop Application for consistency
• Rename Remove App to Remove Application for consistency
• Added Terminate Application
• Support for strict_ssl added in Open Application
• Support for arguments(dict) with Execute Script and Execute Async Script
• Added Tap With Positions that uses new ActionChain of w3c
• Espresso selector support (viewtag, data matcher, view matcher)
• Fix all find_element_by to find_element using AppiumBy

What's Changed

• Adding new keyword adb command timeout by @felipetortella in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/328
• Add the possibility to embed screenshots in log.html as base64 content by @arnaudruffin in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/332
• Support applications with multiple webviews. Add scrolling to the visible webview. by @matthew-dahm in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/329
• Version bump by @sadikkuzu in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/345
• Fix for #352 by @js361014 in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/353
• Added file deleting support for Android by @js361014 in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/354
• Added get_element_rect by @js361014 in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/356
• Added app activation by @js361014 in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/359
• Added remove app by @js361014 in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/361
• Added stopping app by @js361014 in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/360

New Contributors

• @felipetortella made their first contribution in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/328
• @arnaudruffin made their first contribution in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/332
• @matthew-dahm made their first contribution in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/329
• @sadikkuzu made their first contribution in https://github.com/serhatbolsu/robotframework-appiumlibrary/pull/345

Full Changelog: https://github.com/serhatbolsu/robotframework-appiumlibrary/compare/1.6.3...2.0.0

• Scroll fix of Appium 1.22 by @Wolfe1
• Added switch iframe and parent frame by @KenSrc

• Sample code
• Documentation update on how to start
• Execute Adb Shell - new keyword added
• Screen record - new keyword added
• Is Keyboard Shown - new keyword added
• (iOS) Chain - locator added
• (iOS) Tab multiple times - new keyword added
• (Android) Open Notifications - new keyword added

• Some of the best practices uses a way not to open/close webdriver session on every test case.
  Releasing support to Launch/Quit application while keeping the webdriver session open. Refer to keyword documentation for an example.
  Since Open Application / Close Application are used keyword naming, Launch / Quit are used
• Unicode support required improvements as Appium has done some changes on iOS side.

New Keywords:

• iOS predicates selector - new locator strategy
• Execute Sync/Async Script in Web context - new keyword added
• Long press has time parameter now
• Added log-level filter for reporting
• Set Location Keyword - new keyword added
• Appium-Python library min-version bump
• Simulate Touch ID on iOS Simulator

• Not visible element and text should be able to return error, this will be possible with new added keywords.
• Each device has different pixel rations which also effects test case script for pixels not being reliable.
  Swipe By Percent will handle swipes without requiring pixels.

New Keywords:

• Unicode better support

Appium shortcomings cause testing challenges with unicode characters or non-english apps. Each platform have different implementation underlying so their behaviour is different. While Android can handle unicode characters inside xpath, iOS can not. Unicode normalization used in order to make everything work without hassle.

• Unicode supported now inside xpath text.
  example:

Click Element  //*[@name="öışğ"]
Input Text  //*[contains(@text, "ışüğ")] 

• Click Text iOS handling is much better now. Works regardless if text is name, value or label
  example:

Click Text  SignUp

This will first check if name does match, if not it will check value or label. But this is just logic underlying.

Please do not hesitate to open issues

Important new features and compatibility features with Selenium added in this release

Selectors now takes id and xpath as default so you do not need to specify if you are using id or xpath (which starts with //) . Also you can now use WebElement in addition to other locators.
Existing test cases will not be effected, no change is required 👍

• New finding elements strategy now supports directly using WebElement. Check keyword documentation for more information.
• Added default locator strategies. Default is: id and xpath check library introduction for more details.
• Click Text added as keyword in which you can directly click on found texts. Underlying it works on predefined xpath depending on platform.
• Unicode fixes also reflected on Page Should Contain Text and Page Should Not Contain Text
• Getting an element text is added and its helper keywords.

New Keywords:

Name Change: (Breaking Change)
Get Element -> Get Webelement
Get Elements -> Get Webelements

Source distribution is available at PyPI and pip users can simply run:

# to install or upgrade to the latest release.
pip install --upgrade robotframework-appiumlibrary

Important new features and compatibility features with Selenium added in this release

Selectors now takes id as default so you do not need to specify if you are using id . Also you can now use WebElement in addition to other locators.

• New finding elements strategy now supports directly using WebElement. Check keyword documentation for more information.
• (not-implemented-yet)Added default locator strategies. Default is: id which actually means : accessibility_id
• Unicode fixes also reflected on Page Should Contain Text and Page Should Not Contain Text

Source distribution is available at PyPI and pip users can simply run
pip install --pre --upgrade robotframework-appiumlibrary to install or upgrade to the latest pre-release.

If you would like to return to release version, run:
pip uninstall robotframework-appiumlibrary
and install again:
`pip install robotframework-appiumlibrary``

Please help with bugs and feature requests.

• Swipe critical bug fix (thanks to @minhnguyenphuonghoang )

Source distribution is available at PyPI and pip users can simply run
pip install --upgrade robotframework-appiumlibrary to install or upgrade to the latest release.

• Droid Utils: new file/folder handling methods <https://github.com/jollychang/robotframework-appiumlibrary/pull/31>_
• Hide Keyboard for Android

• Open Application support all Appium server, iOS, Android capabilities
• fix switch appication and add testcase

1.1.0

Andoid Keyevents feature
Additional updates to open_application()'s optional parameter handling
add coverage and mock for unittest

1.0.20

• send desired capabilities to saucelabs <https://github.com/jollychang/robotframework-appiumlibrary/issues/20>_
  _ Added desired Capability newCommandTimeout <https://github.com/jollychang/robotframework-appiumlibrary/pull/19>_

1.0.19

• Open Application Keyword udid argument issues <https://github.com/jollychang/robotframework-appiumlibrary/pull/17>_
• Update Wait Until Page Contains Element Keyword documentation <https://github.com/jollychang/robotframework-appiumlibrary/pull/16>_

1.0.18

• added tap functionality to keyword by shadeimi <https://github.com/jollychang/robotframework-appiumlibrary/pull/14>_
• Support for multiple appium connections by yahman72 <https://github.com/jollychang/robotframework-appiumlibrary/pull/13>_

1.0.17

• support app_wait_package and app_wait_activity

1.0.16

• add udid and bundleid
• add background_app
• fix Resetting an application