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.

Setting up the Mashup SDK for iOS app development

Updated on June 14, 2018

You set up the Mashup SDK in the Xcode development environment to develop native iOS apps that embed one or more screens of a Pega® Platform application as hybrid web views. For example, an existing iOS app that is used for banking purposes might also need to allow its users to dispute credit card transactions by opening a case in a separate Pega Platform application.


You develop the native iOS app that uses the Mashup SDK with the following resources:

  • Swift or Objective-C programming language
  • Xcode 8.3.3

Make sure that you have completed the following tasks:

  • Read the Mashup SDK overview article.
  • Have experience developing iOS apps.
  • Downloaded the Mashup SDK 7.31.x distribution package that contains the following items:
    • Mashup SDK library and additional external libraries
    • Mashup SDK native API documentation
    • A demo application that uses the Mashup SDK

Adding the Mashup SDK to Xcode

To configure the Mashup SDK in an Xcode project, perform the following steps.

  1. Open an Xcode project for an iOS app.
  2. On the General tab, drag the framework that represents a Pega Mashup SDK from the local folder to the Embed Binaries section.
  3. Click Copy items if needed and Create groups, and then click Finish.
  4. On the General tab, make sure that PegaMashupSDK.framework appears in the Linked Frameworks and Libraries section and that the PegaMashupSDK.framework folder is in the project navigator.
  5. On the Build Settings tab, make sure that the Framework Search path points to where Xcode can find the frameworks.
Note: The Mashup SDK package contains three folders: fat, iphoneos, and iphonesimulator, which contain frameworks that are used for different architectures. If you plan to distribute your app in the App Store, use the framework from the iphoneos folder.

Related articles

Pega Mobile SDK 7.4Mashup SDKAuthenticate with the Mashup SDK on iOSUse the SnapStart feature with the Mashup SDK on iOSBest practices for publishing mobile apps in app stores


Pega Platform 7.3.1 Pega Mobile Mashup Mobile Pega Express Communications and Media Consumer Services Financial Services Government Healthcare and Life Sciences Insurance Healthcare and Life Sciences Manufacturing Consumer Services Consumer Services

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