table of contents
ideviceinstaller(1) | General Commands Manual | ideviceinstaller(1) |
NAME¶
ideviceinstaller - Manage apps on iOS devices.
SYNOPSIS¶
ideviceinstaller [OPTIONS]
DESCRIPTION¶
Allows to enumerate, install, upgrade, and uninstall apps on iOS devices.
COMMANDS¶
- list
- List installed apps on the device. Options:
- --user
- List user apps only (apps installed by the user). This is the default.
- --system
- List system apps only (apps available from the system firmware).
- --all
- List all types of apps.
- --xml
- Print output as XML Property List.
- -a, --attribute ATTR
- Specify attribute to return. This argument can be passed multiple times. If omitted and --xml is *not* specified, the default attributes CFBundleIdentifier, CFBundleShortVersionString, and CFBundleDisplayName will be used. The attributes can be found in the app's Info.plist, but also some extra attributes exist. Some examples:
- -b, --bundle-identifier BUNDLEID
- Only query given bundle identifier. This argument can be passed multiple times.
- install PATH
- Install app from a package file specified by PATH. PATH can also be a .ipcc file for carrier bundle installation or a .app directory for developer app installation.
- -s, --sinf PATH
- Pass an external SINF file located at PATH.
- -m, --metadata PATH
- Pass an external iTunesMetadata file located at PATH.
- uninstall BUNDLEID
- Uninstall app specified by BUNDLEID.
- upgrade PATH
- Upgrade app from a package file specified by PATH.
LEGACY COMMANDS¶
The following commands are non-functional with iOS 7 or later.
- archive BUNDLEID
- Archive app specified by BUNDLEID. Options:
- --uninstall
- Uninstall the package after making an archive
- --app_only
- Archive application data only
- --docs_only
- Archive documents (user data) only
- --copy=PATH
- Copy the app archive to directory PATH when done
- --remove
- Only valid when copy=PATH is used: remove after copy
- restore BUNDLEID
- Restore archived app specified by BUNDLEID.
- list-archives
- List archived apps on the device. Options:
- --xml
- Print output as XML Property List.
- remove-archive BUNDLEID
- Remove app archive specified by BUNDLEID.
OPTIONS¶
- -u, --udid UDID
- Target specific device by UDID.
- -n, --network
- Connect to network device.
- -w, --notify-wait
- Wait for app installed/uninstalled notification before reporting success of operation.
- -h, --help
- Print usage information.
- -d, --debug
- Enable communication debugging.
- -v, --version
- Print version information.
AUTHORS¶
Nikias Bassen
Martin Szulecki