Appium Versions
The Appium core team does not maintain Appium 1.x anymore since the 1st of January 2022. This means that:
- bugfixes will not be released for Appium 1.x anymore and require you to migrate to Appium 2
- Appium 1 and its packaged drivers are no longer 100% compatible with Android 13/iOS 16 and higher and require Appium 2 to run stably.
Sauce Labs still supports Appium 1.x in limited versions, but we recommend migrating to Appium 2 to keep your tests up-to-date and compatible with the latest platform versions.
Selecting Appium Versions
You can select a specific Appium version by using the appiumVersion
capability as part of the "sauce:options"
. The below examples show how to select the Appium version for your test and use Android with Chrome as an example. See our Platform Configurator to help you construct your capabilities for the specific platform and Real Device/Android Emulator/iOS Simulator you want to test on.
The active Appium versions can be found in the Real Devices, Android Emulators, and iOS Simulators sections.
- Java
- Node.js
- Python
- Ruby
- C#
MutableCapabilities capabilities = new MutableCapabilities();
capabilities.setCapability("browserName", "chrome");
capabilities.setCapability("platformName", "android");
capabilities.setCapability("appium:platformVersion", "14");
capabilities.setCapability("appium:deviceName", "Google Pixel 7 Pro");
capabilities.setCapability("appium:automationName", "uiautomator2");
HashMap<String, Object> sauceOptions = new HashMap<String, Object>();
// Check below for the available versions
sauceOptions.put("appiumVersion", "latest");
capabilities.setCapability("sauce:options", sauceOptions);
const capabilities = {
browserName: 'chrome',
platformName: 'android',
'appium:platformVersion': '14',
'appium:deviceName': 'Google Pixel 7 Pro',
'appium:automationName': 'uiautomator2',
'sauce:options': {
// Check below for the available version
appiumVersion: 'latest'
}
}
capabilities = {
"browserName" : "chrome",
"platformName" : "android",
"appium:platformVersion" : "14",
"appium:deviceName" : "Google Pixel 7 Pro",
"appium:automationName": "uiautomator2",
"sauce:options" : {
# Check below for the available version
"appiumVersion" : "latest"
}
}
capabilities = {
"browserName" => "chrome",
"platformName" => "android",
"appium:platformVersion" => "14",
"appium:deviceName" => "Google Pixel 7 Pro",
"appium:automationName" => "uiautomator2",
"sauce:options" => {
# Check below for the available version
"appiumVersion" => "latest"
}
}
AppiumOptions capabilities = new AppiumOptions();
capabilities.AddAdditionalCapability("browserName", "chrome");
capabilities.AddAdditionalCapability("platformName", "android");
capabilities.AddAdditionalCapability("appium:platformVersion", "14");
capabilities.AddAdditionalCapability("appium:deviceName", "Google Pixel 7 Pro");
capabilities.AddAdditionalCapability("appium:automationName", "uiautomator2");
HashMap<String, Object> sauceOptions = new Dictionary<string, object>();
// Check below for the available version
sauceOptions.Add("appiumVersion", "latest");
capabilities.AddAdditionalCapability("sauce:options", sauceOptions);
Release Strategy
Our Appium 2 release strategy is as follows:
On the 2nd of each month, we release a 'bundled' version of Appium 2 that includes all the latest drivers available up to the 1st of that month. This 'bundled' version allows you to maintain a stable testing environment, saving you the effort required to individually update drivers. The version is named with a timestamp in the
appiumVersion
capability, such asappium2-YYYYMMDD
, for easy tracking. These versions have an 11-month lifespan post-release, giving you plenty of time to plan your upgrade strategy.Additionally, we offer a
latest
version, updated bi-weekly on the 2nd and 16th of each month. This version includes all the most recent Appium 2 drivers and server released up to the 1st and 15th of each month. This rapid update cycle enables you to quickly access new features and fixes, so you can continually enhance your testing workflows. The bi-weeklylatest
version does not have a fixed lifespan, allowing you to stay on the cutting edge.
This strategy is designed to ease the complexities you face in mobile app testing.
The current release strategy outlined above is specific to Real Devices. We are actively working to extend this to Emulators and Simulators and will announce it shortly.
End-of-Life
To improve your testing experience, we're ending support for select versions of Appium 1 and certain bundles of Appium 2. A single stable Appium 1 release will ensure better compatibility and stability, especially on older Android and iOS devices. For Appium 2, we recommend using the most recent drivers to benefit from new features and bug fixes.
You can find which versions are currently supported in the Real Devices, Android Emulators and iOS Simulators sections, including their end-of-life dates.
The current end-of-life strategy outlined above is specific to Real Devices. We are actively working to extend this to Emulators and Simulators and will announce it shortly.
Real Devices
Appium 2.x
Appium Version | EOL Date | Notes |
---|---|---|
latest | Active | This will hold a collection of drivers that are compatible with the latest Appium server and driver versions that are installed in our cloud. We try to keep versions up to date every two weeks. You can find the exact versions in the first 20 log lines of the Appium logs of your executed test by going to Test Details page > Logs > Appium Logs |
2.0.0 | January 31st, 2024 | This was the "old" alias for getting the latest Appium 2 drivers that were installed in the Sauce Labs Real Device Cloud. This alias is deprecated due to being unclear and is replaced by latest . The alias 2.0.0 is a collection of the following drivers |
appium2-20231101 | October 31st, 2024 | This is a collection of drivers that were released in November 1st 2023 |
appium2-20231001 | September 30th, 2024 | This is a collection of drivers that were released in October 1st 2023 |
appium2-20230901 | August 31st, 2024 | This is a collection of drivers that were released in September 1st 2023 |
Appium 1.x
Appium Version | EOL Date | Notes |
---|---|---|
1.22.2 | Active | |
1.22.1 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.22.0 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.21.0 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.20.1 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.19.0 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.18.1 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.17.1 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.17.0 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.16.0 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.15.1 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.15.0 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
1.14.0 | December 31st, 2023 | Update to 1.22.2 or migrate to Appium 2 |
Virtual Devices
Android Emulators
OS Version | Supported Appium Versions | Default Appium Version | Recommended Appium Version |
---|---|---|---|
Android 14.0 | 2.0.0 | 2.0.0 | |
Android 13.0 | 2.0.0 | 2.0.0 | |
Android 12.0 | 1.22.1 | 2.0.0 | |
Android 11.0 | 1.22.1 | 2.0.0 | |
Android 10.0 | 1.22.1 | 2.0.0 | |
Android 9.0 | 1.22.1 | 2.0.0 | |
Android 8.1 | 1.22.1 | 2.0.0 | |
Android 8.0 | 1.22.1 | 2.0.0 | |
Android 7.1 | 1.22.1 | 2.0.0 | |
Android 7.0 | 1.22.1 | 2.0.0 | |
Android 6.0 | 1.22.1 | 2.0.0 | |
Android 5.1 | 1.22.1 | 1.22.1 |
iOS Simulators
Platform Version | Supported Appium Versions | Default Appium Version | Recommended Appium Version |
---|---|---|---|
iOS 16.2 | 2.0.0 | 2.0.0 | |
iOS 16.1 | 2.0.0 | 2.0.0 | |
iOS 16.0 | 2.0.0 | 2.0.0 | |
iOS 15.5 | 1.22.3 | 2.0.0 | |
iOS 15.4 | 1.22.3 | 2.0.0 | |
iOS 15.2 | 1.22.3 | 2.0.0 | |
iOS 15.0 | 1.22.3 | 2.0.0 | |
iOS 14.5 | 1.22.3 | 2.0.0 | |
iOS 14.4 | 1.22.3 | 2.0.0 | |
iOS 14.3 | 1.22.3 | 2.0.0 | |
iOS 14.0 | 1.22.3 | 2.0.0 | |
iOS 13.4 | 1.22.3 | 2.0.0 | |
iOS 13.2 | 1.22.3 | 2.0.0 | |
iOS 13.0 | 1.22.3 | 2.0.0 | |
iOS 12.4 | 1.22.3 | 2.0.0 | |
iOS 12.2 | 1.22.3 | 2.0.0 | |
iOS 12.0 | 1.9.1 | 1.9.1 | |
iOS 11.3 | 1.8.0 | 1.9.1 | |
iOS 11.2 | 1.8.0 | 1.9.1 | |
iOS 11.1 | 1.8.0 | 1.9.1 | |
iOS 11.0 | 1.8.0 | 1.9.1 | |
iOS 10.3 | 1.8.0 | 1.9.1 |
Appium 2 Versions
The Appium 2 versions for Virtual Devices are also collections of drivers that are installed in our cloud. The below table shows the Appium 2 versions with their drivers that are available for Virtual Devices.
Appium Version | EOL Date | Notes |
---|---|---|
2.0.0 | - | The is a collection of the following drivers |
2.0.0-beta66 | - | This is a collection of drivers that were released in April 20th 2023 |
2.0.0-beta56 | - | This is a collection of drivers that were released in February 24th 2023 |
2.0.0-beta44 | - | This is a collection of drivers that were released in September 7th 2022 |