v8-to-v9-migration-guide.md

This is the list of main changes between major versions 8 and 9 of Appium java client. This list should help you to successfully migrate your existing automated tests codebase.

The support for Java compilers below version 11 has been dropped

• The minimum supported Java version is now 11. The library won't work with Java compilers below this version.

The minimum supported Selenium version is set to 4.14.1

• Selenium versions below 4.14.1 won't work with Appium java client 9+. Check the Compatibility Matrix for more details about versions compatibility.

Removed previously deprecated items

• MobileBy class has been removed. Use AppiumBy instead
• launchApp, resetApp and closeApp methods along with their SupportsLegacyAppManagement container. Use the corresponding extension methods instead.
• WindowsBy class and related location strategies.
• ByAll class has been removed in favour of the same class from Selenium lib.
• AndroidMobileCapabilityType interface. Use UIAutomator2 driver options or Espresso driver options instead.
• IOSMobileCapabilityType interface. Use XCUITest driver options instead.
• MobileCapabilityType interface. Use driver options instead.
• MobileOptions class. Use driver options instead.
• YouiEngineCapabilityType interface. Use driver options instead.
• Several misspelled methods. Use properly spelled alternatives instead.
• startActivity method from AndroidDriver. Use mobile: startActivity extension method instead.
• APPIUM constant from the AutomationName interface. It is not needed anymore.
• PRE_LAUNCH value from the GeneralServerFlag enum. It is not needed anymore.

Moved items

• AppiumUserAgentFilter class to io.appium.java_client.internal.filters package.