node_modules/ios-deploy/README.md in ios-deploy-1.3.2 vs node_modules/ios-deploy/README.md in ios-deploy-1.5.0
- old
+ new
@@ -6,10 +6,21 @@
* Mac OS X. Tested on 10.10 Yosemite and iOS 8.1
* You need to have a valid iOS development certificate installed.
* Xcode 6.1 should be installed
+## Installation
+ios-deploy installation is made simple using the node.js package manager. If you use [Homebrew](http://brew.sh/), install node.js:
+```bash
+brew install node
+```
+
+Now install ios-deploy with the node.js package manager:
+```bash
+$ npm install -g ios-deploy
+```
+
## Usage
Usage: ios-deploy [OPTION]...
-d, --debug launch the app in GDB after installation
-i, --id <device_id> the id of the device to connect to
@@ -21,19 +32,21 @@
-n, --nostart do not start the app when debugging
-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)
- -p, --port <number> port used for device, default: 12345
- -r, --uninstall uninstall the app before install (do not use with -m; app cache and data are cleared)
+ -p, --port <number> port used for device, default: 12345
+ -r, --uninstall uninstall the app before install (do not use with -m; app cache and data are cleared)
-1, --bundle_id <bundle id> specify bundle id for list and upload
-l, --list list files
-o, --upload <file> upload file
-w, --download download app tree
-2, --to <target pathname> use together with up/download file/tree. specify target
- -V, --version print the executable version
+ -V, --version print the executable version
+ -e, --exists check if the app with given bundle_id is installed or not
+
## Examples
The commands below assume that you have an app called `my.app` with bundle id `bundle.id`. Substitute where necessary.
// deploy and debug your app to a connected device
@@ -45,19 +58,22 @@
// deploy and launch your app to a connected device, quit when app crashes or exits
ios-deploy --noninteractive --debug --bundle my.app
// Upload a file to your app's Documents folder
ios-deploy --bundle_id 'bundle.id' --upload test.txt --to Documents/test.txt
-
+
// Download your app's Documents, Library and tmp folders
ios-deploy --bundle_id 'bundle.id' --download --to MyDestinationFolder
// List the contents of your app's Documents, Library and tmp folders
ios-deploy --bundle_id 'bundle.id' --list
// deploy and debug your app to a connected device, uninstall the app first
ios-deploy --uninstall --debug --bundle my.app
-
+
+ // check whether an app by bundle id exists on the device (check return code `echo $?`)
+ ios-deploy --exists --bundle_id com.apple.mobilemail
+
## Demo
* The included demo.app represents the minimum required to get code running on iOS.
* `make install` will install demo.app to the device.
* `make debug` will install demo.app and launch a GDB session.