🤖 Create an engaging chatbot from scratch and add it to your NativeScript app! Learn more at our webinar on March 28th.

NativeScript Angular

NativeScript Advanced Setup: Windows

This page contains a guided walkthrough for installing NativeScript requirements and start building and running NativeScript apps on Windows.

NOTE: On Windows systems you can only use the NativeScript CLI to develop Android apps. This is because the NativeScript CLI uses Xcode to build iOS apps, which is only available on the macOS operating system. If you’re interested in building iOS apps on Windows, you may want to try out NativeScript Sidekick. NativeScript Sidekick provides robust tooling for NativeScript apps, including a service that performs iOS and Android builds in the cloud, removing the need to complete these system requirements, and allowing you to build for iOS on Windows.


  • Windows 7 Service Pack 1 or later

Setup Steps

Complete the following steps to set up NativeScript on your Windows development machine:

  1. Install Chocolatey to simplify the installation and configuration of the requirements.

    • Run the command prompt as an Administrator.
    • Copy and paste the following script in the command prompt.

      @powershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin
    • Restart the command prompt.
  2. Install Google Chrome (required to debug NativeScript apps)

    • In the command prompt, run the following command.

      choco install googlechrome -y
  3. Install the latest Node.js LTS

    • In the command prompt, run the following command.

      choco install nodejs-lts -y
  4. Set up JDK 8

    • In the command prompt, run the following command.

      choco install adoptopenjdk --version 8.192
  5. Install the Android SDK.

    • In the command prompt, run the following command.

      choco install android-sdk -y
    • Restart the command prompt.

  6. Install all packages for the Android SDK Platform 28, Android SDK Build-Tools 28.0.3 or later, Android Support Repository, Google Repository and any other SDKs that you may need. You can alternatively use the following command, which will install all required packages.

    "%ANDROID_HOME%\tools\bin\sdkmanager" "emulator" "platform-tools" "platforms;android-28" "build-tools;28.0.3" "extras;android;m2repository" "extras;google;m2repository"
  7. Install Android virtual devices (AVDs). There are multiple ways to do it so just choose one:

    a. Execute the following command in Command Prompt as Administrator:

    @powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://nativescript.org/setup/win-avd'))"

    b. Use Android Studio and install Android virtual devices (AVDs) from there:

    • Install the Android Studio by running the following command in the command prompt as Administrator:

      choco install androidstudio -y
    • Restart the command prompt.

    • Open Android Studio > NOTE: If you see a gradle error like "Failed to find Build Tools revision 25.0.2", make sure to click on the install link and fix this error. Otherwise Tools->Android->AVD Manager might not be available.
    • Go to Create and Manage Virtual Devices
    • Follow the steps to create and start AVD with enabled HAXM.

    c. Alternatively a Visual Studio Emulator for Android can be used but have in mind it requires Windows 8+.

  8. Install the NativeScript CLI.

    • Run the following command.

      npm i -g nativescript
    • Restart the command prompt.

  9. To check if your system is configured properly, run the following command.

    tns doctor

If you see "No issues were detected" you are good to go!

NativeScript tns doctor result

What’s Next