Skip to content

docs: make Xcode/iOS compatibility tables clearer #2737

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
eglitise merged 3 commits into from
Feb 21, 2026
Merged

docs: make Xcode/iOS compatibility tables clearer #2737

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
82f30e3
docs: make Xcode/iOS compatibility tables clearer
eglitise Feb 20, 2026
04c48d1
update docs with policy for fixes/workarounds
eglitise Feb 21, 2026
56da982
update older version labels
eglitise Feb 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/guides/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ XCUITest driver offers a couple of approaches to handle them:
- It might be necessary to coordinate element selection via `acceptAlertButtonSelector`/`dismissAlertButtonSelector` settings in [Settings](../reference/settings.md)
- Activate `com.apple.springboard` with [`mobile: activateApp`](../reference/execute-methods.md#mobile-activateapp) before interacting with dialogs

[`mobile: activeAppInfo`](../reference/execute-methods.md#mobile-activateappinfo) helps to understand what application (bundleId) is considered as active for the XCUITest driver.
[`mobile: activeAppInfo`](../reference/execute-methods.md#mobile-activeappinfo) helps to understand what application (bundleId) is considered as active for the XCUITest driver.

## Interact with dialogs managed by `com.apple.ContactsUI.LimitedAccessPromptView`

Expand Down
66 changes: 34 additions & 32 deletions docs/installation/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,42 +97,44 @@ should help you decide which driver version to install. If you are upgrading/dow
existing installation, check that the [WebDriverAgent (WDA)](https://github.com/appium/WebDriverAgent)
version on the device under test is also updated accordingly.

For iOS/tvOS support in driver versions older than `4.0.0` (Appium 1), please refer to
[the Appium 1 changelog](https://github.com/appium/appium/blob/1.x/CHANGELOG.md).

!!! info "Background"
??? info "Why not support all iOS versions?"

The XCUITest driver depends on the [WebDriverAgent (WDA)](https://github.com/appium/WebDriverAgent)
framework, which in turn [relies on Apple's XCTest framework](../overview.md). Changes in the
XCTest API are published in new Xcode and Apple device OS versions. These API changes may
add new features that the driver must implement in order to support the latest devices, as well
as modify or even remove support for existing features that the driver relies on. In both cases,
new driver and WDA versions are required.
XCTest API are published in new Xcode and Apple device OS versions. These API changes may not
only add new features that the driver must implement in order to support the latest devices, but
also modify or even remove support for existing features that the driver relies on.

Generally, the driver/WDA aims to support the latest _two_ (2) major Xcode/iOS/iPadOS/tvOS versions,
but may also work with older versions, unless specified below.

The following are the minimum driver/WDA versions required for specific Xcode/iOS versions:

| Xcode/iOS version | Minimum XCUITest driver & WDA version |
| --- | --- |
| Xcode 26 / iOS 26 | `9.5.0` (WDA `9.14.1`) |
| Xcode 16-beta.5 / iOS 18 | `7.24.15` (WDA `8.9.1`) |
| Xcode 15 / iOS 17 | `4.32.23` (WDA `5.6.0`) |
| Xcode 14.3 / iOS 16.4 | `4.21.7` (WDA `4.13.1`) |
| Xcode 14-beta.3 / iOS 16 Beta | `4.7.4` (WDA `4.8.1`) |

The following are the last driver versions that are compatible with older Xcode versions:
but may also work with older versions whose support has not been explicitly removed.
Copy link
Member

@KazuCocoa KazuCocoa Feb 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably, we should address that we may not implement workarounds only for older iOS versions. Also, if we need to make an implementation decision, we'll prioritize supported versions (two majors).

Small modifications are fine, but sometimes workarounds for older ones may require broader changes, which we may not make.

Copy link
Contributor Author

@eglitise eglitise Feb 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added


| Xcode version | Last supported XCUITest driver version |
| --- | --- |
| Xcode 13 | `10.6.0` (WDA `10.2.2`) |
| Xcode 12 | `4.27.2` (WDA `4.15.1`) |
| Xcode 11 | `4.2.0` (WDA `4.0.0`) |

The following are the last driver versions that are compatible with older iOS versions:
!!! note

| iOS version | Last supported XCUITest driver version |
| --- | --- |
| iOS 9 - iOS 14 | `4.27.2` (WDA `4.15.1`) |
| iOS 8 | `4.2.0` (WDA `4.0.0`) |
For iOS/tvOS/Xcode support in driver/WDA versions older than `4.0.0` (Appium 1), please refer to
[the Appium 1 changelog](https://github.com/appium/appium/blob/1.x/CHANGELOG.md).

The following table maps Xcode versions to their supported driver/WDA versions:

| Xcode version | First supported driver version | Last supported driver version |
| --- | --- | -- |
| Xcode 26 | `9.5.0` (WDA `9.14.1`) | Latest |
| Xcode 16 | `7.24.15` (WDA `8.9.1`) | Latest |
| Xcode 15 | `4.32.23` (WDA `5.6.0`) | Latest (not tested) |
| Xcode 14.3 | `4.21.7` (WDA `4.13.1`) | Latest (not tested) |
| Xcode 14.0 - 14.2 | `4.7.4` (WDA `4.8.1`) | Latest (not tested) |
| Xcode 13 | Pre-`4.0.0` | `10.6.0` (WDA `10.2.2`) |
| Xcode 12 | Pre-`4.0.0` | `4.27.2` (WDA `4.15.1`) |
| Xcode 11 | Pre-`4.0.0` | `4.2.0` (WDA `4.0.0`) |

The following table maps iOS versions to their supported driver/WDA versions:

| iOS version | First supported driver version | Last supported driver version |
| --- | --- | -- |
| iOS 26.4 | `10.23.2` (WDA `11.1.5`) | Latest |
| iOS 26.0 - 26.3 | `9.5.0` (WDA `9.14.1`) | Latest |
| iOS 18 | `7.24.15` (WDA `8.9.1`) | Latest |
| iOS 17 | `4.32.23` (WDA `5.6.0`) | Latest (not tested) |
| iOS 16.4 | `4.21.7` (WDA `4.13.1`) | Latest (not tested) |
| iOS 16.0 - 16.3 | `4.7.4` (WDA `4.8.1`) | Latest (not tested) |
| iOS 15 | Pre-`4.0.0` | Latest (not tested) |
| iOS 9.3 - 14 | Pre-`4.0.0` | `4.27.2` (WDA `4.15.1`) |
10 changes: 5 additions & 5 deletions docs/reference/execute-methods.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -489,12 +489,12 @@ The returned object always includes at least the following entries:

- `level`: Battery level in range [0.0, 1.0], where 1.0 means 100% charge.
- `state`: Battery state as an integer number. The following values are possible:
* UIDeviceBatteryStateUnknown = 0
* UIDeviceBatteryStateUnplugged = 1 // on battery, discharging
* UIDeviceBatteryStateCharging = 2 // plugged in, less than 100%
* UIDeviceBatteryStateFull = 3 // plugged in, at 100%
* UIDeviceBatteryStateUnknown = 0
* UIDeviceBatteryStateUnplugged = 1 // on battery, discharging
* UIDeviceBatteryStateCharging = 2 // plugged in, less than 100%
* UIDeviceBatteryStateFull = 3 // plugged in, at 100%

On iOS 18 and newer real devices, the returned object may also include many additional advanced battery information fields, such as capacity, health metrics, temperature, and more. For a full list of possible advanced fields, see the [BatteryInfo](../../lib/commands/advanced-battery-types.ts).
On iOS 18 and newer real devices, the returned object may also include many additional advanced battery information fields, such as capacity, health metrics, temperature, and more. For a full list of possible advanced fields, see [`BatteryInfo`](https://github.com/appium/appium-xcuitest-driver/blob/master/lib/commands/advanced-battery-types.ts).

The returned object is a superset of the basic battery info, and may look like:

Expand Down