Merge branch 'release' into vladimirov/merge-release-0-9-1

Conflicts:
	lib/common

Author: rosen-vladimirov

README.md

@@ -1,10 +1,10 @@
-Telerik NativeScript Command-Line Interface
+NativeScript Command-Line Interface
 ================
 [![Build Status](https://travis-ci.org/NativeScript/nativescript-cli.svg?branch=build)][2]
 
 *Create, build, and run native apps for iOS and Android using JavaScript or TypeScript*
 
-The Telerik NativeScript CLI lets you create, build, and deploy Telerik NativeScript-based projects on iOS and Android devices.
+The NativeScript CLI lets you create, build, and deploy NativeScript-based projects on iOS and Android devices.
 
 * [What is NativeScript](#what-is-nativescript "Quick overview of NativeScript, the JavaScript framework for cross-platform development of native iOS and Android apps")
 * [Supported Platforms](#supported-platforms "The mobile platforms you can target with NativeScript")
@@ -27,8 +27,6 @@ The Telerik NativeScript CLI lets you create, build, and deploy Telerik NativeSc
 What is NativeScript
 ===
 
-> NativeScript is currently available as a private preview. To sign up for the NativeScript Insiders program, visit <a href="http://www.telerik.com/nativescript-insiders-signup" target="_blank">http://www.telerik.com/nativescript-insiders-signup</a>.
-
 NativeScript is a cross-platform JavaScript framework that lets you develop native iOS and Android apps from a single code base. The framework provides JavaScript access to the native APIs, user interface, and rendering engines of iOS and Android. By using JavaScript or TypeScript, you can create one project that builds into an iOS or Android app with completely native user experience.
 
 To learn more about NativeScript, you can check the following resources:
@@ -61,18 +59,19 @@ You can install and run the NativeScript CLI on Windows or OS X.
 
 * [Windows](#widnows)
 * [OS X](#os-x)
+* [Linux](#linux)
 
 ## Windows
 
 > On Windows systems, you can develop, build, and deploy NativeScript projects that target Android.
 
 * Windows Vista or later
-* [Node.js 0.10.26] or a later stable official release
-* (Optional) [Chocolatey]
-* [JDK 6] or a later stable official release
-* [Apache Ant 1.8] or a later stable official release
-* [Android SDK 19] or a later stable official release
-* (Optional) [Genymotion]
+* [Node.js 0.10.26][Node.js 0.10.26] or a later stable official release
+* (Optional) [Chocolatey][Chocolatey]
+* [JDK 7][JDK 7] or a later stable official release
+* [Apache Ant 1.8][Apache Ant 1.8] or a later stable official release
+* [Android SDK 19][Android SDK 19] or a later stable official release
+* (Optional) [Genymotion][Genymotion]
 
 If you want to develop for Android, verify that you have added the following paths in the `PATH` system environment variable.
 
@@ -136,17 +135,16 @@ If you have installed Chocolatey, you can complete these steps to set up JDK, Ap
 > On OS X systems, you can develop, build, and deploy NativeScript projects that target iOS and Android.
 
 * OS X Mavericks
-* [Node.js 0.10.26] or a later stable official release
+* [Node.js 0.10.26][Node.js 0.10.26] or a later stable official release
 * For iOS development
-	* [iOS 7.0 SDK][12] or a later stable official release
-	* [Xcode 5][12] or a later stable official release
+	* [Latest Xcode][12]
 	* [Xcode command-line tools][12]
-	* (Optional) [Mono] installed via Homebrew
+	* (Optional for working with third-party libraries) [64-bit Mono][Mono] installed via Homebrew
 * For Android development
-	* [JDK 6] or a later stable official release 
-	* [Apache Ant 1.8] or a later stable official release
-	* [Android SDK 19] or a later stable official release 
-	* (Optional) [Genymotion]
+	* [JDK 7][JDK 7] or a later stable official release 
+	* [Apache Ant 1.8][Apache Ant 1.8] or a later stable official release
+	* [Android SDK 19][Android SDK 19] or a later stable official release 
+	* (Optional) [Genymotion][Genymotion]
 
 If you want to develop for Android, verify that you have added the following paths in your `PATH` in `~/.bash_profile`.
 
@@ -161,6 +159,45 @@ For example:
 export PATH=${PATH}:/ant/apache-ant-1.9.4/bin:/Applications/Android Studio.app/sdk/tools:/Applications/Android Studio.app/sdk/platform-tools
 ```
 
+## Linux
+
+> On Linux systems, you can develop, build, and deploy NativeScript projects that target Android.
+
+* Ubuntu 14.04 LTS
+* [Node.js 0.10.26][Node.js 0.10.26] or a later stable official release<br/>If installed via `sudo apt-get install`, use the `nodejs-legacy` package.
+
+	```Shell
+	sudo apt-get install nodejs-legacy
+	```
+* G++ compiler
+
+	```Shell
+	sudo apt-get install g++
+    ```
+* On 64-bit systems only
+	* The runtime libraries for the ia32/i386 architecture.
+
+		```Shell
+		sudo apt-get install lib32z1 lib32ncurses5 lib32bz2-1.0 libstdc++6:i386
+		```
+* [JDK 7][JDK 7] or a later stable official release
+* [Apache Ant 1.8][Apache Ant 1.8] or a later stable official release
+* [Android SDK 19][Android SDK 19] or a later stable official release 
+* (Optional) [Genymotion][Genymotion]
+
+Verify that you have added the following paths in your `PATH`.
+
+```
+Path to the bin subdirectory in the Apache Ant installation directory
+Path to the tools subdirectory in the Android SDK installation directory
+Path to the platform-tools subdirectory in the Android SDK installation directory
+```
+
+For example:
+```
+export PATH=${PATH}:/ant/apache-ant-1.9.4/bin:/Applications/Android Studio.app/sdk/tools:/Applications/Android Studio.app/sdk/platform-tools
+```
+
 [Back to Top][1]
 
 Installation
@@ -174,6 +211,8 @@ In the command prompt, run the following command.
 npm install nativescript -g
 ```
 
+> On OS X and Linux systems, you might need to run this command using sudo.
+
 [Back to Top][1]
 
 Quick Start
@@ -468,7 +507,7 @@ This software is licensed under the Apache 2.0 license, quoted <a href="LICENSE"
 [12]: https://developer.apple.com/xcode/downloads/
 [Node.js 0.10.26]: http://nodejs.org/download/
 [Chocolatey]: https://chocolatey.org/
-[JDK 6]: http://www.oracle.com/technetwork/java/javase/downloads/index.html
+[JDK 7]: http://www.oracle.com/technetwork/java/javase/downloads/index.html
 [Apache Ant 1.8]: http://ant.apache.org/bindownload.cgi
 [Android SDK 19]: http://developer.android.com/sdk/index.html
 [Genymotion]: https://www.genymotion.com/#!/

lib/common

@@ -131,7 +131,8 @@ export class NodePackageManager implements INodePackageManager {
 
 	private addToCacheCore(packageName: string, version: string): IFuture<void> {
 		var future = new Future<void>();
-		npm.commands["cache"].add(packageName, version, undefined, (err: Error, data: any) => {
+		// cache.add = function (pkg, ver, where, scrub, cb)
+		npm.commands["cache"].add(packageName, version, undefined, false, (err: Error, data: any) => {
 			if(err) {
 				future.throw(err);
 			} else {
@@ -144,7 +145,8 @@ export class NodePackageManager implements INodePackageManager {
 	public cacheUnpack(packageName: string, version: string, unpackTarget?: string): IFuture<void> {
 		var future = new Future<void>();
 		unpackTarget = unpackTarget || path.join(npm.cache, packageName, version, "package");
-		npm.commands["cache"].unpack(packageName, version, unpackTarget, (err: Error, data: any) => {
+		// function unpack (pkg, ver, unpackTarget, dMode, fMode, uid, gid, cb)
+		npm.commands["cache"].unpack(packageName, version, unpackTarget, null, null, null, null, (err: Error, data: any) => {
 			if(err) {
 				future.throw(err);
 			} else {

lib/node-package-manager.ts

@@ -1,7 +1,7 @@
 {
   "name": "nativescript",
   "preferGlobal": true,
-  "version": "0.9.0",
+  "version": "0.9.1",
   "author": "Telerik <support@telerik.com>",
   "description": "Command-line interface for building NativeScript projects",
   "bin": {
@@ -33,14 +33,14 @@
     "filesize": "2.0.3",
     "gaze": "0.5.1",
     "iconv-lite": "0.4.4",
-    "ios-sim-portable": "1.0.2",
+    "ios-sim-portable": "1.0.4",
     "lockfile": "1.0.0",
     "lodash": "3.2.0",
     "log4js": "0.6.9",
     "mkdirp": "0.3.5",
     "mute-stream": "0.0.4",
     "node-uuid": "1.4.1",
-    "npm": "1.4.26",
+    "npm": "2.6.1",
     "osenv": "0.1.0",
     "open": "0.0.4",
     "plist": "1.1.0",

package.json

@@ -24,7 +24,7 @@ General commands:
     emulate                         Deploys the project in the native emulator for the selected target platform.
     run                             Runs your project on a connected device or in the native emulator, if configured. 
                                     This is shorthand for prepare, build, and deploy.
-    debug                           Debugs your project on a connected device or in the native emulator, if configured. 
+    debug                           Debugs your project on a connected device. 
     device                          Lists all recognized connected physical or virtual device.
     device log                      Opens the log stream for the selected device.
     device run                      Runs the selected application on a connected device.
@@ -415,38 +415,45 @@ Options:
 --[debug]--
 
 Usage:
-    $ tns debug <Platform> [--device <Device ID>] [--debug-brk | --start | --stop | --get-port] [--debug-port <port>]
-    $ nativescript debug <Platform> [--device <Device ID>] [--debug-brk | --start | --stop | --get-port] [--debug-port <port>]
-
+    $ tns debug android [--device <Device ID> | --emulator <Emulator Options> | --geny <Geny Name> ] [--debug-brk | --start | --stop | --get-port] [--debug-port <port>]
+    $ tns debug ios [--device <Device ID>] [--debug-brk | --start ]
+    
 Platform-specific usage:
     $ tns debug android --get-port
-    $ tns debug android --debug-brk
+    $ tns debug android --debug-brk [--debug-port <port>]
+    $ tns debug android --start [--debug-port <port>]
+    $ tns debug android --stop
     $ tns debug ios --debug-brk
-    $ nativescript debug android --debug-brk
-    $ nativescript debug ios --start
+    $ tns debug ios --start
 
-Debugs your project on a connected device or in the native emulator, if configured. This is shorthand for prepare, build, and deploy.
-<Device ID> is the index or name of the target device as listed by $ tns list-devices.
+Debugs your project on a connected device or in a native emulator.
 
-Before building for the Android emulator, verify that you have met the following requirements.
-    You have added the file paths to the following directories from the Android SDK to your PATH environment variable.
-        tools
-        platform-tools
-    You have created at least one device with the Android Virtual Device manager.
+<Device ID> is the index or name of the target device as listed by $ tns list-devices
+<Port> is an accessible port on the device to which you want to attach the debugging tools.
 
-Before building for iOS device, verify that you have configured a valid pair of certificate and provisioning profile on your OS X system.
-Connecting to iOS device always uses port 8080, --get-port and --debug-port are not supported.
+Before debugging on iOS device, verify that you have configured a valid pair of development certificate and provisioning profile on your OS X system.
 
 Options:
     --device - Specifies a connected device on which to run the app.
-    --emulator - If set, runs the app in the native emulator for the target platform, if configured.
+    --emulator - (Android-only) Specifies that you want to debug the app in the native Android emulator from the Android SDK.
+    --geny - (Android-only) Specifies a Genymotion emulator on which you want to debug your app.
+    --debug-brk - Shorthand for prepare, build and deploy. Prepares, builds and deploys the application package on a device or in an emulator,
+        launches the app and loads the debug tools in the browser.
+        For Android, launches the Chrome DevTools of your Chrome browser. You must have Chrome installed on your system.
+        For iOS, launches the developer tools of your Safari browser.
+    --start - Attaches the debug tools to a deployed and running app. Your app must be running on device.
+    --stop - (Android-only) Detaches the debug tools.
+    --get-port - (Android-only) Retrieves the port on which you are debugging your application.
+        On iOS devices, this option is not available because the debug tools always attach to port 8080.
+    --debug-port - (Android-only) Sets a new port on which to attach the debug tools.
+        On iOS devices, this option is not available because the debug tools always attach to port 8080.
 
 --[/]--
 
 --[emulate]--
 
 Usage:
-    $ tns emulate emulate <Command> [--release]
+    $ tns emulate <Command> [--release]
 
 You must run the emulate command with a related command.