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

LiveSync Changes to Your NativeScript App

Filter by IDE
Select the Progress AppBuilder client you are currently using for development.

IDE

With AppBuilder LiveSync you can make changes to the NativeScript app in the code editor and see those changes in real-time on your device. AppBuilder picks and synchronizes only modified and newly created files.

Prerequisites

  • Verify that your preferred AppBuilder client is running and you are logged in.
  • Verify that your app was built in Debug mode.
  • If you want to LiveSync changes to iOS devices, verify that you have installed the Cordova developer app as well.

Procedure

In-Browser

When you run your app on remote iOS devices, tap and hold with three fingers to LiveSync your saved changes.

When you run your app on remote Android devices, AppBuilder sends you push notifications about updates to your app. You can update your app from the push notification.

  1. Verify that you have deployed your app on the device from a QR code.
  2. In the in-browser client, save all changes.
  3. In your app on an iOS device, tap and hold with three fingers on the device screen and wait for the download to complete.
  4. In your app on an Android device, open the notification area and tap Sync or Scan.

    Option Description
    Sync Gets the latest changes and refreshes the app.
    Scan Toggles the built-in QR code scanner and reloads the app from QR code.

Windows

LiveSync Over the Air

When you run your app on remote iOS devices, tap and hold with three fingers to LiveSync your saved changes.

When you run your app on remote Android devices, AppBuilder sends you push notifications about updates to your app. You can update your app from the push notification.

  1. Verify that you have loaded your app in the developer app from a QR code.
  2. In the classic Windows desktop client, press Ctrl+Shift+S to save all changes.
  3. In your app on an iOS device, tap and hold with three fingers on the device screen and wait for the download to complete.
  4. In your app on an Android device, open the notification area and tap Sync or Scan.

    Option Description
    Sync Gets the latest changes and refreshes the app.
    Scan Toggles the built-in QR code scanner and reloads the app from QR code.

LiveSync Over Cable

When you run your app on connected devices, just save your changes and see them applied to the app on device.

  1. Verify that your device is connected to your system via USB cable.
  2. Verify that Project LiveSync is enabled.
    1. In the status bar, click Show Mobile Devices and verify that AppBuilder lists your connected device.
    2. In the Devices pane, select your device and verify that Project LiveSync is enabled.
  3. In the status bar in the classic Windows desktop client, click Show Output and verify that the classic Windows desktop client has deployed your app files on the connected device.
  4. On the device, run your app, if not running.
  5. In the classic Windows desktop client, press Ctrl+Shift+S to save all changes.

Your app refreshes automatically with the latest changes.

Visual Studio

LiveSync Over the Air

When you run your app on remote iOS devices, tap and hold with three fingers to LiveSync your saved changes.

When you run your app on remote Android devices, AppBuilder sends you push notifications about updates to your app. You can update your app from the push notification.

  1. Verify that you have loaded your app in the developer app from a QR code.
  2. In Microsoft Visual Studio, press Ctrl+Shift+S to save all changes.
  3. If your project is not connected to a cloud app, in the top menu bar, click AppBuilderSynchronize <app_name> with Cloud.
    For more information about how to connect your project with the cloud, see Collaborate Across the Offline and Cloud Tools.
  4. In your app on an iOS device, tap and hold with three fingers on the device screen and wait for the download to complete.
  5. In your app on an Android device, open the notification area and tap Sync or Scan.

    Option Description
    Sync Gets the latest changes and refreshes the app.
    Scan Toggles the built-in QR code scanner and reloads the app from QR code.

LiveSync Over Cable

When you run your app on connected devices, just save your changes and see them applied to the app on device.

  1. Verify that your device is connected to your system via USB cable.
  2. Verify that Project LiveSync is enabled.
    1. In the top menu bar, select AppBuilderDevices List and verify that AppBuilder lists your connected device.
    2. Select your device and verify that Project LiveSync is enabled for the device.
  3. In the Output pane in the AppBuilder output, verify that the extension for Visual Studio has deployed your app files on the connected device.
  4. On the device, run your app, if not running.
  5. In Microsoft Visual Studio, press Ctrl+Shift+S to save all changes.

Your app refreshes automatically with the latest changes.

CLI

LiveSync Over the Air

When you run your app on remote iOS devices, tap and hold with three fingers to LiveSync your saved changes.

When you run your app on remote Android devices, AppBuilder sends you push notifications about updates to your app. You can update your app from the push notification.

  1. Verify that you have loaded your app in the developer app from a QR code.
  2. In the command prompt, navigate to the directory that contains your app files.
  3. Run the following command.

    appbuilder livesync cloud
    
  4. In your app on an iOS device, tap and hold with three fingers on the device screen and wait for the download to complete.
  5. In your app on an Android device, open the notification area and tap Sync or Scan.

    Option Description
    Sync Gets the latest changes and refreshes the app.
    Scan Toggles the built-in QR code scanner and reloads the app from QR code.

LiveSync Over Cable

When you run your app on connected devices, just save your changes and see them applied to the app on device.

  1. Connect your device to your system via USB cable.
  2. In the command prompt, navigate to the directory that contains your app files.
  3. Run the following command to verify that AppBuilder lists your connected device.

    appbuilder device <Platform>
    

    You can set one of the following platforms: ios or android.

  4. Run the following command.

    appbuilder livesync <Platform> --watch
    

    You can set one of the following platforms: ios or android.

  5. On the device, run your app, if not running.
  6. Modify your code and save your changes.

Your app refreshes automatically with the latest changes.

To release the console and continue your work, in the command prompt, press Ctrl+C.

Next Steps

Examine the NativeScript API documentation and continue with your native development.

See Also

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.