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

Run Hybrid Apps Over Cable

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

IDE

To test your app during development, you can build and deploy it on connected devices. When you run your app on a connected device, you can use the devices log to troubleshoot your app.

With AppBuilder, you can deploy on multiple connected devices simultaneously. You can deploy apps on devices running iOS 6.0 and later, Android 4.0 and later, Windows Phone 8.0 or later.

After you have launched a native iOS or Android device emulator (including Genymotion), while the emulator is running, AppBuilder recognizes and treats it as a connected device.

You cannot publish application packages created with the Build, Build and deploy, Build <app_name> in Cloud and Build <app_name> and Deploy operations to Google Play and App Store.

Prerequisites

AppBuilder 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.

Android Prerequisites

  • Verify that your system and the device are configured to work with AppBuilder.
    For more information, see Connect Android Device.
  • If present, verify that the SD card on the device is accessible.

iOS Prerequisites

  • Verify that you have a pair of matching provisioning profile and cryptographic identity.
    For more information, see Code Signing of iOS Apps.
  • Verify that the device is listed in the provisioning profile you want to use for code signing the app.
    For more information, see Code Signing of iOS Apps.
  • Verify that the application identifier matches the App ID in the provisioning profile.
    For more information, see Code Signing of iOS Apps.
  • Verify that your system and the device are configured to work with AppBuilder.
    For more information, see Connect iOS Devices.
  • Verify that the iOS device that you want to use runs on an iOS version equal or greater than the current deployment target.
    For more information about deployment targets, see iOS Properties.

Windows Phone Prerequisites

  • Verify that your system and the device are configured to work with AppBuilder.
    For more information, see Connect Windows Phone Devices.
  • If you want to re-deploy an already deployed Windows Phone 8.1 application, verify that you have updated the Version property in the Properties. Otherwise, your changes will not be updated on the device. For more information, see Configure Your App and General Properties.

Procedure

In-Browser

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

Windows

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.

  1. (Optional) Select a build configuration.
    1. In the Project Navigator, right-click your solution node and select Build Settings.
    2. From the drop-down list, select the build configuration option that you want to enable.
      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.
    3. Click OK.
  2. Connect your devices to your system via USB cable.
  3. In the status bar, click Show Mobile Devices and verify that AppBuilder lists your connected devices.
  4. In the top menu bar, click RunBuild and Deploy.
    • If you are attempting to re-deploy your app on one or more devices, the Build And Deploy dialog appears. You can choose on which devices to deploy the app.
    • If AppBuilder cannot deploy on one or more devices because of configuration issues, the Build And Deploy dialog appears. You can choose whether to continue and deploy on enabled devices or to solve the configuration issues.
  5. Wait for the build and deployment process to complete.
    AppBuilder notifies you when the operation is complete.
  6. (Optional) Click the notification for more details.
    In the status bar, the Log pane opens.
  7. On the connected devices, if the app does not launch automatically, tap the app icon to run it.

If you want to deploy an Apple Watch bundle, you need to complete these additional steps for the watch app to appear on the Apple Watch.

  1. On the iPhone, run the built-in Apple Watch app.
  2. In the My Watch view, locate and tap your newly deployed app.
    The Apple Watch app lists your app with its display name.
  3. Enable Show App on Apple Watch.
  4. Enable Show in Glances.

On the Apple Watch, the watch app will begin to install and the watch app icon will appear after a successful installation.

Visual Studio

When you build for a connected iOS device, the extension for Visual Studio attempts to build your app with an applicable pair of provisioning profile and cryptographic identity for iOS development.

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.

  1. (Optional) To enable or disable LiveSync, from the Solution configurations drop-down menu in the standard toolbar, select the build configuration option that you want to enable.
    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.
  2. Connect your devices to your system via USB cable.
  3. In the top menu bar, click AppBuilderDevices List and verify that AppBuilder lists your connected devices.
  4. In the top menu bar, click AppBuilderBuild <app_name> and Deploy.

    • If you are attempting to re-deploy your app on one or more devices, the Build And Deploy dialog appears. You can choose on which devices to deploy the app.
    • If AppBuilder cannot deploy on one or more devices because of configuration issues, the Build And Deploy dialog appears. You can choose whether to continue and deploy on enabled devices or to solve the configuration issues.

      Android CPU architectures are detected by AppBuilder and selected automatically when running apps on connected devices.

  5. Wait for the build and deployment process to complete.
  6. On the connected devices, if the app does not launch automatically, tap the app icon to run it.

If you want to deploy an Apple Watch bundle, you need to complete these additional steps for the watch app to appear on the Apple Watch.

  1. On the iPhone, run the built-in Apple Watch app.
  2. In the My Watch view, locate and tap your newly deployed app.
    The Apple Watch app lists your app with its display name.
  3. Enable Show App on Apple Watch.
  4. Enable Show in Glances.

On the Apple Watch, the watch app will begin to install and the watch app icon will appear after a successful installation.

CLI

When you build for a connected iOS device, the command-line interface attempts to build your app with an applicable pair of provisioning profile and cryptographic identity for iOS development.

In this version of the command-line interface, you cannot build and deploy your app on connected Windows Phone devices.

  1. Connect your devices to your system via USB cable.
  2. In the command prompt, navigate to the directory that contains your app.
  3. Run the following command to verify that the command-line interface recognizes your connected devices.

    appbuilder device
    
  4. Run the following command.

    appbuilder deploy <platform>
    

    You can set android or ios as the target platform.
    When you build for iOS, you might need to specify the --provision and --certificate parameters.

    • (Optional) To deploy only to a selected device, run the following command.

      appbuilder deploy --device <index or serial number>
      
    • (Optional) To build your app with the Debug or the Release build configuration, run the following command.

      appbuilder deploy <platform> --debug
      
      OR
      
      appbuilder deploy <platform> --release
      
  5. Wait for the build and deployment process to complete.
  6. On the connected devices, if the app does not launch automatically, tap the app icon to run it.

If you want to deploy an Apple Watch bundle, you need to complete these additional steps for the watch app to appear on the Apple Watch.

  1. On the iPhone, run the built-in Apple Watch app.
  2. In the My Watch view, locate and tap your newly deployed app.
    The Apple Watch app lists your app with its display name.
  3. Enable Show App on Apple Watch.
  4. Enable Show in Glances.

On the Apple Watch, the watch app will begin to install and the watch app icon will appear after a successful installation.

Next Steps

Continue development. After modifying your code, refresh or re-deploy your app.

(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.