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

Apply Build Configurations

Filter by IDE
Select the Progress 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 a Debug or a Release build configuration. When you build your app for distribution from the Publish option, AppBuilder always applies your release configuration and disables the Telerik Mobile Testing plugin.

When you run your app in the device simulator, you can choose which build configuration to apply.

When you run your app in the framework-specific developer apps, you can set the current build configuration from the Build wizard.

You can also set the current build configuration for your app from the Platform companion app. However, to apply the selected configuration, you need to load your app in its framework-specific developer app using the Open Application or Open buttons in the Platform companion app. Note that you need to set the build configuration for each app separately.

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.

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 from the Build operation, set your build configuration to Debug or Release on the first page of the Build wizard.
  • After you have launched your app in the device simulator, set the current build configuration from the configuration drop-down menu, marked with a cogwheel.
  • In the Platform companion app, perform the following steps:
    1. Run the Platform companion app.
    2. Tap My Apps.
    3. If prompted, log in with your Telerik Platform credentials.
    4. Tap the app that you want to run.
    5. Tap Configuration.
    6. Select the configuration that you want to apply to this app.
    7. The next time you want to run your app, make sure to load it in the Cordova developer app using its respective Open or Open Application buttons in the Platform companion app.

Universal

  • When you attempt to build your app from the Build operation, set your build configuration to Debug or Release on the first page of the Build wizard.
  • After you have launched your app in the device simulator, set the current build configuration from the configuration drop-down menu, marked with a cogwheel.
  • In the Platform companion app, perform the following steps:
    1. Run the Platform companion app.
    2. Tap My Apps.
    3. If prompted, log in with your Telerik Platform credentials.
    4. Tap the app that you want to run.
    5. Tap Configuration.
    6. Select the configuration that you want to apply to this app.
    7. The next time you want to run your app, make sure to load it in the Cordova developer app using its respective Open or Open Application buttons in the Platform companion app.

Windows

  • When you attempt to build your app from the Build operation, set your build configuration to Debug or Release on the first page of the Build wizard.
  • Before you attempt to build your app from the Build and Deploy operation or the RunNative Emulators operation, set your build configuration from the Project Navigator.
    1. Right-click the solution node and select Build Settings.
    2. Select the build configuration that you want to use and click Ok.
  • After you have launched your app in the device simulator, set the current build configuration from the configuration drop-down menu, marked with a cogwheel.
  • In the Platform companion app, perform the following steps:
    1. Run the Platform companion app.
    2. Tap My Apps.
    3. If prompted, log in with your Telerik Platform credentials.
    4. Tap the app that you want to run.
    5. Tap Configuration.
    6. Select the configuration that you want to apply to this app.
    7. The next time you want to run your app, make sure to load it in the Cordova developer app using its respective Open or Open Application buttons in the Platform companion app.

Visual Studio

  • When you attempt to build your app from the Build <app_name> in Cloud operation, set your build configuration to Debug or Release on the first page of the Build wizard.
  • Before you attempt to build your app from the Build <app_name> and Deploy operation or the Run Native Emulator operation, set your build configuration from the drop-down menu in the Standard toolbar.
  • After you have launched your app in the device simulator, set the current build configuration from the configuration drop-down menu, marked with a cogwheel.
  • If you have connected your app with the cloud, in the Platform companion app, perform the following steps:
    1. Run the Platform companion app.
    2. Tap My Apps.
    3. If prompted, log in with your Telerik Platform credentials.
    4. Tap the app that you want to run.
    5. Tap Configuration.
    6. Select the configuration that you want to apply to this app.
    7. The next time you want to run your app, make sure to load it in the Cordova developer app using its respective Open or Open Application buttons in the Platform companion app.

CLI

  • When you attempt to build your app from the appbuilder build command, set the --debug or --release switch. You can set these switches even when the --companion switch is specified.
  • When you attempt to build your app from the appbuilder deploy command, set the --debug or --release switch.
  • When you attempt to build your app from the appbuilder emulate command, set the --debug or --release switch.
  • On a Windows system, after you have launched your app in the device simulator, set the current build configuration from the configuration drop-down menu, marked with a cogwheel.
  • On a macOS system, after you have launched your app in the device simulator, select DeviceConfiguration and select the build configuration that you want to apply.

Next Steps

Test your app in the device simulator, in the native emulators or on a physical 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.