How to Migrate from Appium 2.0 to Appium 3?

If you are looking for guidance on migrating from Appium 2 to Appium 3 for guidance on migrating from Appium 2 to Appium 3. This video provides a detailed breakdown of the process, covering critical prerequisites and breaking changes.

The content specifically addresses:

  • Mandatory Node Version Upgrade: Appium 3 drops support for outdated Node versions and now requires a minimum of Node 20.19.0 and an npm version of 10.

  • Driver Management: Appium 3 installation methods remain similar to Appium 2 (installing on top of the existing installation)

  • , but you must reset your drivers using the Appium setup reset command to uninstall all drivers associated with Appium 2.

  • Compatibility Enforcement: Appium 3 will actively prevent the installation of incompatible drivers, clearly stating the required server version if an older driver is attempted (like XCUITest 9.0.2).

  • New Feature Flag Prefixing: When running Appium server with “insecure” flags (like allow insecure with ADB shell), Appium 3 now requires you to prefix the flag to specify which driver it applies to (e.g., UI automator. A wildcard (*) can be used if the command should apply to all drivers.

Watch the full video for a comprehensive walkthrough of upgrading Node, installing Appium 3 (version 3.0.2 is shown), resetting drivers, and correctly implementing the new feature flag prefixes: