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

Build and Distribute Your Windows Phone App to Testers

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

IDE

You can build your Windows Phone app and distribute it to testers by sending them the QR code or the download link.

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.
  • Verify that your users have installed the Telerik Application Enrollment Token (Telerik AET) on their 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

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 Windows PhoneApp 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, send out the QR code or the download URL for your app to your users.
  6. (Optional) Send out the QR code or the download URL for the Telerik AET to your users.

Windows

  1. In the top menu bar, click RunBuild.
  2. Select Windows PhoneApp 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, send out the QR code or the download URL for your app to your users.
  6. (Optional) Send out the QR code or the download URL for the Telerik AET to your users.

Visual Studio

  1. In the top menu bar, click AppBuilderBuild <app_name> in Cloud.
  2. Select Windows PhoneApp 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, send out the QR code or the download URL for your app to your users.
  6. (Optional) Send out the QR code or the download URL for the Telerik AET to your users.
  7. 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.

CLI

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

    appbuilder build wp8
    
    • (Optional) To build your app with the Debug or the Release build configuration, run the following command.
    appbuilder build wp8 --debug
    
    OR
    appbuilder build wp8 --release
    

    (Optional) To download the application package, run the following command instead.
    This operation also downloads the final manifest file (WMAppManifest.xml) for the application package.

    appbuilder build wp8 --download
    

    When the --download switch is set, the command-line interface does not provide a QR code for installing the app and automatically downloads the XAP on your local file system. Your users need to manually deploy your app on their devices using the Application Deployment tool from the Windows Phone 8.0 SDK or the Windows Phone 8.1 SDK. For more information how to deploy an app with the Application Deployment tool, see How to deploy and run a Windows Phone app.

  1. After the build completes, send out the QR code, the download URL or the XAP for your app to your users.

    IMPORTANT: The application packages available via QR code or download URL are signed packages. Your users need to download and install the Telerik Application Enrollment Token on their devices before they can run your app.

Next Steps

Build and publish your app to the Windows Phone 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.