diff --git a/README.md b/README.md index a708b5be4a..c2e05edd80 100644 --- a/README.md +++ b/README.md @@ -61,18 +61,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 +137,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 + * [Xcode 6][12] or a later stable official release * [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 +161,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
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 +213,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 +509,7 @@ This software is licensed under the Apache 2.0 license, quoted [--device ] [--debug-brk | --start | --stop | --get-port] [--debug-port ] - $ nativescript debug [--device ] [--debug-brk | --start | --stop | --get-port] [--debug-port ] + $ tns debug [--device ] [--debug-brk | --start | --stop | --get-port] [--debug-port ] Platform-specific usage: $ tns debug android --get-port $ tns debug android --debug-brk $ tns debug ios --debug-brk - $ nativescript debug android --debug-brk - $ nativescript 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. is the index or name of the target device as listed by $ tns list-devices. @@ -446,7 +443,7 @@ Options: --[emulate]-- Usage: - $ tns emulate emulate [--release] + $ tns emulate [--release] You must run the emulate command with a related command. @@ -541,7 +538,7 @@ Before running the iOS Simulator, verify that you have met the following require NativeScript CLI depends. For more information, visit https://www.npmjs.org/package/ios-sim-portable Options: - --availableDevices - Lists all available device type identifiers for the current XCode. + --availableDevices - Lists all available device type identifiers for the current Xcode. --release - If set, produces a release build. Otherwise, produces a debug build. --path - Specifies the directory that contains the project. If not specified, the project is searched for in the current directory and all directories above it. @@ -621,7 +618,7 @@ You can run this command on one connected device at a time. Prerequisites: Before running your app on an iOS device, verify that your system and app meet the following requirements. * You are running the NativeScript CLI on an OS X system. - * You have installed Xcode 5 or later. + * You have installed Xcode 6 or later. * You have built your app with the debug build configuration. Before running your app on an Android device, verify that your app meets the following requirement. * You have built your app with the debug build configuration.