Repository navigation
v0.1.0
uses: github.com/mozership/probe-ios@9e8d99c90abb717826816dffa892649c36e425b9 # v0.1.0Highlights
- The first release of the ios action. It drives an app on an iOS simulator through XCUITest: it launches the app, taps and types into it, waits for elements, reads their text and accessibility tree, and takes screenshots.
- It builds its XCUITest runner from source with the Mac's own Xcode, the first time a step needs it, and caches it by the runner's source, the Xcode version, the SDK and the architecture. No Swift, signing or Apple developer account is needed.
- A run starts one runner per simulator and keeps it for the run's later steps; Probe stops it once the run is over, through
cleanup.
A step
actions:
ios: github.com/mozership/probe-ios@9e8d99c90abb717826816dffa892649c36e425b9 # v0.1.0
jobs:
- name: Settings
steps:
- name: Open General
uses: ios
timeout: 15m
with:
app: com.apple.Preferences
actions:
- name: launch
args: ["-AppleLanguages", "(en)", "-AppleLocale", "en_US"]
- name: tap
selector: com.apple.settings.general
- name: wait
selector: type=navigationbar identifier=General
- name: text
id: back
selector: type=button identifier=BackButton
test: res.code == 0 && res.results.back == "Settings"The first step says it is building the runner, which took 20 to 30 seconds with Xcode 27 on an Apple silicon Mac and some minutes on a GitHub-hosted runner:
[WARN] ios: building the iOS test runner; the first run takes a few minutes, so give the step timeout: 10m if it runs out
[WARN] cache: /Users/you/Library/Caches/probe-ios/runner/876c38d90ff1a574
[WARN] xcode: Xcode 27.0 / Build version 27A266a
An element that is not there fails the step with the reason:
actions[0] tap: no element matches label=No Such Row within 4.5s
Requirements
- macOS with Xcode, which
xcode-select -ppoints at, an iOS simulator runtime, and a booted simulator with the app installed. The action boots nothing and installs nothing. - Probe v1.27.0 or later, which calls
cleanup. The e2e runs it through Probe v1.30.0 onmacos-26with iOS 26.5, and was run on iOS 26.4 with Xcode 27. - A simulator runs one runner at a time, so two runs of Probe at once need a simulator each.
See the README.
Changelog
- 8e83086 Drive an iOS simulator from a Probe workflow, as an action of its own