Run Apps Over the Air

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 share it with physical devices that are not connected to your system. On such remote devices, you can deploy your app from a QR code, from an URL or you can install the app package manually.

To let other users test your app, you can share the QR code, the URL or the app package.

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

  • If you want to run your app on an Android device, verify that installing apps from unknown sources is enabled.
    On the device, open SettingsApplications and enable Unknown sources.
  • If you want to deploy from QR code, verify that a QR code reader is installed on the device.

iOS Prerequisites

  • If you want to run your app on an iOS device, verify that you have a pair of matching provisioning profile and cryptographic identity.
    For more information, see Code Signing of iOS Apps.
  • If you want to run your app on an iOS device, verify that the device is listed in the provisioning profile that you want to use for code signing the app.
    For more information, see Code Signing of iOS Apps.
  • If you want to run your app on an iOS device, verify that the application identifier matches the App ID in the provisioning profile.
    For more information, see Code Signing of iOS Apps.
  • If you want to download and install your iOS app manually, verify that you have installed iTunes on your system.
  • If you want to deploy from QR code, verify that a QR code reader is installed on the device.
  • 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 the Telerik Application Enrollment Token (Telerik AET) is installed on the device. If the Telerik AET is not installed on the device, you can install it from the QR code provided during the build process.
  • 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

AppBuilder produces the QR codes and the download URLs to your built content per build. Your shared QR codes or URLs provide access to a particular build and have a limited life.

In-Browser

  1. In the top menu bar, click RunBuild.
  2. Select a target platform and select App Package.
  3. (Optional) Select the build configuration that you want to apply.
    By default, Debug is selected.
    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.
  4. Click Next.
  5. If you have selected to build an application package for iOS, select the provisioning profile and certificate that you want to use for code signing your app and click Next.
    AppBuilder lists provisioning profiles for development and Ad Hoc distribution only.
  6. After the build completes, deploy the app.
    • On a physical device, use a QR code scanner to scan the QR code and install the application.
      You can deploy your app from QR code, only if you selected to build an application package for Android or Windows Phone or an application package for iOS using an Ad Hoc provisioning profile.
    • Click Download to download the app package and install it manually on a physical device.
      You can download and install your app manually, if you selected to build an Android app, an iOS app with an Ad Hoc provisioning profile or an iOS app with an iOS development provisioning profile. You cannot download the application package, if you selected to build a Windows Phone app.
    • Click the URL above the QR code and press Ctrl+C to get the link for your app. On a physical device, use a browser to open the link and confirm the installation.
      You can download and install your app from the link, if you selected to build an application package for Android or Windows Phone or an application package for iOS using an Ad Hoc provisioning profile.

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.

Windows

  1. In the top menu bar, click RunBuild.
  2. Select a target platform and select App Package.
  3. (Optional) Select the build configuration that you want to apply.
    By default, Debug is selected.
    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.
  4. Click Next.
  5. If you have selected to build an application package for iOS, select the provisioning profile and certificate that you want to use for code signing your app and click Build.
    AppBuilder lists provisioning profiles for development and Ad Hoc distribution only.
  6. After the build completes, deploy the app.
    • On a physical device, use a QR code scanner to scan the QR code and install the application.
      You can deploy your app from QR code, only if you selected to build an application package for Android or Windows Phone or an application package for iOS using an Ad Hoc provisioning profile.
    • Click Download to download the app package and install it manually on a physical device.
      You can download and install your app manually, if you selected to build an Android app, an iOS app with an Ad Hoc provisioning profile or an iOS app with an iOS development provisioning profile. You cannot download the application package, if you selected to build a Windows Phone app.
    • Click Copy link to get the link for your app. On a physical device, use a browser to open the link and confirm the installation.
      You can download and install your app from the link, if you selected to build an application package for Android or Windows Phone or an application package for iOS using an Ad Hoc provisioning profile.

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

  1. In the top menu bar, click AppBuilderBuild <app_name> in Cloud.
  2. Select a target platform and select App Package.
  3. (Optional) Select the build configuration that you want to apply.
    By default, Debug is selected.
    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.
  4. (Android only) Select CPU architecture.

    Option Description Additional Comments
    armV7 Supported Instruction Sets:
    • armeabi
    • Thumb-2
    • VFPv3-D16
    • Other, optional
    This architecture is used by most of the devices and ARM native emulators. ARM emulators are significantly slower than x86 emulators.
    x86 Supported Instruction Sets:
    • x86 (IA-32)
    • MMX
    • SSE/2/3
    • SSSE3
    This architecture is used by most of the native emulators, all GenyMotion emulators and some devices.
    Both This option produces a combination of APK files built against the armV7 and x86 CPU architectures.
    Supported Instruction Sets:
    • armeabi
    • Thumb-2
    • VFPv3-D16
    • Other, optional
    • x86 (IA-32)
    • MMX
    • SSE/2/3
    • SSSE3
    None
  5. Click Next.
  6. If you have selected to build an application package for iOS, from the Provision drop-down menu, select the provisioning profile that you want to use for code signing your app and click Build.
    AppBuilder lists provisioning profiles for iOS development and Ad Hoc distribution only.
  7. Deploy the app.
    • On a physical device, use a QR code scanner to scan the QR code and install the application.
      You can deploy your app from QR code, only if you selected to build an application package for Android or Windows Phone or an application package for iOS using an Ad Hoc provisioning profile.
    • Click Download to download the app package and install it manually on a physical device.
      You can download and install your app manually, if you selected to build an Android app, an iOS app with an Ad Hoc provisioning profile or an iOS app with an iOS development provisioning profile.
      When you click Download, Windows Explorer opens the folder where the application package is stored on your disk during the build process.
      You cannot download the application package, if you selected to build a Windows Phone app.
    • Click Copy link to get the link for your app. On a physical device, use a browser to open the link and confirm the installation.
      You can download and install your app from the link, if you selected to build an application package for Android or Windows Phone or an application package for iOS using an Ad Hoc provisioning profile.
  8. If you need an unsigned application package for Windows Phone, on your local file system, go to the bin folder in your project and use the XAP file stored there.

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

  1. In the command prompt, navigate to the directory that contains your app.
  2. Run the following command.

    appbuilder build <platform>
    

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

    • (Optional) To build your app with the Debug or the Release build configuration, run the following command.

      appbuilder build <platform> --debug
      
      OR
      
      appbuilder build <platform> --release
      
    • (Optional) To download the application package after the build completes, run the following command.
      This operation also downloads the final manifest file for the application package.

      appbuilder build <platform> --download
      

      When you build for Windows Phone, do not set the --download switch.

  1. Wait for the build to complete.
    After the build completes, AppBuilder opens a new window in the browser and shows the QR code for installing your app.
  2. Deploy the app.
    • On a physical device, use a QR code scanner to scan the QR code and install the application.
      You can deploy your app from QR code, only if you selected to build an application package for Android or Windows Phone or an application package for iOS using an Ad Hoc provisioning profile.
    • If you have set the --download switch, AppBuilder automatically downloads the application package on your system and prints the download location.

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.