LiveSync Changes to the Cordova Developer App

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

IDE

You can LiveSync changes between AppBuilder and the Cordova developer app. When you run your app in the Cordova developer app on remote devices, use the three-finger gesture refresh method to initiate LiveSync. When you run your app in the Cordova developer app on a connected device, just save your changes and see them applied on the app on device.

You can determine which files to LiveSync to connected devices. For more information, see Exclude Files From the Application Package.

You cannot LiveSync changes to connected Windows Phone devices. To be able to LiveSync changes, deploy your app via QR code and use the three-finger refresh gesture to get your latest changes from the cloud.

Prerequisites

  • Verify that you have deployed your app in the Cordova developer app.

Procedure

In-Browser

LiveSync Over the Air

When you run your app in the Cordova developer app on remote devices, use the three-finger gesture refresh method to initiate LiveSync.

  1. Verify that you have deployed the app on the device from a QR code.
  2. In the in-browser client, press Ctrl+Shift+S to save all changes.
  3. On the device, run the Cordova developer app, if not running.
  4. Tap and hold with three fingers on the device screen and wait for the download to complete.

If you are running the developer app for Android, you can also LiveSync or reload your app from the notification center. While the developer app is running, toggle the notification center and tap LiveSync to get your latest changes or Scan to run the built-in QR code scanner and reload your app.

LiveSync Over Cable

This operation is not available in the in-browser client. You cannot connect devices in the in-browser client.

Windows

LiveSync Over the Air

When you run your app in the Cordova developer app on remote devices, use the three-finger gesture refresh method to initiate LiveSync.

  1. Verify that you have deployed the app on the device from a QR code.
    If you have not deployed your app via QR code, you will not be able to use the three-finger refresh gesture to sync changes on the device.
  2. In the classic Windows desktop client, press Ctrl+Shift+S to save all changes.
  3. On the device, run Cordova developer app, if not running.
  4. Tap and hold with three fingers on the device screen and wait for the download to complete.

If you are running the developer app for Android, you can also LiveSync or reload your app from the notification center. While the developer app is running, toggle the notification center and tap LiveSync to get your latest changes or Scan to run the built-in QR code scanner and reload your app.

LiveSync Over Cable

When you run your app in the Cordova developer app on a connected device, just save your changes and see them applied on the app on device.

  1. Verify that your device is connected to your system via USB cable.
  2. Verify that Companion app LiveSync is enabled.
    1. Run the classic Windows desktop client, log in and open the code for your app.
    2. In the status bar, click Show Mobile Devices and verify that AppBuilder lists your connected device.
    3. In the Devices pane, select your device and verify that Companion app 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 the Cordova developer app, if not running.
  5. In the classic Windows desktop client, press Ctrl+Shift+S to save all changes.

The Cordova developer app automatically refreshes your app with the latest changes.

IMPORTANT: (Connected devices and the simulator) After any structural changes, such as renaming a file or folder or changing the start page, you need to re-build and re-deploy your app.

Visual Studio

LiveSync Over the Air

When you run your app in the Cordova developer app on remote devices, use the three-finger gesture refresh method to initiate LiveSync.

  1. Verify that you have deployed the app on the device from a QR code.
    If you have not deployed your app via QR code, you will not be able to use the three-finger refresh gesture to sync changes on the device.
  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. On the device, run the Cordova developer app, if not running.
  5. Tap and hold with three fingers on the device screen and wait for the download to complete.

If you are running the developer app for Android, you can also LiveSync or reload your app from the notification center. While the developer app is running, toggle the notification center and tap LiveSync to get your latest changes or Scan to run the built-in QR code scanner and reload your app.

LiveSync Over Cable

When you run your app in the Cordova developer app on a connected device, just save your changes and see them applied on the app on device.

  1. Verify that your device is connected to your system via USB cable.
  2. Verify that Companion app LiveSync is enabled.
    1. Run the extension for Visual Studio, log in and open the code for your app.
    2. Connect your device to your system via USB cable.
    3. In the top menu bar, select AppBuilderDevices List and verify that AppBuilder lists your connected device.
    4. Select your device and verify that Companion app 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 Cordova developer app, if not running.
  5. In Microsoft Visual Studio, press Ctrl+Shift+S to save all changes.

The Cordova developer app automatically refreshes your app with the latest changes.

IMPORTANT: (Connected devices and the simulator) After any structural changes, such as renaming a file or folder or changing the start page, you need to re-build and re-deploy your app.

CLI

LiveSync Over the Air

When you run your app in the Cordova developer app on remote devices, use the three-finger gesture refresh method to initiate LiveSync.

  1. Verify that you have deployed the app on the device from a QR code.
    If you have not deployed your app via QR code, you will not be able to use the three-finger refresh gesture to sync changes on the device.
  2. Save your changes.
  3. In the command prompt, run the following command.

    appbuilder livesync cloud
    

    Wait for the command-line interface to release the console.

  4. On the device, run Cordova developer app, if not running.
  5. Tap and hold with three fingers on the device screen and wait for the download to complete.

If you are running the developer app for Android, you can also LiveSync or reload your app from the notification center. While the developer app is running, toggle the notification center and tap LiveSync to get your latest changes or Scan to run the built-in QR code scanner and reload your app.

LiveSync Over Cable

When you run your app in the Cordova developer app on a connected device, just save your changes and see them applied on the app on device.

  1. Verify that your device is connected to your system via USB cable.
  2. Verify that you have loaded your app in the developer app.
  3. On the device, run Cordova developer app, if not running.
  4. Save your changes.
  5. In the command prompt, run the following command to LiveSync changes to the developer app once.

    appbuilder livesync --companion
    

    The Cordova developer app automatically refreshes your app with the latest changes and the command-line interface releases the console.

  6. In the command prompt, run the following command to enable automatic LiveSync for saved changes.

    appbuilder livesync --companion --watch
    

    The Cordova developer app automatically refreshes your app with the latest changes. The command-line interface does not release the console and on every save pushes your changes to the developer app.

IMPORTANT: (Connected devices and the simulator) After any structural changes, such as renaming a file or folder or changing the start page, you need to re-build and re-deploy your app.

Next Steps

Continue development.

(Optional) If you are running the extension for Visual Studio, you can remove app data from the cloud.

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.