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

--device

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 for install, launch, and uninstall.

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

--team-id

Yes (setup); first wda-start only

Your Apple Developer Team ID, used to sign the WDA build. Required for wda-setup and the first wda-start; reused automatically afterwards.

--by

No

Locator strategy for wda-find and wda-tap. One of name (default), accessibility-id, class, or predicate.

--device

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 for wda-status. AltObject for wda-find. Confirmation for wda-tap. Native UI hierarchy XML for wda-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 .ipa file to install.

--team-id

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.

--accept-alerts

No

Automatically dismiss system permission alerts using WDA after launch. The default value is: true

--connect

No

Connect the AltTester® driver after launch. The default value is: false. Currently a no-op placeholder; run alttester connect separately after the app starts.

--device

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