Skip to content

Commit 41157ea

Browse files
committed
docs: scope the SpringBoard claim to verified iOS simulator support
#1296 explicitly leaves physical-iPhone SpringBoard unverified; the only evidence so far is an iPhone simulator run, whose private-AX fallback is simulator-only. Applied to both the CLI help topic and website/docs/docs/commands.md, with a link to the tracking issue. Dropped the SkillGym case from this PR per thymikee: most of that harness is being removed in #1411, so it's not worth iterating on here.
1 parent cfd8dc1 commit 41157ea

3 files changed

Lines changed: 6 additions & 2 deletions

File tree

‎src/cli/parser/__tests__/cli-help-topics.test.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -513,6 +513,10 @@ test('usageForCommand resolves ios-system-ui help topic', async () => {
513513
assert.match(help, /agent-device open com\.apple\.springboard --platform ios/);
514514
assert.match(help, /longpress <x> <y> on an empty area of the home screen/);
515515
assert.match(help, /discover them from the current snapshot/);
516+
assert.match(
517+
help,
518+
/verified on iOS simulator; physical-iPhone SpringBoard support is not yet verified/,
519+
);
516520
assert.match(help, /Do not hard-code Edit\/Done\/Add Widget or other SpringBoard label text/);
517521
assert.match(help, /Reopen the app bundle under test/);
518522
});

‎src/cli/parser/cli-help.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -857,7 +857,7 @@ For iOS SpringBoard, widget, or other system-UI surfaces, read agent-device help
857857
858858
Use this when a task needs iOS SpringBoard (home screen), widget add/edit/remove, or other system-UI surfaces instead of the app under test.
859859
860-
This works today by opening SpringBoard as the session app; there is no separate widget/system command. System labels vary by iOS version and locale, so discover them from the current snapshot instead of relying on the literal strings shown below.
860+
This works today by opening SpringBoard as the session app; there is no separate widget/system command. System labels vary by iOS version and locale, so discover them from the current snapshot instead of relying on the literal strings shown below. This workflow is verified on iOS simulator; physical-iPhone SpringBoard support is not yet verified.
861861
862862
Core loop:
863863
1. Reach the app state you want to prepare (for example, arrange the widget/Live Activity data the app should show) with normal app automation, then agent-device open com.apple.springboard --platform ios. From an existing app session, agent-device home first also lands on the home screen, but open com.apple.springboard is what actually binds the session to SpringBoard for selector-driven commands.

‎website/docs/docs/commands.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1043,7 +1043,7 @@ For CLI-discoverable setup guidance, run `agent-device help physical-device`.
10431043
10441044
For CLI-discoverable workflow guidance, run `agent-device help ios-system-ui`.
10451045
1046-
- `agent-device open com.apple.springboard --platform ios` binds the session to SpringBoard on a simulator or physical device today; there is no separate widget/system command.
1046+
- `agent-device open com.apple.springboard --platform ios` binds the session to SpringBoard today; this is verified on iOS simulator only. Physical-iPhone SpringBoard support is not yet verified — see [#1296](https://github.com/callstack/agent-device/issues/1296).
10471047
- The full widget add/edit/remove flow is selector-driven from a fresh `snapshot -i`, except two coordinate-based steps: the empty-space long-press that enters edit mode, and (until fixed) the widget-gallery search-result rows, which currently return unlabeled accessibility nodes.
10481048
- SpringBoard labels vary by iOS version and locale; discover them from the current snapshot rather than hard-coding strings like `Edit` or `Add Widget`.
10491049
- Reopen the app bundle under test to return to normal app automation after a SpringBoard step.

0 commit comments

Comments
 (0)