Back to Blog Home
← all posts

NativeScript 3.0 Available Today

May 3, 2017 — by Georgi Atanasov

We are incredibly excited to announce the official release of NativeScript 3.0! Since the 3.0 Release Candidate, we've been working hard to fix all major issues and ease the migration path to this new major version of the framework. We closed about 80 pull requests across all repositories and upgraded dozens of plugins and applications to ensure a smooth migration experience for our users. We have also prepared a document to describe the need behind a major version bump and the newly introduced breaking changes.

You can try out the new 3.0 bits by running:

npm install -g nativescript

...and follow our documented upgrade instructions for upgrading individual projects.

Be sure to register to attend the free NativeScript 3.0 webinar (coming up on May 17th!) to learn all about this release and be the first to hear exciting news about our future product plans.

Release Highlights

Here is an overview of what's included in NativeScript 3.0:

Cross-Platform Modules

  • The new Modules 3.0 implementation. The 3.0 refactoring is based on three major pillars:
    • Performance improvements;
    • Enhanced extensibility model;
    • More consistent APIs across the entire cross-platform modules implementation.
  • A completely revamped layout measurement system. Prior to 3.0, the layout system worked with DIP (device-independent pixels). With 3.0, everything is calculated down to DP (device pixels) and you can specify the px suffix to define a 1-px wide border, for example.
  • Migration to TypeScript 2.2 and removed ambient modules in favor of explicit path resolution.


  • We made the following behavioral changes in the Command-line tool:
    • The livesync command is removed in favor of tns run which now automatically performs livesync --watch under the hood;
    • The plugin find/search command is removed as it had zero usage;
    • The emulate command is now deprecated and its functionality has been exposed through the run command and its --emulate option;
    • The run --device <Device Identifier> command now starts an emulator if one is not started already. Prior to 3.0, the --device option worked only with running devices.
  • Numerous bug fixes and internal improvements that ensure better stability and extensibility of the codebase.


  • Network Domain enabled for Chrome DevTools. Now you can monitor your application network traffic directly from within Chrome DevTools. This is currently available for the built-in http module. For third-party modules that do network requests, additional glue code must be implemented to populate the Network Tab.
  • Reverted static binding code generation for Android instead of producing *.DEX files directly. The code generation approach has several major advantages that affect build speed, readability, and maintainability.
  • Updated Gradle build tool. This will speed up the Android builds significantly.
  • Improved debugging experience in Chrome DevTools for Android. We have made several fixes related to crashes and bugs while debugging.

Please note that we decided to wait to release the local snapshot builds feature due to breaking changes in the underlying native build tool chains (i.e. the new Android SDK tools and Xcode 8.3). While the snapshot feature is important for further optimizing the loading time for Android applications, we decided that we shouldn't delay the 3.0 release and will deliver the feature as an incremental update in the near future.

Enabling the New Bits

Besides the standard new npm packages update npm install -g nativescript. If you create a new 3.0 project then all the dependencies will be automatically set to the latest version because the updated 3.0 template will be used. To update an existing project you need to follow these steps:

  1. Update your project's tns-core-modules dependency:
    npm i -S [email protected]
  2. For a NativeScript Angular project update your nativescript-angular plugin, again to 3.0.0:
    npm i -S [email protected]
  3. Since NativeScript 3.0 comes with built-in support for Angular 4, all packages from the @angular scope need to be updated too:
        npm i -S @angular/common@latest @angular/compiler@latest @angular/core@latest @angular/forms@latest @angular/http@latest @angular/platform-browser@latest  @angular/router@latest
        npm i -S zone.js@latest
        npm i -S rxjs@latest
  4. If your project uses TypeScript, you will need to update the nativescript-dev-typescript plugin and it will automatically update your TypeScript configuration:
    npm i -D nativescript-dev-typescript@latest

For a comprehensive list of all the breaking changes and how to migrate existing code you can refer to this wiki page. And if you are a plugin author we have also prepared this document to guide you through the plugin migration steps for 3.0.

WebPack vs. Android Snapshot

For 3.0 we are turning off the snapshot-by-default feature for Android Angular projects. This is primarily done because for Angular projects the major benefit that affects the loading time is the AoT feature (not present in the existing snapshot architecture) that comes enabled through our nativescript-dev-webpack plugin.

WebPack is the recommended way to optimize your NativeScript Angular applications. Once we ship the local snapshot builds then your applications will be able to take advantage of WebPack, AoT, and snapshots for Android simultaneously. More information about enabling WebPack in a NativeScript application may be found in this documentation article.

Share Your Feedback

We have no less than 600 Jenkins jobs that run continuously to ensure the stability and quality of the framework, but no software is flawless :). Please, let us know of any issue that you may hit with the new release so that we can fix it as soon as possible!


Added more information in the "Enabling the New Bits" section about upgrading existing projects to 3.0.