Build and Distribute Your iOS App to Selected Users

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

IDE

When your app is production-ready and you want to distribute it to selected end users, you can build it with an Ad Hoc or an in-house distribution code-signing identity. A user will be able to run the app on a device only if the device is registered in the Ad Hoc provisioning profile used to build the app.

You can distribute an app that is built with an Ad Hoc or in-house distribution code-signing identity by sending out the application package, the QR code or the download link to your app in the AppBuilder cloud storage. You can enable or disable LiveSync.

If you sign your application with an in-house distribution code-signing identity, you can upload the application to your own web server. For more information about in-house distribution with Apple, see Deploying apps in the Distributing Enterprise Apps for iOS Devices guide.

Prerequisites

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 iOSApp 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. Select a provisioning profile and a matching certificate and click Next.
  6. After the build completes, distribute your 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 file system. Send out the IPA to your users.
    • Click the URL above the QR code and press Ctrl+C to get the download link to your app. Send the URL to your users.

Windows

  1. In the top menu bar, click RunBuild.
  2. Select iOSApp 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. Select a provisioning profile and a matching certificate and click Build.
  6. After the build completes, distribute your 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 file system. Send out the IPA to your users.
    • Click Copy link to get the download link to your app. Send the URL to your users.

Visual Studio

  1. In the top menu bar, click AppBuilderBuild <app_name> in Cloud.
  2. Select iOSApp 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. Select the code signing identity for Ad Hoc distribution or in-house distribution that you want to use and click Build.
  6. After the build completes, distribute your 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 app package is stored on your local file system. Send out the IPA to your users.
    • Click Copy link to get the download link to your app. Send 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 ios --provision "My Provisioning Profile" --certificate "My Certificate"
    

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

    appbuilder build ios --provision "My Provisioning Profile" --certificate "My Certificate" --release
    

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

    appbuilder build ios --provision "My Provisioning Profile" --certificate "My Certificate" --download
    
  3. After the build completes, distribute the app by sending out the QR code or the IPA file.

Next Steps

Build and publish your app to the App Store.

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