ios-deploy - npm explorer

![Build Status](https://travis-ci.org/ios-control/ios-deploy)

ios-deploy
==========

Install and debug iOS apps from the command line. Designed to work on un-jailbroken devices.

Requirements

* macOS
* You need to have a valid iOS Development certificate installed
* Xcode (NOT just Command Line Tools!)

#### Tested Configurations
The ios-deploy binary in Homebrew should work on macOS 10.0+ with Xcode7+. It has been most recently tested with the following configurations:
- macOS 10.14 Mojave, 10.15 Catalina and preliminary testing on 11.0b BigSur
- iOS 13.0 and preliminary testing on iOS 14.0b
- Xcode 11.3, 11.6 and preliminary testing on Xcode 12 betas
- x86 and preliminary testing on Arm64e based Apple Macintosh Computers

Roadmap

See our milestones.

Development

The 1.x branch has been archived (renamed for now), all development is to be on the master branch for simplicity, since the planned 2.x development (break out commands into their own files) has been abandoned for now.

Installation

If you have previously installed ios-deploy via npm, uninstall it by running:
``sudo npm uninstall -g ios-deploy`

Install ios-deploy via Homebrew by running:

`brew install ios-deploy`

`Testing`

Run:

`python -m py_compile src/scripts/*.py && xcodebuild -target ios-deploy && xcodebuild test -scheme ios-deploy-tests`

`Usage`

Usage: ios-deploy [OPTION]... -d, --debug launch the app in lldb after installation -i, --id the id of the device to connect to -c, --detect list all connected devices -b, --bundle the path to the app bundle to be installed -a, --args command line arguments to pass to the app when launching it -s, --envs environment variables, space separated key-value pairs, to pass to the app when launching it -t, --timeout number of seconds to wait for a device to be connected -u, --unbuffered don't buffer stdout -n, --nostart do not start the app when debugging -N, --nolldb start debugserver only. do not run lldb. Can not be used with args or envs options -I, --noninteractive start in non interactive mode (quit when app crashes or exits) -L, --justlaunch just launch the app and exit lldb -v, --verbose enable verbose output -m, --noinstall directly start debugging without app install (-d not required) -A, --app_deltas incremental install. must specify a directory to store app deltas to determine what needs to be installed -p, --port port used for device, default: dynamic -r, --uninstall uninstall the app before install (do not use with -m; app cache and data are cleared) -9, --uninstall_only uninstall the app ONLY. Use only with -1 -1, --bundle_id specify bundle id for list and upload -l, --list[=

]           list all app files or the specified directory
	  -o, --upload           upload file
	  -w, --download[=]      download app tree or the specified file/directory
	  -2, --to    use together with up/download file/tree. specify target
	  -D, --mkdir             make directory on device
	  -R, --rm               remove file or directory on device (directories must be empty)
	  -X, --rmtree           remove directory and all contained files recursively on device
	  -V, --version                print the executable version
	  -e, --exists                 check if the app with given bundle_id is installed or not
	  -B, --list_bundle_id         list bundle_id
	  -W, --no-wifi                ignore wifi devices
	  -C, --get_battery_level      get battery current capacity
	  -O, --output           write stdout to this file
	  -E, --error_output     write stderr to this file
	  --detect_deadlocks      start printing backtraces for all threads periodically after specific amount of seconds
	  -f, --file_system            specify file system for mkdir / list / upload / download / rm
	  -F, --non-recursively        specify non-recursively walk directory
	  -S, --symbols                download OS symbols. must specify a directory to store the downloaded symbols
	  -j, --json                   format output as JSON
	  -k, --key                    keys for the properties of the bundle. Joined by ',' and used only with -B  and -j 
	  --custom-script ios-deploy - npm explorer
ios-deploy
v1.12.2
launch iOS apps iOS devices from the command line (Xcode 7)
ios-deploydeploy to iOS device
0/weekUpdated 2 years agoGPLv3Unpacked: 305.8 KB
Published by Greg Hughes
npm install ios-deploy
RepositoryHomepagenpm
![Build Status](https://travis-ci.org/ios-control/ios-deploy)
ios-deploy
==========
Install and debug iOS apps from the command line. Designed to work on un-jailbroken devices.
Requirements
* macOS
* You need to have a valid iOS Development certificate installed
* Xcode (NOT just Command Line Tools!)
#### Tested Configurations
The ios-deploy binary in Homebrew should work on macOS 10.0+ with Xcode7+. It has been most recently tested with the following configurations:
 - macOS 10.14 Mojave, 10.15 Catalina and preliminary testing on 11.0b BigSur
 - iOS 13.0 and preliminary testing on iOS 14.0b
 - Xcode 11.3, 11.6 and preliminary testing on Xcode 12 betas
 - x86 and preliminary testing on Arm64e based Apple Macintosh Computers
Roadmap
See our milestones.
	
Development
The 1.x branch has been archived (renamed for now), all development is to be on the master branch for simplicity, since the planned 2.x development (break out commands into their own files) has been abandoned for now.
Installation
If you have previously installed ios-deploy via npm, uninstall it by running:
``
sudo npm uninstall -g ios-deploy
`
Install ios-deploy via Homebrew by running:
`
brew install ios-deploy
`
Testing
Run:
`
python -m py_compile src/scripts/*.py && xcodebuild -target ios-deploy && xcodebuild test -scheme ios-deploy-tests
`
Usage
    Usage: ios-deploy [OPTION]...
	  -d, --debug                  launch the app in lldb after installation
	  -i, --id          the id of the device to connect to
	  -c, --detect                 list all connected devices
	  -b, --bundle     the path to the app bundle to be installed
	  -a, --args             command line arguments to pass to the app when launching it
	  -s, --envs             environment variables, space separated key-value pairs, to pass to the app when launching it
	  -t, --timeout       number of seconds to wait for a device to be connected
	  -u, --unbuffered             don't buffer stdout
	  -n, --nostart                do not start the app when debugging
	  -N, --nolldb                 start debugserver only. do not run lldb. Can not be used with args or envs options
	  -I, --noninteractive         start in non interactive mode (quit when app crashes or exits)
	  -L, --justlaunch             just launch the app and exit lldb
	  -v, --verbose                enable verbose output
	  -m, --noinstall              directly start debugging without app install (-d not required)
	  -A, --app_deltas             incremental install. must specify a directory to store app deltas to determine what needs to be installed
	  -p, --port           port used for device, default: dynamic
	  -r, --uninstall              uninstall the app before install (do not use with -m; app cache and data are cleared)
	  -9, --uninstall_only         uninstall the app ONLY. Use only with -1 
	  -1, --bundle_id   specify bundle id for list and upload
	  -l, --list[=
]           list all app files or the specified directory
	  -o, --upload           upload file
	  -w, --download[=]      download app tree or the specified file/directory
	  -2, --to    use together with up/download file/tree. specify target
	  -D, --mkdir             make directory on device
	  -R, --rm               remove file or directory on device (directories must be empty)
	  -X, --rmtree           remove directory and all contained files recursively on device
	  -V, --version                print the executable version
	  -e, --exists                 check if the app with given bundle_id is installed or not
	  -B, --list_bundle_id         list bundle_id
	  -W, --no-wifi                ignore wifi devices
	  -C, --get_battery_level      get battery current capacity
	  -O, --output           write stdout to this file
	  -E, --error_output     write stderr to this file
	  --detect_deadlocks      start printing backtraces for all threads periodically after specific amount of seconds
	  -f, --file_system            specify file system for mkdir / list / upload / download / rm
	  -F, --non-recursively        specify non-recursively walk directory
	  -S, --symbols                download OS symbols. must specify a directory to store the downloaded symbols
	  -j, --json                   format output as JSON
	  -k, --key                    keys for the properties of the bundle. Joined by ',' and used only with -B  and -j 
	  --custom-script Dist Tags
latest1.12.2
beta1.11.2