Skip to content

Commit b8b6629

Browse files
committed
Merge pull request #217 from NativeScript/ikoevska/help-txt
Refined the docs
2 parents 354932a + 9b381b9 commit b8b6629

File tree

2 files changed

+335
-113
lines changed

2 files changed

+335
-113
lines changed

README.md

Lines changed: 13 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,16 @@ 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 log` opens the log stream for the selected device.
208+
* `device run` runs a selected application on a connected device.
209+
* `device list-applications` lists the installed applications on all connected devices.
205210
* `feature-usage-tracking` configures anonymous feature usage tracking.
206211

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

364369
```Shell
365-
tns list-devices
370+
tns device
366371
```
367372

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

399404
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.
400405

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.
406+
For iOS, the NativeScript CLI runs your app in the iOS Simulator.
402407

403408
[Back to Top][1]
404409

@@ -423,22 +428,6 @@ tns run ios --emulator
423428
Known Issues
424429
===
425430

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`.
442431
* 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.
443432
1. Close the terminal.
444433
1. Run Safari.
@@ -475,9 +464,9 @@ This software is licensed under the Apache 2.0 license, quoted <a href="LICENSE"
475464
[10]: http://developer.telerik.com/featured/nativescript-android/
476465
[11]: http://blogs.telerik.com/valentinstoychev/posts.aspx/14-06-12/announcing-nativescript---cross-platform-framework-for-building-native-mobile-applications
477466
[12]: https://developer.apple.com/xcode/downloads/
478-
[Node.js 0.10.22]: http://nodejs.org/download/
467+
[Node.js 0.10.26]: http://nodejs.org/download/
479468
[Chocolatey]: https://chocolatey.org/
480469
[JDK 6]: http://www.oracle.com/technetwork/java/javase/downloads/index.html
481470
[Apache Ant 1.8]: http://ant.apache.org/bindownload.cgi
482471
[Android SDK 19]: http://developer.android.com/sdk/index.html
483-
[ios-sim]: https://www.npmjs.org/package/ios-sim
472+
[Genymotion]: https://www.genymotion.com/#!/

0 commit comments

Comments
 (0)