Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wix/AppleSimulatorUtils
A collection of command-line utils for Apple simulators.
https://github.com/wix/AppleSimulatorUtils
apple-simulators ios ios-simulator
Last synced: about 1 month ago
JSON representation
A collection of command-line utils for Apple simulators.
- Host: GitHub
- URL: https://github.com/wix/AppleSimulatorUtils
- Owner: wix
- License: other
- Created: 2017-03-30T04:44:05.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-15T08:55:18.000Z (8 months ago)
- Last Synced: 2024-05-11T17:32:24.441Z (4 months ago)
- Topics: apple-simulators, ios, ios-simulator
- Language: Objective-C
- Homepage:
- Size: 249 KB
- Stars: 623
- Watchers: 186
- Forks: 67
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# AppleSimulatorUtils
A collection of utils for Apple simulators.
## Deprecation Notice
**AppleSimulatorUtils** remains an actively maintained project.
However, we have deprecated certain functionalities that overlap with features provided by the **`xcrun simctl`** command in the latest **Command Line Tools for Xcode**.
In addition to avoid redundancy, it is better to use the **official** tool provided by Apple.
For a comprehensive list of deprecated commands and their `xcrun simctl` alternatives, please refer to our [Deprecations Document](./DEPRECATIONS.md).
## Installing
Install [brew](https://brew.sh), then:
```shell
brew tap wix/brew
brew install applesimutils
```
## Usage
```
A collection of utils for Apple simulators.
Usage Examples:
applesimutils --byId --bundle --setPermissions ", , ..."
applesimutils --byName --byOS --bundle --setPermissions ", , ..."
applesimutils --list [--byName ] [--byOS ] [--byType ] [--maxResults ]
applesimutils --booted --biometricEnrollment
applesimutils --booted --biometricMatch
Options:
--byId, -id Filters simulators by unique device identifier (UDID)
--byName, -n Filters simulators by name
--byType, -t Filters simulators by device type
--byOS, -o Filters simulators by operating system
--booted, -bt Filters simulators by booted status
--list, -l Lists available simulators
--bundle, -b The app bundle identifier
--maxResults Limits the number of results returned from --list
--setPermissions, -sp Sets the specified permissions and restarts SpringBoard for the changes to take effect
--clearKeychain, -ck Clears the simulator's keychain
--clearMedia, -cm Clears the simulator's media
--restartSB, -sb Restarts SpringBoard
--biometricEnrollment, -be Enables or disables biometric (Face ID/Touch ID) enrollment.
--biometricMatch, -bm Approves a biometric authentication request with a matching biometric feature (e.g. face or finger)
--biometricNonmatch, -bnm Fails a biometric authentication request with a non-matching biometric feature (e.g. face or finger)
--version, -v Prints version
--help, -h Prints usage
Available Permissions:
calendar=YES|NO|unset
camera=YES|NO|unset
contacts=YES|NO|unset
faceid=YES|NO|unset
health=YES|NO|unset (iOS/tvOS 12.0 and above)
homekit=YES|NO|unset
location=always|inuse|never|unset
medialibrary=YES|NO|unset
microphone=YES|NO|unset
motion=YES|NO|unset
notifications=YES|NO|critical|unset
photos=YES|NO|limited|unset (“limited” supported on iOS/tvOS 14.0 and above)
reminders=YES|NO|unset
siri=YES|NO|unset
speech=YES|NO|unset
userTracking=YES|NO|unset (iOS/tvOS 14.0 and above)
```
## Troubleshooting
- In case an installation fails, make sure to update your command line tools in the System Update system preference pane of your Mac
- If Homebrew complains about a conflict in the `wix/brew` tap, run `brew untap wix/brew && brew tap wix/brew` and try installing again
- If installation still fails, **run `brew doctor` and fix all issues & warnings**
### Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for more information.