sergey-plevako-badoo/applesimulatorutils

A collection of command-line utils for Apple simulators.

AppleSimulatorUtils

A collection of utils for Apple simulators.

Installing

Install brew, then:

brew tap wix/brew
brew install applesimutils

Usage

A collection of utils for Apple simulators.

Usage Examples:
    applesimutils --byId <simulator UDID> --bundle <bundle identifier> --setPermissions "<permission1>, <permission2>, ..."
    applesimutils --byName <simulator name> --byOS <simulator OS> --bundle <bundle identifier> --setPermissions "<permission1>, <permission2>, ..."
    applesimutils --list [--byName <simulator name>] [--byOS <simulator OS>] [--byType <simulator device type>] [--maxResults <int>]
    applesimutils --booted --biometricEnrollment <YES/NO>
    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
    --setPermissions, -sp          Sets the specified permissions and restarts SpringBoard for the changes to take effect
    --clearKeychain, -ck           Clears the simulator's keychain
    --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)
    --bundle, -b                   The app bundle identifier
    --maxResults                   Limits the number of results returned from --list
    --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 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|unset
    photos=YES|NO|unset
    reminders=YES|NO|unset
    siri=YES|NO|unset
    speech=YES|NO|unset

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