Skip to content

app_terminate

Terminates a running application on a simulator device by its bundle identifier. This performs a force-stop of the app process, equivalent to swiping the app away in the iOS app switcher.

Parameters

Parameter	Type	Required	Default	Description
`deviceId`	string	Yes	—	The UDID of the target simulator device.
`bundleId`	string	Yes	—	The bundle identifier of the app to terminate.

Usage Examples

Terminate a running app

“Stop the WeatherApp on the simulator.”

{
  "deviceId": "F3A1B2C3-D4E5-6789-ABCD-EF0123456789",
  "bundleId": "com.example.weatherapp"
}

Terminate before reinstalling

“Kill the running shopping app so I can install a new build.”

{
  "deviceId": "A1B2C3D4-E5F6-7890-ABCD-1234567890EF",
  "bundleId": "com.example.shopapp"
}

Example Output

App terminated successfully.
Device: F3A1B2C3-D4E5-6789-ABCD-EF0123456789
Bundle ID: com.example.weatherapp

app_launch — Relaunch the app after terminating it.
app_uninstall — Uninstall the app completely after terminating.
app_list — List installed apps to verify the correct bundle ID.
log_collect — Collect logs before terminating to capture recent output.

Tips