NativeScript Extension for Visual Studio Code

Introduction

The NativeScript extension for Visual Studio Code aids your NativeScript project development within Visual Studio Code.

Install NativeScript

To install NativeScript and all its dependencies, follow the instructions in our getting started guide.

Note: The VS Code extension requires nativescript node module to be globally installed. If you are using nvm to manage your node versions, make sure that nativescript is installed in your default nodeJS version. To check which is your default node version execute 'nvm ls' on the command prompt and you should see something like 'default -> 5.5.0 (-> v5.5.0)' in the output.

Setup the extension

Create NativeScript application by running tns create MyApp and open MyApp folder in Visual Studio Code. Open the Debug Panel, click the gear icon

and choose NativeScript debug environment.

Debug your NativeScript application

To start the application with attached debugger, choose one of the launch configurations from the drop-down list and then click the start button.

Your application will be launched and the VSCode debugger will break on the first JavaScript statement. Click continue and your app will show up on the emulator/device. If you want to attach to already running NativeScript application, use one of the attach configurations. More information on what you can do with the Visual Studio Code Debugger you can find here.

NativeScript commands

Type NativeScript in the Command Palette and you will see all available commands.

There's only a couple of them but the list will grow in the future.

The Run command triggers tns run on emulator or device. You can run your app both on iOS and Android.

If your version of NativeScript is incompatible with the extension you will see a warning the first time you run a command.

Get the latest bits

1. Clone the extension repository: git clone [email protected]:NativeScript/nativescript-vscode-extension.git

2. To build the extension run the following commands in the root repository folder:

   npm install
   npm run build # compiles TypeScript source files to JavaScript
   npm run package # produces nativescript-*.*.*.vsix in the root folder
   

3. To test the extension run the following commands in the root repository folder:

   npm install
   npm run build # compiles TypeScript source files to JavaScript
   npm run launch-as-server # launches the debug adapter in server mode
   # execute this in a separate terminal
   npm run test-mac # run tests on ios device
   

4. To install the extension drag and drop the nativescript-*.*.*.vsix package in the VS Code.