Enable or Disable LiveSync for the Application Package

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

IDE

When you build your app for testing, you can choose to build the application package with enabled or disabled LiveSync.

When you build your app in debug mode, you can LiveSync changes to your app without re-deploying it on device. When you build your app in release mode, LiveSync is disabled.

By default, when you build your app with the Build, Build <app_name> in Cloud, Build and deploy or Build <app_name> and Deploy operation, debug mode is enabled. When you build your app with the Publish operation, release mode is always enabled and you cannot disable it.

When you disable LiveSync in the application package, you cannot enable it for connected devices with the Project LiveSync option.

Prerequisites

  • Verify that your preferred AppBuilder client is running and you are logged in.
  • Verify that you have opened the code for your app in AppBuilder.

Procedure

In-Browser

  • When you attempt to build your app, set your build configuration to Debug or Release on the first page of the Build wizard.

    Option Description
    Debug
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.debug.* files in your application package, removes the debug modifiers from the file names and renames them to *.*.
    • If applicable to the AppBuilder client, applies any additional exclude or include rules defined in .debug.abignore.
    • Enables LiveSync. Users can receive the latest changes to your app by tapping and holding with three fingers on their device screens. LiveSync might not be available for some changes and users might need to reinstall the updated and rebuilt package.
      Enabling LiveSync enables the INTERNET Android permission.
      When LiveSync is enabled, you can use the LiveSync JavaScript API to work with LiveSync programmatically.
    • Enables debugging for the app, if applicable to the selected mobile platform.
    Release
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.release.* files in your application package, removes the release modifiers from the file names and renames them to *.*.
    • If applicable to the AppBuilder client, applies any additional exclude or include rules defined in .release.abignore.
    • Disables LiveSync. Users cannot receive the latest changes to your app by tapping and holding with three fingers on their device screens and users need to reinstall the updated and rebuilt package.
      Disables the INTERNET Android permission, if you have not manually enabled it. This might cause your app to stop working as expected.
    • Disables debugging for the app, if applicable to the selected mobile platform.

Windows

  • When you attempt to build your app, set your build configuration to Debug or Release on the first page of the Build wizard.

    Option Description
    Debug
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.debug.* files in your application package, removes the debug modifiers from the file names and renames them to *.*.
    • If applicable to the AppBuilder client, applies any additional exclude or include rules defined in .debug.abignore.
    • Enables LiveSync. Users can receive the latest changes to your app by tapping and holding with three fingers on their device screens. LiveSync might not be available for some changes and users might need to reinstall the updated and rebuilt package.
      Enabling LiveSync enables the INTERNET Android permission.
      When LiveSync is enabled, you can use the LiveSync JavaScript API to work with LiveSync programmatically.
    • Enables debugging for the app, if applicable to the selected mobile platform.
    Release
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.release.* files in your application package, removes the release modifiers from the file names and renames them to *.*.
    • If applicable to the AppBuilder client, applies any additional exclude or include rules defined in .release.abignore.
    • Disables LiveSync. Users cannot receive the latest changes to your app by tapping and holding with three fingers on their device screens and users need to reinstall the updated and rebuilt package.
      Disables the INTERNET Android permission, if you have not manually enabled it. This might cause your app to stop working as expected.
    • Disables debugging for the app, if applicable to the selected mobile platform.

Visual Studio

  • When you attempt to build your app, set your build configuration to Debug or Release on the first page of the Build wizard.

    Option Description
    Debug
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.debug.* files in your application package, removes the debug modifiers from the file names and renames them to *.*.
    • If applicable to the AppBuilder client, applies any additional exclude or include rules defined in .debug.abignore.
    • Enables LiveSync. Users can receive the latest changes to your app by tapping and holding with three fingers on their device screens. LiveSync might not be available for some changes and users might need to reinstall the updated and rebuilt package.
      Enabling LiveSync enables the INTERNET Android permission.
      When LiveSync is enabled, you can use the LiveSync JavaScript API to work with LiveSync programmatically.
    • Enables debugging for the app, if applicable to the selected mobile platform.
    Release
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.release.* files in your application package, removes the release modifiers from the file names and renames them to *.*.
    • If applicable to the AppBuilder client, applies any additional exclude or include rules defined in .release.abignore.
    • Disables LiveSync. Users cannot receive the latest changes to your app by tapping and holding with three fingers on their device screens and users need to reinstall the updated and rebuilt package.
      Disables the INTERNET Android permission, if you have not manually enabled it. This might cause your app to stop working as expected.
    • Disables debugging for the app, if applicable to the selected mobile platform.

CLI

  • By default, LiveSync is enabled for the application package. To disable it, run your build commands with the --release switch.

    Option Description
    Debug
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.debug.* files in your application package, removes the debug modifiers from the file names and renames them to *.*.
    • If applicable to the AppBuilder client, applies any additional exclude or include rules defined in .debug.abignore.
    • Enables LiveSync. Users can receive the latest changes to your app by tapping and holding with three fingers on their device screens. LiveSync might not be available for some changes and users might need to reinstall the updated and rebuilt package.
      Enabling LiveSync enables the INTERNET Android permission.
      When LiveSync is enabled, you can use the LiveSync JavaScript API to work with LiveSync programmatically.
    • Enables debugging for the app, if applicable to the selected mobile platform.
    Release
    • Adds the plugins that you have enabled for this configuration and sets their plugin variables with the correct values.
    • Includes any *.release.* files in your application package, removes the release modifiers from the file names and renames them to *.*.
    • If applicable to the AppBuilder client, applies any additional exclude or include rules defined in .release.abignore.
    • Disables LiveSync. Users cannot receive the latest changes to your app by tapping and holding with three fingers on their device screens and users need to reinstall the updated and rebuilt package.
      Disables the INTERNET Android permission, if you have not manually enabled it. This might cause your app to stop working as expected.
    • Disables debugging for the app, if applicable to the selected mobile platform.

Next Steps

Run your app on device.

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.