Skip to main content

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

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Previewing mobile apps

Updated on November 9, 2021

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 Apple 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.
    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.
  • Setting up mobile apps

    Create a mobile channel to configure, customize, and generate your mobile app. For example, you can set up a mobile channel for an expense reporting application, to build a mobile app that supports users who work away from their desks.

  • Adding content to mobile apps

    Enhance the content of your mobile app by managing the out-of-the-box user interface pages or adding custom ones. For example, you can create a native page with a list of pending expense reports that managers can process. You can further improve the user experience in your mobile app by implementing native components, such as mobile search or a floating action button.

  • Enhancing mobile apps

    Increase the usability and improve the user engagement of your mobile app by enabling and implementing features that ensure a modern mobile experience. You can customize your mobile app and tailor it to both your business needs, and the needs of the users.

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