Skip to main content

Table of Contents

Generating installation packages


Only available versions of this content are shown in the dropdown

Convert your application into a mobile app that users can install on their mobile devices. You can generate both Android and iOS apps, which helps you meet the needs of a wide array of mobile users.

Prepare the security components for the installation package:
  1. Open your mobile channel:

    1. In the navigation pane of App Studio, click Channels.

    2. In the Current channel interfaces section, click the tile that represents a mobile channel for your app.

  2. In the mobile preview on the right side of the screen, select the operating system for your app:

    • To generate an iOS app, click the Build iOS app button.
    • To generate an Android app, click the Build Android app button.
    The Build iOS app and Build Android app icons in the mobile preview
    The image shows the highlighted icons in the upper-right corner of the preview
                pane in the mobile channel
    To keep your software up-to-date, rebuild the app after every configuration change. You can follow the status of your app on the icons next to the operating system buttons:
    Check mark
    The build is up-to-date.
    Refresh icon
    The build does not include the latest changes.
    Clock icon
    The build is in progress.
    Warning icon
    The previous build has failed.
  3. In the Certificate set list, select the certificate set for your app.

    If you want to generate an unsigned bundle for iOS that you plan to sign locally later, ensure that you select an unsigned iOS certificate set.
  4. Optional:

    To select which events appear in the log, in the Logging level list, configure the log settings:

    • To turn off logging, select Silent.
    • To receive logs about serious errors, select Error.
    • To receive logs about events that might have negative consequences, select Warning.
    • To receive logs about run-time events, select Info.
    • To receive logs about all events for debugging, select Debug.
    • To receive logs about all available events, such as localization updates, select Verbose.
  5. Optional:

    To enable debugging for Android apps, select the Enable debugging check box.

    Mobile users can update Android apps to newer versions only if both versions have the same debug signing information in the signing certificate. When updating a mobile app, ensure that you select the same debugging option for the new version as the option selected for the current version.
  6. To assign a specific version number to your app, select the Set explicit build version check box, and then enter the exact version and build of the app.

    By default, the first app build is marked as version 0.0.1, and the final number increments by one with every rebuild. By entering an explicit build version, you override this setting.
  7. Click Build app.

After the build process finishes, the panel displays a QR code and a shareable app link that you can use to download your app.
Use the Camera app on your mobile device to scan the QR code and download the app, or download the app with the Share this app link.
  • Configuring mobile build server settings

    Ensure that you properly configure your build server settings before you generate an Android or iOS application package for your mobile app. Incorrect or missing build server credentials disable the option to build an app in the mobile channel.

  • Default security settings for mobile apps

    Pega Platform includes default security mechanisms that help you generate secure mobile apps.

  • Preparing mobile apps for signing

    Before you generate an installation package for your Android or iOS app, you must prepare the app for signing by creating a certificate set. With a complete certificate set, you can build the app and ensure that users can install the app on their devices.

Suggest Edit
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us