Skip to content

app_uninstall

Removes an installed application from a simulator device using its bundle identifier. This completely deletes the app binary and all associated data containers (documents, caches, preferences) from the simulator.

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 uninstall (e.g., `com.example.myapp`).

Usage Examples

Uninstall an app by bundle ID

“Remove the WeatherApp from my simulator.”

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

Clean up a test app after QA

“Uninstall the staging build of our shopping app from the test device.”

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

Example Output

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

app_install — Install an app onto the simulator.
app_terminate — Terminate the app before uninstalling if it is running.
app_list — List installed apps to find the correct bundle ID.
simulator_erase — Erase the entire simulator to remove all apps and data at once.

Tips