Skip to content

Commit 4b1af46

Browse files
committed
Refined the docs
Note that I haven't touched the debug command.
1 parent 483f133 commit 4b1af46

File tree

2 files changed

+341
-107
lines changed

2 files changed

+341
-107
lines changed

README.md

Lines changed: 12 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -67,11 +67,12 @@ You can install and run the NativeScript CLI on Windows or OS X.
6767
> On Windows systems, you can develop, build, and deploy NativeScript projects that target Android.
6868
6969
* Windows Vista or later
70-
* [Node.js 0.10.22] or a later stable official release
70+
* [Node.js 0.10.26] or a later stable official [0.10.x] release
7171
* (Optional) [Chocolatey]
7272
* [JDK 6] or a later stable official release
7373
* [Apache Ant 1.8] or a later stable official release
7474
* [Android SDK 19] or a later stable official release
75+
* (Optional) [Genymotion]
7576

7677
If you want to develop for Android, verify that you have added the following paths in the `PATH` system environment variable.
7778

@@ -135,16 +136,16 @@ If you have installed Chocolatey, you can complete these steps to set up JDK, Ap
135136
> On OS X systems, you can develop, build, and deploy NativeScript projects that target iOS and Android.
136137
137138
* OS X Mavericks
138-
* [Node.js 0.10.22] or a later stable official release
139+
* [Node.js 0.10.26] or a later stable official [0.10.x] release
139140
* For iOS development
140141
* [iOS 7.0 SDK][12] or a later stable official release
141142
* [Xcode 5][12] or a later stable official release
142143
* [Xcode command-line tools][12]
143-
* The [ios-sim] npm package
144144
* For Android development
145145
* [JDK 6] or a later stable official release
146146
* [Apache Ant 1.8] or a later stable official release
147147
* [Android SDK 19] or a later stable official release
148+
* (Optional) [Genymotion]
148149

149150
If you want to develop for Android, verify that you have added the following paths in your `PATH` in `~/.bash_profile`.
150151

@@ -196,12 +197,15 @@ Run `tns help` to list all available commands. Run or `tns <Command> --help` to
196197
* `platform list` lists the current target platforms for your project.
197198
* `platform add <Platform>` adds a new target platform to your project.
198199
* `platform remove <Platform>` removes the selected platform from the target platforms of the project.
200+
* `platform update <Platform>` updates the NativeScript runtime for the specified platform.
199201
* `prepare <Platform>` copies cross-platform and selected platform-specific content to the subdirectory for the target platform.
200202
* `build <Platform>` builds the project for the selected target platform.
201203
* `emulate <Platform>` builds the project for the selected target platform and runs it in the native emulator, if configured.
202204
* `deploy <Platform> [--device <Device ID>]` deploys an already built application on connected device.
203205
* `run <Platform> [--device <Device ID>]` executes `prepare`, `build`, and `deploy`.
204-
* `list-devices` lists connected devices, including any running Android Virtual Devices.
206+
* `device` lists connected devices, including any running Android Virtual Devices or Genymotion virtual devices.
207+
* `device run` runs a selected application on a connected device.
208+
* `device list-applications` lists the installed applications on all connected devices.
205209
* `feature-usage-tracking` configures anonymous feature usage tracking.
206210

207211
[Back to Top][1]
@@ -362,7 +366,7 @@ You can test your work in progress on connected Android or iOS devices.
362366
To verify that the NativeScript CLI recognizes your connected devices, run the following command.
363367

364368
```Shell
365-
tns list-devices
369+
tns device
366370
```
367371

368372
The NativeScript CLI lists all connected physical devices and running Android Virtual Devices.
@@ -398,7 +402,7 @@ This operation calls the SDK for the selected target platform, builds your app l
398402

399403
For Android, the NativeScript CLI runs your app in the earliest created virtual device or the currently running Android Virtual Device. Before running your app in the Android native emulator, make sure that you have configured at least one virtual device in the Android Virtual Device manager.
400404

401-
For iOS, the NativeScript CLI runs your app in the iOS Simulator. Before running your app in the iOS Simulator, make sure that you have installed the [ios-sim] npm package.
405+
For iOS, the NativeScript CLI runs your app in the iOS Simulator.
402406

403407
[Back to Top][1]
404408

@@ -423,22 +427,6 @@ tns run ios --emulator
423427
Known Issues
424428
===
425429

426-
* On OS X systems with Xcode 6, you cannot run your app in the native iOS emulator.
427-
* You can run your app only in the earliest created Android Virtual Device or the currently running Android Virtual Device.<br/>**Workaround:** Run your app on a selected virtual device from the `deploy` command.
428-
1. Run the following command, to start the Android Virtual Device manager.
429-
430-
```Shell
431-
android avd
432-
```
433-
1. Select the virtual device on which you want to run your app and click **Start**.
434-
1. Click **Launch** and wait for the device to load.
435-
1. In a new command prompt, run the following command.
436-
437-
```Shell
438-
tns run android --device <Device ID>
439-
```
440-
441-
Where `<Device ID>` is the index or name of the device as listed by `tns list-devices`.
442430
* On OS X systems with configured firewall or web proxy, when you run a command, the operation might not release the command line and you might not be able to run other commands until you break the current operation.<br/>If you have enabled feature usage tracking for the NativeScript CLI, but you have not authenticated with the firewall or web proxy on your OS X system, the NativeScript CLI might not release the command line after you run a command. To continue working with the NativeScript CLI, you need to break the current operation by pressing `Ctrl+C`.<br/>**Workaround:** Authenticate with the firewal or web proxy.
443431
1. Close the terminal.
444432
1. Run Safari.
@@ -475,9 +463,9 @@ This software is licensed under the Apache 2.0 license, quoted <a href="LICENSE"
475463
[10]: http://developer.telerik.com/featured/nativescript-android/
476464
[11]: http://blogs.telerik.com/valentinstoychev/posts.aspx/14-06-12/announcing-nativescript---cross-platform-framework-for-building-native-mobile-applications
477465
[12]: https://developer.apple.com/xcode/downloads/
478-
[Node.js 0.10.22]: http://nodejs.org/download/
466+
[Node.js 0.10.26]: http://nodejs.org/download/
479467
[Chocolatey]: https://chocolatey.org/
480468
[JDK 6]: http://www.oracle.com/technetwork/java/javase/downloads/index.html
481469
[Apache Ant 1.8]: http://ant.apache.org/bindownload.cgi
482470
[Android SDK 19]: http://developer.android.com/sdk/index.html
483-
[ios-sim]: https://www.npmjs.org/package/ios-sim
471+
[Genymotion]: https://www.genymotion.com/#!/

0 commit comments

Comments
 (0)