Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 06:23
· 14 commits to main since this release
8e83086
uses: github.com/mozership/probe-ios@9e8d99c90abb717826816dffa892649c36e425b9 # v0.1.0

Highlights

  • 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 -p points 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 on macos-26 with 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