Skip to content

Commit c6f525a

Browse files
thymikeeclaude
andcommitted
docs(close): state the Android ADB close fence timeout
Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent bd8df84 commit c6f525a

2 files changed

Lines changed: 2 additions & 1 deletion

File tree

‎src/commands/management/app.ts‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ const openCommandMetadata = defineFieldCommandMetadata(
8282

8383
const closeCommandMetadata = defineFieldCommandMetadata(
8484
'close',
85-
'Close the named app, or close the active session app when app is omitted. Use shutdown only when the selected simulator or emulator should also stop.',
85+
'Close the named app, or close the active session app when app is omitted. Use shutdown only when the selected simulator or emulator should also stop. Android ADB close fails with android-app-close-timeout if the app stays foreground, or its process stays running, past its 2s check window.',
8686
{
8787
app: stringField('Optional app to close.'),
8888
shutdown: booleanField('Shutdown the session/device where supported.'),

‎website/docs/docs/commands.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,7 @@ Open apps and links:
9090
- `open <app> --launch-console <path>` captures launch-time stdout/stderr for iOS simulator app launches. It is not valid for URL opens or other targets.
9191
- `open --platform macos --surface app|frontmost-app|desktop|menubar` selects the macOS session surface; `app` is the default when you name an app. See [Desktop targets](#desktop-targets). `--save-script` records the surface so `replay` reopens it; with no surface given, replay opens an app session.
9292
- Android React Native: `open --relaunch` needs an installed package name. Install or reinstall the APK first; `open <apk|aab> --relaunch` is rejected. For Metro-backed JS changes, run `metro reload` before reaching for `open <app> --relaunch`.
93+
- Android (ADB): `close` force-stops the app, then checks for 2 seconds that it has left the foreground and for 2 more that its process has exited. If either check window ends first, `close` fails with `details.reason: android-app-close-timeout` and `details.phase` set to `foreground` or `process`; apps Android restarts at once, such as the launcher, fail this way.
9394

9495
iOS Simulator launch behavior:
9596

0 commit comments

Comments
 (0)