Upgrade to an Appium 2-compliant client

With the move to an Appium 2-compliant client, you will need to upgrade all automation tests because of changes to the Appium API. Therefore, before upgrading to an Appium 2-compliant client, make sure you read the Appium documentation about migrating to Appium 2.x from Appium 1.x, which lists breaking changes and migration steps to ensure compatibility with Appium 2.

Appium 2 requires Java client 8.1.x or later.

Take note of the following:

  • Appium Java client 8 uses a direct connection to the Appium server and therefore cannot work with the following capability: ("automationName", "PerfectoMobile");

  • In addition, with Java client 8 or later, you must add the prefix perfecto: to any non-Appium desired capability.

Restriction: The deviceSessionId capability is currently not supported for Appium 2. You need this capability if you want to share a session with an IDE script.

To learn about Appium 2, including how to use an Appium 2-compliant client with Perfecto, see also our free Appium 2.0: Fundamentals course on the Perfecto Education site. To register for this course, you must be logged in.

To configure the Java client for Appium 2:

  • Specify the new Appium 2 capability automationVersion.

    This capability determines which version of the specified driver to use. If this capability is set, it overrides the appiumVersion capability.

    For details, see Appium 2 capabilities.