iOS devices#
Commands that manage iOS devices: install and launch the app, and use WebDriverAgent for native elements.
Every command also takes the global options, such as --host and --port.
Note
iOS commands require macOS with Xcode installed.
ios devices / ios install / ios launch / ios uninstall#
Parameters
Name |
Required |
Description |
|---|---|---|
|
No |
UDID of the target device. If omitted and only one device is connected, it is auto-detected. |
Returns
List of connected devices (
devices). Confirmation forinstall,launch, anduninstall.
Examples
alttester ios devices # List connected devices
alttester ios install path/to/App.ipa # Install an app
alttester ios launch com.example.game # Launch an app
alttester ios uninstall com.example.game # Uninstall an app
ios wda-setup / ios wda-start / ios wda-stop / ios wda-status / ios wda-find / ios wda-tap / ios wda-source#
WDA is required for interacting with native iOS UI elements such as alerts, permission dialogs, and system popups.
Parameters
Name |
Required |
Description |
|---|---|---|
|
Yes (setup); first |
Your Apple Developer Team ID, used to sign the WDA build. Required for |
|
No |
Locator strategy for |
|
No |
UDID of the target device. Auto-detected when only one device is connected. |
Returns
Confirmation for
wda-setup,wda-start,wda-stop. Status details forwda-status. AltObject forwda-find. Confirmation forwda-tap. Native UI hierarchy XML forwda-source.
Examples
# One-time setup: clone and build WDA
alttester ios wda-setup --team-id YOUR_TEAM_ID
# Start/stop the WDA server
alttester ios wda-start --team-id YOUR_TEAM_ID
alttester ios wda-stop
alttester ios wda-status
# Interact with native elements
alttester ios wda-find Allow
alttester ios wda-tap Allow --by accessibility-id
alttester ios wda-source
ios run#
Installs, launches, and sets up an app for testing in one command.
Parameters
Name |
Required |
Description |
|---|---|---|
path |
Yes |
Path to the |
|
No |
Your Apple Developer Team ID. When provided, WDA is set up so native UI elements (alerts, permission dialogs) can be interacted with. The app still installs and launches without it. |
|
No |
Automatically dismiss system permission alerts using WDA after launch. The default value is: |
|
No |
Connect the AltTester® driver after launch. The default value is: |
|
No |
UDID of the target device. Auto-detected when only one device is connected. |
Returns
Confirmation that the app is installed, launched, and ready for testing.
Examples
alttester ios run path/to/App.ipa --team-id YOUR_TEAM_ID --accept-alerts