You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 8db5091
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/adr/0025-foldable-apple-panels.md
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -372,20 +372,21 @@ Rejected alternatives:
372
372
373
373
`XCUIDevice.orientation` has no effect on an iPhone Duo simulator, and the runner readback repeats the requested value.
374
374
`devicectl device orientation set` reports success and has no effect on a simulator that `simctl boot` started.
375
-
`orientation` therefore rotates a multi-panel simulator through the guest device-state control: the HID event that Device Hub's orientation menu sends (`orientation-picker-control`, type `enum`).
375
+
`orientation` therefore rotates a multi-panel iPhone Duo simulator through the guest device-state control: the HID event that Device Hub's orientation menu sends (`orientation-picker-control`, type `enum`).
376
376
The picker accepts `pud` for upside-down dispatch, which the inner panel needs to show landscape-left.
377
377
The user target `portrait-upside-down` remains refused with `unsupported-foldable-orientation`.
378
378
Routing uses the `fold` admission and the set-based panel-count source. A resolved panel count is a hardware fact, so the daemon probes each simulator once.
379
379
A supplied helper is a reuse handle; only an explicit guest-source request changes the default-set source.
380
380
Thus, classifying a single-panel default-set simulator does not prepare the fold helper.
381
381
382
-
Verification was updated on 2026-11-12 under [#4440](https://github.com/callstack/agent-device/pull/4440).
382
+
The picker mapping requires the discovered model to be iPhone Duo; other multi-panel models are refused.
383
383
In both simulator sets, the helper reads the guest panel table and dispatches the fixed picker value for the established lit panel.
384
384
The table maps the outer panel at zero offset and the inner panel at +90 degrees.
385
385
Only a fresh `currentOrientation` from an established lit panel confirms the requested visible orientation.
386
386
An incomplete table, unknown-power sibling, or multiple lit panels cannot confirm or dispatch.
387
387
A repeated visible target dispatches nothing; delayed reads wait without resending to the same panel.
388
388
A target that never appears is refused with `orientation-unverified` in either set.
389
+
An unreadable guest table reports `orientation-panel-table-unavailable` and points to the inventory diagnostic.
thrownewAppError('COMMAND_FAILED','The guest panel table could not be read',{
225
+
deviceId: device.id,
226
+
reason: 'orientation-panel-table-unavailable',
227
+
hint: 'The fold helper could not provide a usable display table. Check the apple_display_inventory_unresolved diagnostic for the helper or display-table failure, then retry.',
Copy file name to clipboardExpand all lines: packages/platform-apple/src/foldable/pose.ts
+1-2Lines changed: 1 addition & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ const FOLDABLE_REQUIRED_HINT =
26
26
'fold sets the hinge angle of a foldable simulator such as iPhone Duo; this simulator reports one integrated panel, so it has no hinge to pose.';
27
27
28
28
constINVENTORY_REQUIRED_HINT=
29
-
"fold needs the simulator's integrated displays to identify a foldable: the fold helper reads their panel table in either simulator set. The apple_display_inventory_unresolved diagnostic names why the read failed.";
29
+
"fold needs the simulator's integrated displays to identify a foldable: the default set uses CoreDevice and a scoped set uses the fold helper. The apple_display_inventory_unresolved diagnostic names why the read failed.";
30
30
31
31
constDISPATCHED_UNVERIFIED_HINT=
32
32
'The pose request was sent and the device may have followed it, but the first hinge-angle read returned no sample, so fold cannot confirm it. Take a screenshot or snapshot to see which panel is lit; hingeReadFailure names why the read failed.';
@@ -49,7 +49,6 @@ export async function setAppleFoldPose(
Copy file name to clipboardExpand all lines: website/docs/docs/commands.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -125,7 +125,7 @@ Back, orientation, and hardware buttons:
125
125
-`back` uses app-owned back navigation: visible in-app back UI on Apple targets, and the back keyevent on Android. `--in-app` names this default explicitly.
126
126
- On iOS, a single-screen iPhone or an iPad whose app provably fills its screen, `back` can use a top-leading tap when the app tree is unreadable. It compares the screen before and after the tap. If the screen cannot be captured, the command reports an unknown outcome; inspect the screen before you retry.
127
127
-`back --system` sends system back input: the Android back keyevent, the iOS back gesture, or the tvOS Siri Remote Menu button. macOS has no system back, so it reports unavailable.
128
-
-`orientation portrait|portrait-upside-down|landscape-left|landscape-right` works on iOS and Android mobile targets only. On ADB-backed Android it turns auto-rotate off, and the lock persists after the session ends until something turns it back on. A foldable iPhone simulator (iPhone Duo) refuses `portrait-upside-down`. In both default and scoped simulator sets it rotates through the fold helper and succeeds only when the lit panel shows the requested orientation; if it never does, or the simulator never reports a single lit panel, the command fails with `orientation-unverified`.
128
+
-`orientation portrait|portrait-upside-down|landscape-left|landscape-right` works on iOS and Android mobile targets only. On ADB-backed Android it turns auto-rotate off, and the lock persists after the session ends until something turns it back on. In both default and scoped simulator sets, an iPhone Duo classified with more than one integrated panel refuses `portrait-upside-down`and rotates through the fold helper. It succeeds only when the lit panel shows the requested orientation; if it never does, or the simulator never reports a single lit panel, the command fails with `orientation-unverified`. An unreadable guest table reports `orientation-panel-table-unavailable`. Other multi-panel simulator models are refused. A simulator classified with one panel, or whose first classification read is unresolved, uses the standard runner rotation.
129
129
-`orientation auto` hands rotation back to the sensor on ADB-backed Android, local or Limrun (`accelerometer_rotation=1`, `user_rotation` untouched), and reports `orientation: "auto"`. It does not wait for the display to rotate, because there is no target rotation: the sensor decides, and an emulator usually settles on portrait. Every other backend refuses `auto` with `UNSUPPORTED_OPERATION`.
130
130
-`action-button` presses the iPhone or iPad Action Button once. It takes no arguments, no hold duration, and no `--settle`, and it doesn't activate the session app or drive Camera Control. Other platforms refuse it, and a model without the button (an iPhone SE, most iPad simulators) fails with `UNSUPPORTED_OPERATION`.
131
131
-`action-button` reports that the press was dispatched, not what it triggered. Simulators run no Shortcuts or App Intents, so verify the outcome on a physical iPhone. Expect a press to take about five seconds on a Simulator.
0 commit comments