diff --git a/start/ns-setup-linux.md b/start/ns-setup-linux.md index fd526aa20..24db366ab 100644 --- a/start/ns-setup-linux.md +++ b/start/ns-setup-linux.md @@ -9,7 +9,7 @@ previous_url: /setup/ns-cli-setup/ns-setup-linux # Set Up the NativeScript CLI on Linux -With the open-source [NativeScript Command-Line Interface](https://github.com/NativeScript/nativescript-cli) and an IDE or text editor of your choice, you can create, develop, store and build your apps entirely locally, free of charge, without an Internet connection and anonymously. +With the open-source [NativeScript Command-Line Interface](https://github.com/NativeScript/nativescript-cli) and an IDE or text editor of your choice, you can create, develop, store and build your apps entirely locally, free of charge and anonymously. On Linux systems, you can use the NativeScript CLI to develop only Android apps. This limitation is caused by the requirements for iOS development. @@ -20,7 +20,7 @@ On Linux systems, you can use the NativeScript CLI to develop only Android apps. ## System Requirements * Ubuntu 14.04 LTS -* The latest Node.js 0.10.x, 0.12.x, 4.2.x, or 5.1.x stable official release +* The latest Node.js 0.10.x, 0.12.x, 4.x, or 5.x stable official release * G++ compiler * JDK 8 or a later stable official release * Android SDK 22 or a later stable official release diff --git a/start/ns-setup-os-x.md b/start/ns-setup-os-x.md index 893fcbfad..cca51a88e 100644 --- a/start/ns-setup-os-x.md +++ b/start/ns-setup-os-x.md @@ -9,7 +9,7 @@ previous_url: /setup/ns-cli-setup/ns-setup-os-x # Set Up the NativeScript CLI on OS X -With the open-source [NativeScript Command-Line Interface](https://github.com/NativeScript/nativescript-cli) and an IDE or text editor of your choice, you can create, develop, store and build your apps entirely locally, free of charge, without an Internet connection and anonymously. +With the open-source [NativeScript Command-Line Interface](https://github.com/NativeScript/nativescript-cli) and an IDE or text editor of your choice, you can create, develop, store and build your apps entirely locally, free of charge and anonymously. On OS X systems, you can use the NativeScript CLI to develop Android and iOS apps. @@ -20,7 +20,7 @@ On OS X systems, you can use the NativeScript CLI to develop Android and iOS app ## System Requirements * OS X Mavericks or later -* The latest Node.js 0.10.x, 0.12.x, 4.2.x, or 5.1.x stable official release +* The latest Node.js 0.10.x, 0.12.x, 4.x, or 5.x stable official release * (Optional) Homebrew to simplify the installation of dependencies * For iOS development * Latest Xcode @@ -32,6 +32,17 @@ On OS X systems, you can use the NativeScript CLI to develop Android and iOS app * Android SDK Build-tools 22.0.0 or a later stable official release * (Optional) Genymotion to expand your testing options +### Quick setup + +If this is your first time developing a mobile project, consider using the one-liner scripts in this section to effortlessly setup your machine. +If you have experience developing mobile apps, you may skip to the [Environment Requirements](#environment-requirements) section below. + +Using Spotlight, search `Terminal` and start it. This opens a console window. Copy and paste this script: + +> ruby -e "$(curl -fsSL https://raw.githubusercontent.com/NativeScript/nativescript-cli/production/setup/native-script.rb)" + +The script calls some of the commands using `sudo` and you may need to provide your password several times. Note that the script downloads and installs some big dependencies and may take some time to complete. + ## Environment Requirements For Android development @@ -46,10 +57,10 @@ For Android development ```Shell ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" ``` -1. Install the latest Node.js [0.10.x](https://nodejs.org/dist/latest-v0.10.x/), or [0.12.x](https://nodejs.org/dist/latest-v0.12.x/), or [4.2.x](https://nodejs.org/dist/latest-v4.x/) stable official release. +1. Install the latest Node.js stable official release. We recommend using Node.js v4.x ```Shell - brew install homebrew/versions/node012 + brew install homebrew/versions/node4-lts ``` 1. Install the dependencies for iOS development. 1. Run the App Store and download and install Xcode 5 or later. diff --git a/start/ns-setup-win.md b/start/ns-setup-win.md index 51994fcb5..e77f39762 100644 --- a/start/ns-setup-win.md +++ b/start/ns-setup-win.md @@ -9,7 +9,7 @@ previous_url: /setup/ns-cli-setup/ns-setup-win # Set Up the NativeScript CLI on Windows -With the open-source [NativeScript Command-Line Interface](https://github.com/NativeScript/nativescript-cli) and an IDE or text editor of your choice, you can create, develop, store and build your apps entirely locally, free of charge, without an Internet connection and anonymously. +With the open-source [NativeScript Command-Line Interface](https://github.com/NativeScript/nativescript-cli) and an IDE or text editor of your choice, you can create, develop, store and build your apps entirely locally, free of charge and anonymously. On Windows systems, you can use the NativeScript CLI to develop only Android apps. This limitation is caused by the requirements for iOS development. @@ -19,8 +19,8 @@ On Windows systems, you can use the NativeScript CLI to develop only Android app ## System Requirements -* Windows Vista or later -* The latest Node.js 0.10.x, 0.12.x, 4.2.x, or 5.1.x stable official release +* Windows 7 Service Pack 1 or later +* The latest Node.js 0.10.x, 0.12.x, 4.x, or 5.x stable official release * (Optional) Chocolatey to simplify the installation of dependencies * JDK 8 or a later stable official release * Android SDK 22 or a later stable official release @@ -28,6 +28,17 @@ On Windows systems, you can use the NativeScript CLI to develop only Android app * Android SDK Build-tools 22.0.0 or a later stable official release * (Optional) Genymotion to expand your testing options +### Quick setup + +If this is your first time developing a mobile project, consider using the one-liner scripts in this section to effortlessly setup your machine. +If you have experience developing mobile apps, you may skip to the [Environment Requirements](#environment-requirements) section below. + +Open Start Menu, search for `Command Prompt` and start it. This opens a console window. Copy and paste this script: + +> @powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/NativeScript/nativescript-cli/production/setup/native-script.ps1'))" + +You may need to accept an User Account Control prompt to grant the script administrative privileges. Note that the script downloads and installs some big dependencies and may take some time to complete. + ## Environment Requirements For Android development @@ -37,7 +48,7 @@ For Android development ## Setup -1. Install the latest Node.js [0.10.x](https://nodejs.org/dist/latest-v0.10.x/), [0.12.x](https://nodejs.org/dist/latest-v0.12.x/), or [4.2.x](https://nodejs.org/dist/latest-v4.x/) stable official release. +1. Install the latest Node.js [0.10.x](https://nodejs.org/dist/latest-v0.10.x/), [0.12.x](https://nodejs.org/dist/latest-v0.12.x/), [4.x](https://nodejs.org/dist/latest-v4.x/), or [5.x](https://nodejs.org/dist/latest-v5.x/) stable official release. We recommend using Node.js v4.x 1. Install [Chocolatey](https://chocolatey.org) to simplify the installation and configuration of the Android tools and SDKs. 1. Run the command prompt as an Administrator. 1. Copy and paste the following script in the command prompt. diff --git a/start/quick-setup.md b/start/quick-setup.md index 7f7d51e61..93d507745 100644 --- a/start/quick-setup.md +++ b/start/quick-setup.md @@ -21,10 +21,33 @@ When you develop with NativeScript, you can choose between a local tool set ([Na > **TIP:** If you are familiar with the Apache Cordova CLI, you might want to try the NativeScript CLI. It provides a similar set of commands and an identical experience. -With the open-source [NativeScript Command-Line Interface][NativeScript CLI] and an IDE or text editor of your choice, you can create, develop, store and build your apps entirely locally, free of charge, without an Internet connection and anonymously. +With the open-source [NativeScript Command-Line Interface][NativeScript CLI] and an IDE or text editor of your choice, you can create, develop, store and build your apps entirely locally, free of charge and anonymously. To take advantage of this autonomy, you need to configure your system with the tools and SDKs for native development of the platforms for which you want to develop. The NativeScript CLI uses them to produce truly native builds of your cross-platform projects. +### Quick setup + +If this is your first time developing a mobile project, consider using the one-liner scripts in this section to effortlessly setup your machine. +If you have experience developing mobile apps, you may skip to the [advanced setup](#advanced-setup) section below. + + * On Windows: + +Open Start Menu, search for `Command Prompt` and start it. This opens a console window. Copy and paste this script: + +> @powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/NativeScript/nativescript-cli/production/setup/native-script.ps1'))" + +You may need to accept an User Account Control prompt to grant the script administrative privileges. Note that the script downloads and installs some big dependencies and may take some time to complete. + + * On Mac: + +Using Spotlight, search `Terminal` and start it. This opens a console window. Copy and paste this script: + +> ruby -e "$(curl -fsSL https://raw.githubusercontent.com/NativeScript/nativescript-cli/production/setup/native-script.rb)" + +The script calls some of the commands using `sudo` and you may need to provide your password several times. Note that the script downloads and installs some big dependencies and may take some time to complete. + +### Advanced setup + * [Set Up on Windows]({% slug windows %}) * [Set Up on OS X]({% slug osx %}) * [Set Up on Linux]({% slug linux %})