Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Previewing mobile apps

Updated on February 23, 2022

Before you generate an executable file for your mobile app, verify that the pages and layout correspond with your design, and that the application logic functions in line with your expectations. Use a mobile device with the Pega Mobile Preview app to preview a mobile channel that you configure for an application.

With Pega Mobile Preview, you do not have to obtain certificates or generate executable files before you access the contents of your mobile app.
Before you begin: Prepare for previewing a mobile app:
  • Configure the mobile channel. For more information, see Setting up mobile apps.
  • On your mobile device, download and install Pega Mobile Preview from the App Store or Google Play.

When you develop a mobile app for an application, preview the mobile channel on a mobile device after each change that influences the application. For example, generate a preview after you add a page, change the layout, or modify the flow.

Caution: Do not use Pega Mobile Preview for production purposes.

Pega Mobile Preview shows an approximation of user experience that can help you develop and test your mobile app, until you build an executable file. Pega Mobile Preview does not support certain features, for example, push notifications.

Mobile channels that you add to Pega Mobile Preview expire after 30 days.

  1. In the navigation pane of App Studio, click Channels.
  2. In the Current channel interfaces section, click a tile that corresponds to the mobile channel that you want to modify.
  3. In the upper-right corner of the mobile channel configuration page, click the Pega mobile preview icon.
    The Pega mobile preview icon in the mobile channel configuration page
    The image shows the highlighted icon in the upper-right corner of the mobile channel configuration page
    Result: The Preview your application pane with a QR code appears.
  4. On your mobile device, open Pega Mobile Preview, and then tap Start configuring.
  5. On the channel definition screen, add your mobile channel to the list of available mobile channels:
    Scan the QR codeTap Scan the QR code, point the camera to the QR code on the Preview your application pane, and then wait for the reader to recognize the code.
    Enter the URL of the mobile channel
    1. In App Studio, on the mobile channel configuration page, in the Preview your application pane, click Email me instructions.
      Result: An e-mail message opens in your default e-mail client.
    2. With your default e-mail client, send the e-mail message to a mailbox that you can access from your mobile device.
    3. On your mobile device, open the message, and then copy the URL of the mobile channel.
    4. In Pega Mobile Preview, tap Enter URL manually, and then paste the mobile channel address.
    In the Active list, you can add more channels to by tapping the Add icon, or remove channels by swiping them left or right.
  6. In the Active list, tap the channel that you want to access.
  7. On the authentication screen, log in to the channel.
  8. Test the mobile channel to ensure that the layout and functionality of the mobile app meet the requirements.
  9. Optional: To update the mobile channel after you modify the mobile app in Pega Platform, refresh the channel:
    Refresh the current screen
    1. Swipe down the contents of the screen.
    Refresh the mobile channel
    1. On any screen of the current mobile channel, tap the Back icon.
    2. In the Active list, tap the name of the mobile channel.

    Have a question? Get answers now.

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

    Did you find this content helpful?

    Want to help us improve this content?

    We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

    Close Deprecation Notice
    Contact us