# What changed in appium-xcuitest-driver

> 36 changes in appium-xcuitest-driver 12 from its official release notes, upgrade guides and advisories: 1 breaking, 1 security, 11 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/appium-xcuitest-driver/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## appium-xcuitest-driver 12

### Breaking changes

- Supported HID and protected resource values were updated, changing which values developers can use. (12.11.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.11.0)

### Security

- Refuses to delete the Simulator root, preventing deletion of the root directory through this command. (12.11.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.11.1)

### New APIs and options

- Adds the asAppUnderTest flag to the mobile: launchApp command. (12.18.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.18.0)
- Adds multi-display discovery for Duo support. (12.17.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.17.0)
- Adds safe screenshot routing for Duo support. (12.17.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.17.0)
- Adds a command to simulate the Duo hinge angle. (12.16.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.16.0)
- WDA can now be launched on Duo. (12.15.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.15.0)
- Adds support for a connect hardware preference for Device Hub. (12.14.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.14.0)
- Adds support for simulatorPasteboardAutomaticSync, allowing developers to configure simulator pasteboard synchronization. (12.14.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.14.0)
- Adds native Safari automation support. (12.9.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.9.0)
- Adds the mobile: performHandGesture command for watchOS. (12.7.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.7.0)
- Adds the mobile: rotateDigitalCrown command for watchOS. (12.7.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.7.0)
- The TS driver now supports watchOS. (12.6.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.6.0)

### Behavior and default changes

- W3C actions resolve web element origins to native coordinates. (12.10.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.10.0)

### Fixes and other changes

- WDA downloads are resolved from the monorepo release. (12.18.2) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.18.2)
- Web element screenshots now capture the whole element. (12.18.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.18.1)
- Tunnel creation now exits on Ctrl+C. (12.17.3) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.17.3)
- Apple TV tunnels are tracked by pair record UDID. (12.17.2) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.17.2)
- Preserves the recording aspect ratio and input frame rate. (12.17.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.17.1)
- Passes value and maxAttempts to WDA when calling mobile: selectPickerWheelValue. (12.16.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.16.1)
- Refreshes display geometry for viewport screenshots. (12.16.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.16.0)
- Preserves app iframe selection after native tap calibration. (12.15.2) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.15.2)
- Explicit orientation correction is now honored for MJPEG screenshots. (12.15.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.15.1)
- Native geometry is now included in the web calibration cache. (12.15.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.15.1)
- Tunnel and legacy device discovery are merged. (12.14.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.14.1)
- WDA was bumped to fix package creation with Xcode 26+. (12.13.3) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.13.3)
- Fixed error handling in grepFile. (12.13.2) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.13.2)
- Passes ActivateSuspended: true to host opts when backgrounding WDA. (12.13.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.13.1)
- UDID capabilities are now matched case-insensitively across remaining device and simulator lookups. (12.12.6) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.12.6)
- Matches an explicit udid capability against connected devices case-insensitively. (12.12.5) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.12.5)
- Forwards the network event method name to the Safari network log listener. (12.12.4) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.12.4)
- Resolves nested .ipa paths when downloading a remote .zip on real devices. (12.12.2) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.12.2)
- When pulling a container root on real devices, the driver no longer zips the host temp directory. (12.12.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.12.1)
- The driver now owns the legacy MJSONWP context/contexts routes. (12.12.0) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.12.0)
- Routes refresh, getUrl, and title through waitForAtom for alert detection. (12.8.2) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.8.2)
- Session creation failures now log the real error, making failures easier to diagnose. (12.8.1) — [release notes](https://github.com/appium/appium-xcuitest-driver/releases/tag/v12.8.1)