Skip to content

Device Preparation

Automatic device preference update

Appium XCUITest prepares preferences of the device under test automatically. Some of them are also configurable via Appium capabilities and the Settings API.

Keyboards configuration

Appium configures keyboard preferences by default to make test runs more stable. You can change some of them via the Settings API.

  • Turn Auto-Correction in Keyboards off
  • Turn Predictive in Keyboards off
  • Mark keyboard tutorial as complete
  • (Only for Simulator) Toggle software keyboard on

Manual setup for fine tuning

Automatic configuration availability is limited on iOS, especially for a real device. You may need to manually change the device configuration.

Enable Web testing availability

Please turn on Web Inspector on iOS device via Settings -> Safari -> Advanced

If iOS/iPadOS version is 16.4 or above

Make sure the destination WKWebView and/or JSContext component have isInspectable property set to true. Read Enabling the Inspection of Web Content in Apps for more details on this property.

Chrome v115+ and iOS 16.4+ support Web testing availability

Chrome browser for iOS now provides a remote debugging feature for release versions of the app after the isInspectable property has been introduced by Apple.

Please turn on Web Inspector on iOS device via Chrome app -> Settings -> Content Settings -> Web Inspector -> Turn Web Inspector on, then kill the Chrome app process

Please read Debugging websites in Chrome on iOS 16.4+ for more details.

Avoid possible wrong coordinate

Please make sure the zoom preference in accessibility is turned off via Settings -> Accessibility -> Zoom. It could cause element coordinates miscalculation.

Expose more elements if needed

In some cases, enabling of the below preferences helps to make some view elements accessible. Appium does not modify these settings automatically, since they could affect the way your application under test performs. Please change them manually if needed.

  • Turn Spoken Content in Settings -> Accessibility on
  • Turn Speak Selection in Settings -> Accessibility on

Note that the available accessibility content depends on the OS version.