GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • NativeScript
  • Blog
  • Community
  • Support
  • Open NativeScript GitHub
  • Environment Setup
  • Linux

This view

  • Original page
  • New address

GeezerVison is showing docs.nativescript.org — Setting up Linux for NativeScript | NativeScript

NativeScript 9.1 Released → V8 14.9, Vite 8 HMR, built for rapid agentic visual iteration
Dig in→
  • Docs
  • Tutorials
  • Preview
  • Snacks
  • Plugins
  • UI Components
  • API Reference

  • Getting Started

    • Introduction
    • Environment Setup
      • Windows
      • macOS
      • Linux
    • Creating a Project
    • Choosing an editor
    • Troubleshooting

  • Development Workflow

    • CLI Basics
    • Running
    • Debugging
    • Publishing
    • Plugins
    • Recommended Plugins
    • Testing
    • Updating
      • To Latest

  • Project Structure

    • App_Resources/
    • src/
      • fonts/
      • app.css•scss
      • main.js•ts
    • nativescript.config.ts
    • package.json
    • references.d.ts
    • tsconfig.json
    • vite.config.mts
    • webpack.config.js

  • Configuration

    • Config Reference
    • Vite Reference
    • Vite Framework Flavors
    • Webpack Reference

  • Fundamental Concepts

    • Accessibility
    • Animations
    • Best Practices
    • Commonly Used APIs
      • @nativescript/core
        • Application
        • ApplicationSettings
        • Color
        • Connectivity
        • Device
        • FileSystem
        • FPS Meter
        • Http
        • ImageCache
        • Observable
        • Screen
        • Trace
        • Utils
        • XmlParser
    • Data Binding
    • Error Handling
    • Gestures
    • Navigation
      • Using Frames and Pages
      • Using Modals
    • Property System
    • Styling

  • Crash Reporting

    • Using Sentry

  • Developing with Vision Pro

    • Developing with visionOS
    • Previewing visionOS from StackBlitz

  • Agentic Coding

    • Leverage AI assistants
    • Using the Docs with AI

  • Advanced Concepts

    • Adding Native Code
      • Adding Java/Kotlin Code
      • Adding ObjectiveC/Swift Code
      • Generating TypeScript types
    • Extending Native Classes
      • Android
      • iOS
    • Create Custom Native Elements
    • Customizing View Elements
    • Shared Element Transitions
    • Multithreading
    • Multi-Window Development
    • Code Sharing
    • Metadata
    • Marshalling
      • iOS Marshalling
      • iOS Runtime Types
      • Android Marshalling
    • Hooks
    • Platform Version Handling
    • Widgets for iOS
Are you an LLM? You can read better optimized documentation at /setup/linux.md for this page in Markdown format

Setting up Linux for Android ​

You will need Node, NativeScript CLI (command line interface), Android Studio and a JDK (java development kit).

Android Studio is not strictly necessary — however it provides an easy-to-use interface for installing and managing the Android SDKs.

To install Node follow the instructions specific to your Linux distribution. We recommend using the latest version, however anything above Node 14 should be fine.

Note

We have gone through these steps on Ubuntu 20.04 and noted the commands we used, however depending on your Linux distribution, the commands may be different. We cannot provide commands for all possible distributions, so please refer to the linked documentation to find the correct commands you need to run.

bash
# On Ubuntu 20.04, we used the following command to install latest node
$ curl -fsSL https://deb.nodesource.com/setup_15.x | sudo -E bash -
$ sudo apt-get install -y nodejs

To confirm Node is installed correctly, run:

bash
$ node -v
$ npm -v
# Should print something like
$:v22.x.x
10.x.x

A JDK version 8 or greater is required, and you have a couple options:

  1. OpenJDK - Adoptium — can be downloaded from Adoptium or your system package manager.
  2. OpenJDK - AdoptOpenJDK — can be downloaded from AdoptOpenJDK or your system package manager.
  3. Oracle JDK — can be downloaded directly or through the system package manager.
bash
# On Ubuntu 20.04, we used the following command to install OpenJDK 17
sudo apt-get install -y openjdk-17-jdk

To confirm JDK is installed correctly, run:

bash
$ java --version
$ javac --version
# Should print something like
$:openjdk 17.x.x 202x-xx-xx
OpenJDK Runtime Environment (build xx.x.x+xx-Ubuntu-xxx.xx)
OpenJDK 64-Bit Server VM (build xx.x.x+xx-Ubuntu-xxx.xx, mixed mode, sharing)

javac 17.x.x

Note

NativeScript uses Gradle for Android builds. Different versions of Gradle rely on certain versions of Java to work. If a build fails, check whether the version of Java installed on your system is compatible with the version of Gradle used by NativeScript. The version of Gradle used by NativeScript can be seen in the build logs or in the source.

Setting up the Android development environment can be daunting if you are new to Android development, however following the next steps carefully will get you up and running in no time.

Download and install Android Studio. In the installation wizard, make sure you have the following components selected (the list should appear if you select custom options):

  • Android SDK
  • Android SDK Platform
  • Android Virtual Device

The setup may take a while, but once it has finished a welcome screen should appear.

Android Studio installs the latest Android SDK by default, which in most cases should be all that's needed to build a NativeScript app.

Configure the ANDROID_HOME environment variable for NativeScript to be able to find the Android SDK, and add the required tools to path.

Add the following lines to your shell profile, usually ~/.bash_profile or ~/.bashrc, or if you are using zsh then ~/.zshrc config file:

shell
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools

Install the NativeScript CLI globally:

bash
npm install -g nativescript
You may see Deprecation and security warnings from npm, these are safe to ignore. Read more...

The NativeScript CLI relies on 3rd party packages that may have been deprecated over the past years. We are slowly replacing these dependencies with newer, supported alternatives to resolve these warnings, however they are generally safe to ignore, since the CLI is never exposed to the public and it's only used for local development, where most of the security concerns don't apply.

Note

Depending on how you installed Node, you may get an EACCESS: permission denied error when trying to install a global package. It's generally not recommended to run npm with sudo, see this guide for Resolving EACCESS permissions errors.

Verifying the environment ​

To verify that the installation was successful, open a new Command Prompt window (to ensure the new environment variables are loaded) and run

bash
ns doctor android

If you see No issues were detected then you have successfully set up your system.

Setting up Linux for iOS ​

❌ Unsupported

A Mac is required to build projects that use native iOS code. Simpler apps can be tested using NativeScript Preview.

Next
Creating a Project→
On this page
  2. Setting up Linux for Android
    1. Verifying the environment
  3. Setting up Linux for iOS

Contributors

rigor789aryzing
Edit this page

Last updated:

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.