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

Build and Distribute Your App with the App Distribution Service

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

IDE

From AppBuilder, you can build and upload your iOS, Android or Windows Phone app to your Telerik Platform private app store.

For apps that target Apache Cordova 3.5.0 or later, you can enable AppManager LiveSync. AppManager LiveSync is a Telerik Platform distribution service that lets you quickly deliver updates and bug fixes to an already published app without the need to re-build and re-submit the application package for review in the app stores. For more information, see Update Your App with Telerik AppManager LiveSync.

Prerequisites

  • Verify that your preferred AppBuilder client is running and you are logged in.
  • Verify that your subscription plan provides private distribution and publishing.
  • Verify that you have configured the cryptographic identities for code signing your app. For more information about code signing, see Code Signing Your App.
  • Verify that you have opened the code for your app in AppBuilder.
  • If you want to distribute a Windows Phone 8.1 app, verify that you have configured your app properly.
    • For Display Name, set a valid string that meets the requirements for App name.
    • For Publisher, set a valid string that meets the requirements for Package/Properties/PublisherDisplayName.
    • For Publisher ID, set a valid GUID.
    • For Windows publisher name, set a valid string that meets the requirements for Package/Identity/Publisher (Publisher attribute).
    • For Package identity name, set a valid string that meets the requirements for Package/Identity/Name (Name attribute).
    • Provide all icons and splash screens.
  • If you want to enable your iOS app for AppManager LiveSync, verify that your app uses the default web view for iOS.
  • If you want to distribute your app for iOS, verify that you have set the correct deployment target.
    For more information about deployment targets, see iOS Properties.

Procedure

In-Browser

  1. In the top menu bar, click Publish and select App Stores.
  2. (Optional) Enable your app for AppManager LiveSync from the AppManager LiveSync toggle.
    For more information about AppManager LiveSync, see Update Your App with Telerik AppManager LiveSync.

    If you cannot see this option, your app does not target Apache Cordova 3.5.0 or later or the AppManager LiveSync service is not available for your subscription. For more information about the available subscriptions, see Telerik Platform Pricing. For more information about your current subscription, visit your account page.

  3. Select Telerik AppManager.
  4. Choose whether you want to publish the app immediately after the upload completes.
    If you do not select this option, after the upload completes, you need to manually navigate to your private app store and complete the publishing process manually.
  5. Select the platform for which you want to build your app.
  6. Click Next.
  7. Select the distribution groups which will have access to your app.
  8. Choose whether you want to sent email and push notifications to the users in the distribution groups.
  9. Choose whether you want to create a private or a public app version.
    Private apps are available only from the Progress AppManager companion app. Public apps are also available to download and install from a download URL.
  10. If prompted, select the code signing identity that you want to use and click Publish.
    AppBuilder lists all code signing identities applicable to the selected mobile platform and the application identifier of the app.
  11. Wait for the operation to complete.
  12. (Optional) Click Open to navigate to your Telerik Platform private app store and complete the publishing process manually.
    For more information about how to publish an app in the App Distribution service, see Publishing an App.

Windows

  1. In the top menu bar, click Publish and select App Stores.
  2. (Optional) Enable your app for AppManager LiveSync from the AppManager LiveSync check box.
    For more information about AppManager LiveSync, see Update Your App with Telerik AppManager LiveSync.

    If you cannot see this option, your app does not target Apache Cordova 3.5.0 or later or the AppManager LiveSync service is not available for your subscription. For more information about the available subscriptions, see Telerik Platform Pricing. For more information about your current subscription, visit your account page.

  3. Select Telerik AppManager.
  4. Choose whether you want to publish the app immediately after the upload completes.
    If you do not select this option, after the upload completes, you need to manually navigate to your private app store and complete the publishing process manually.
  5. Select the platform for which you want to build your app and click Next.
  6. Select the distribution groups which will have access to your app.
  7. Choose whether you want to sent email and push notifications to the users in the distribution groups.
  8. Choose whether you want to create a private or a public app version.
    Private apps are available only from the Progress AppManager companion app. Public apps are also available to download and install from a download URL.
  9. If prompted, select the code signing identity that you want to use and click Build.
    AppBuilder lists all code signing identities applicable to the selected mobile platform and the application identifier of the app.
  10. Wait for the operation to complete.
  11. Click Open to navigate to your Telerik Platform private app store and complete the publishing process manually.
    For more information about how to publish an app in the Telerik Platform, see Publishing an App.

Visual Studio

  1. In the top menu bar, click AppBuilderPublish <app_name>App Stores.
  2. (Optional) Enable your app for AppManager LiveSync from the AppManager LiveSync check box.
    For more information about AppManager LiveSync, see Update Your App with Telerik AppManager LiveSync.

    If you cannot see this option, your app does not target Apache Cordova 3.5.0 or later or the AppManager LiveSync service is not available for your subscription. For more information about the available subscriptions, see Telerik Platform Pricing. For more information about your current subscription, visit your account page.

  3. Select Telerik AppManager.
  4. Choose whether you want to publish the app immediately after the upload completes.
    If you do not select this option, after the upload completes, you need to manually navigate to your private app store and complete the publishing process manually.
  5. Select the platform for which you want to build your app.
  6. Click Next.
  7. Select the distribution groups which will have access to your app.
  8. Choose whether you want to sent email and push notifications to the users in the distribution groups.
  9. Choose whether you want to create a private or a public app version.
    Private apps are available only from the Progress AppManager companion app. Public apps are also available to download and install from a download URL.
  10. If prompted, select the code signing identity that you want to use and click Build.
    AppBuilder lists all code signing identities applicable to the selected mobile platform and the application identifier of the app.
  11. Wait for the operation to complete.
  12. Click Open to navigate to your Telerik Platform private app store and complete the publishing process manually.
    For more information about how to publish an app in the Telerik Platform, see Publishing an App.

CLI

  1. Verify that you are logged in the Telerik Platform.
  2. In the command prompt, navigate to the directory that contains your app.
  3. (Optional) If your app targets Apache Cordova 4.0.0 or later, enable your app for AppManager LiveSync.
    For more information about AppManager LiveSync, see Update Your App with Telerik AppManager LiveSync.

    appbuilder plugin add com.telerik.LivePatch --release
    
  4. To build an Android application package, complete the following steps.

    1. (Optional) Run the following command to list the available certificates for code signing your app.

      appbuilder certificate
      
    2. Run the following command.

      appbuilder appmanager upload android --certificate "My Certificate"
      

      TIP: You can publish your app, make it publicly available via URL and configure email and push notifications from the command line. For more information, run appbuilder appmanager upload android -h

  5. To build an iOS application package, complete the following steps.

    1. (Optional) Run the following command to list the available certificates for code signing your app.

      appbuilder certificate
      
    2. (Optional) Run the following command to list the available provisioning profiles for code signing your app.

      appbuilder provision
      
    3. Run the following command.

      appbuilder appmanager upload ios --certificate "My Certificate" --provision "My Provisioning Profile"
      

      TIP: You can publish your app, make it publicly available via URL and configure email and push notifications from the command line. For more information, run appbuilder appmanager upload ios -h

  6. To build a Windows Phone application package, run the following command.

    appbuilder appmanager upload wp8
    

    TIP: You can publish your app, make it publicly available via URL and configure email and push notifications from the command line. For more information, run appbuilder appmanager upload wp8 -h

  7. If you have not set the --publish flag to publish your app on upload, complete the following steps.
    1. In the browser, navigate to Telerik Platform and log in, if needed.
    2. Open your application package and publish it manually.
      For more information about how to publish an app in the Telerik Platform, see Publishing Your First App in AppManager.

Next Steps

Publish your app manually in Progress AppManager and configure it for distribution.

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.