Progress will discontinue Telerik Platform on May 10th, 2018. Learn more

Migration Guide for NativeScript Apps

To export an app compatible with NativeScript CLI, it needs to target NativeScript 2.5.0 or a newer version. If your app targets an older version, you need to migrate it to NativeScript 2.5.0 or newer version. If you migrate your app to NativeScript 3.0.0 or newer version, you need to continue your development in NativeScript CLI by addressing the numerous breaking changes introduced in NativeScript 3.0.0.

To export an app compatible with NativeScript Sidekick, it needs to target NativeScript 3.0.0 or a newer version. If your app targets an older version, you need to migrate it to NativeScript 3.0.0 or newer version. After you export the app, you need to continue your development in NativeScript Sidekick by addressing the numerous breaking changes introduced in NativeScript 3.0.0.

Prerequisites for NativeScript CLI development

  • NativeScript CLI
    To install the NativeScript CLI, you need to use the npm install -g nativescript command. For more information, see the NativeScript CLI Github repository.
  • Properly configured environment
    To build the exported apps with the NativeScript CLI, you need to setup your development environment and install all NativeScript CLI requirements. For more information, see Set Up Your System.
  • macOS system for iOS development
    You need a macOS system to build iOS apps with the NativeScript CLI.

Procedure for Automatic Migration

  1. Log in to Telerik Platform.
  2. (Optional) To migrate an app that contains TypeScript files, you need to complete the following steps:
    1. Open the app in question.
    2. In the Project Navigator, double-click the .abignore file to open it.
    3. Locate and remove the following lines (usually, lines 47 and 49): */**/*.ts and tsconfig.json.
  3. You have two ways to start the export process:
    • In the Apps tab, locate the app you want to migrate and click on the Export to NativeScript CLI button next to it.
    • Inside your app, right-click on your app name (second node from the top in Project Navigator) and select Export to CLI.
  4. When the migration process is complete, an archive containing the migrated project will be automatically saved on your system. Extract the content of the archive to a suitable location.
  5. Open the package.json of the exported app and remove the nativescript-dev-android-snapshot plugin from devDependencies.
  6. Delete .abignore, .abproject and any other *.abproject files.
  7. Install the NativeScript CLI by running the npm install -g nativescript command.
  8. Run the tns build <platform> command to build your app or the tns run <platform> command to build and deploy the app on a connected device. For more information about all available NativeScript CLI commands, see The Commands article.
Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.