Build and Distribute Your Android App to Testers

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

IDE

You can build your Android app and distribute it to testers by sending them the application package, the QR code or the download link for your app in the AppBuilder cloud storage. You can choose between building your app with enabled or disabled LiveSync.

When you build your Android app for distribution for testing, you cannot use a self-signed code-signing identity. By default, AppBuilder uses a generic code-signing identity.

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

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 AndroidApp 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. After the build completes, distribute the app.
    • Use an image capturing software to get a copy of the QR code. Send out the QR code to your users.
    • Click Download to download the app package on your local files system. Send out the APK to your users.
    • Click the URL above the QR code and press Ctrl+C to get the download link. Send the URL to your users.

Windows

  1. In the top menu bar, click RunBuild.
  2. Select AndroidApp 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. After the build completes, distribute the app.
    • Use an image capturing software to get a copy of the QR code. Send out the QR code to your users.
    • Click Download to download the app package on your local files system. Send out the APK to your users.
    • Click Copy link to get the download link. Send the URL to your users.

Visual Studio

  1. In the top menu bar, click AppBuilderBuild <app_name> in Cloud.
  2. Select AndroidApp 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. Select the CPU architectures that you want to build against.

    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. After the build completes, distribute the app.
    • Use an image capturing software to get a copy of the QR code. Send out the QR code to your users.
    • Click Download to open the location where the application package is stored on your local file system. Send out the APK to your users.
    • Click Copy link to get the download link to your app. Send out the URL to your users.

CLI

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

    appbuilder build android
    

    (Optional) To disable LiveSync for the application package and build it in the Release build configuration, run the following command instead.

    appbuilder build Android --release
    

    (Optional) To download the application package and distribute it to your users, run the following command.

    appbuilder build Android --release --download
    
  3. After the build completes, distribute the app by sending out the QR code or the APK file.

Next Steps

Build and publish your app to Google Play.

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