How do I remove app from iOS 8 Simulator from command line?

Question

I have an automation running in the iOS Simulator that I have to remove before another run. How do I remove the app from the iOS Simulator from the command line?

For each simulator device directory (located at ~/Library/Developer/CoreSimulator/Devices/*), I tried to delete ./data/Containers/Bundle/Application/ and ./data/Containers/Data/Application/.

Even when I tried to delete the app by long pressing the app in the Simulator (the app becomes jiggly) and click on the X button, the user defaults were not being cleared. I want the app state to be 100% clean.

I found a good solution to solve this problem.

score 58 · Answer 1 · edited Mar 27 '15 at 09:35

58

With Xcode 6.1, to uninstall an app, use the following command:

xcrun simctl uninstall booted com.example.apple-samplecode.UICatalog

where com.example.apple-samplecode.UICatalog is the bundle identifier of the application you wish to uninstall.

edited Mar 27 '15 at 09:35

Michael Foukarakis

39,737
6
87
123

answered Dec 03 '14 at 06:57

Archana

639
1
4
10

This is a much cleaner implementation, especially with the inclusion of 'booted' – Glen T Feb 07 '15 at 19:37
Is there a way to fail silently if there is no booted simulator? – tfe Jun 05 '15 at 21:59
2

I guess I could simply do `xcrun simctl uninstall booted com.example.apple-samplecode.UICatalog || true`. – tfe Jun 05 '15 at 22:02
3

When running on several simulator devices simultaneously, the one on which the app in uninstalled is undefined. In that case, use the UDID of the device instead of `booted` (get the available UDIDs with `xcrun simctl list`) – atineoSE Jan 10 '17 at 14:11
1

exactly what we needed! I searched for method to wipe all contents while developing UITests every time it starts. – Pan Mluvčí Sep 17 '20 at 09:09
In completion to the @atineoSE suggestion if you want only the list of running simulators use the command: `xcrun simctl list | grep "Booted"`. Then you can remove the app from a specific simulator with: `xcrun simctl uninstall [UDID] [BUNDLE_ID]`. – Ricardo Barroso Jul 29 '21 at 14:39

score 23 · Accepted Answer · edited Jun 05 '18 at 21:55

One approach that we found for deleting user defaults is to delete all files in the ./data/Library/Preferences/* in addition to deleting application and data directories.

However, in Xcode 6, the command xcrun has new subcommand called simctl that allows me to manage iOS Simulator including resetting the simulator, and installing the application.

The solution that I came up with is to use the command

xcrun simctl erase [device ID]

Example

If xcrun simctl list(†) returns

9DDA0CFE-7CEC-40B6-A343-1EC01F282B22 (active, disconnected)
    Watch: Apple Watch Series 2 - 42mm (88474523-163E-4021-B591-2AECBFA26997) (Shutdown)
    Phone: iPhone 7 Plus (5785E680-15CD-42D3-82AB-597286A270C5) (Shutdown)

then run these 2 commands

xcrun simctl erase 88474523-163E-4021-B591-2AECBFA26997
xcrun simctl erase 5785E680-15CD-42D3-82AB-597286A270C5

(†) The device ID can be obtained from running

xcrun simctl list

This will reset the simulator (equivalent to iOS Simulator > Reset Contents and Settings... menu item).

With Xcode 6.0.1 (Build 6A317), there is either a bug or a change in behavior where when you uninstall an application, user defaults are not removed.

Usage: simctl [--noxpc] [--set <set path>] <subcommand> ... | help [subcommand]
Command line utility to control the iOS Simulator

For subcommands that require a <device> argument, you may specify a device UDID
or the special "booted" string which will cause simctl to pick a booted device.
If multiple devices are booted when the "booted" device is selected, simctl
will choose one of them.

Subcommands:
    create        Create a new device.
    delete        Delete a device.
    erase         Erase a device's contents and settings.
    boot          Boot a device.
    shutdown      Shutdown a device.
    rename        Rename a device.
    getenv        Print an environment variable from a running device.
    openurl       Open a URL in a device.
    addphoto      Add a photo to the photo library of a device.
    install       Install an app on a device.
    uninstall     Uninstall an app from a device.
    launch        Launch an application by identifier on a device.
    spawn         Spawn a process on a device.
    list          List available devices, device types, or runtimes.
    notify_post   Post a darwin notification on a device.
    icloud_sync   Trigger iCloud sync on a device.
    help          Prints the usage for a given subcommand.

If all you want to do is delete the single app, you should use uninstall instead of erase. — Jeremy Huddleston Sequoia, Oct 18 '14 at 14:24
In Xcode 6.0.1, even if you use uninstall command, the user defaults remain intact (it's a bug). That's why I suggest using erase. — Frank, Oct 21 '14 at 21:52
Ah, yes. Good point, however that is not an issue with Xcode 6.0.1 but with iOS 8.0. If you use 'delete' on a simulated 7.x device, it will work fine. — Jeremy Huddleston Sequoia, Oct 22 '14 at 00:57

SwiftArchitect · Answer 3 · 2015-11-20T03:51:52.967

11

Reset all Content & Settings in a single command

Quit iPhone Simulator
In Terminal, run:
```
xcrun simctl erase all
```

This will reset content and settings of all the simulators for the active version of Xcode (the one referenced by xcode-select -p).

edited Nov 20 '15 at 03:51

answered Nov 20 '15 at 03:18

SwiftArchitect

47,376
28
140
179

score 5 · Answer 4 · edited Oct 12 '17 at 21:30

5

xcrun simctl uninstall simulatorIdentifier appBundleId

edited Oct 12 '17 at 21:30

Paul Roub

36,322
27
84
93

answered Oct 12 '17 at 21:29

Loveleen Saini

51
1
1

How do I remove app from iOS 8 Simulator from command line?

4 Answers4

Reset all Content & Settings in a single command

Linked