MoEngage Docs

SDK Integration

How to integrate iOS SDK into your app


There are two ways you can integrate the SDK - CocoaPods or Manual integration. We recommend CocoaPods.


  • The current SDK supports iOS8 and above

  • Refer to sample project for queries regarding integration of MoEngage iOS SDK

  • For complete API reference of the SDK, refer to the docs in this link

Integration through CocoaPods

Cocoapods is a dependency manager for Objective C & Swift projects and makes integration easier.

  1. If you don't have cocoapods installed, you can do it by executing the following line in your terminal.
sudo gem install cocoapods
  1. If you don't have a Podfile, then create one by using pod init command. Post this add MoEngage-iOS-SDK pod to your pod file as shown below:
pod 'MoEngage-iOS-SDK','~> 5.0'
  1. Integrate MoEngage iOS SDK by executing the following in the terminal at your project's root directory:
pod repo update
pod install
  1. Now, open your project workspace and check if MoEngage SDK is properly added.

Manual Integration

To install manually, follow the steps below:

  1. Download the latest sdk from the following link.

  2. Add the MoEngage.framework file to your project.

  3. Add MoEngage framework to Embedded Binaries

  4. Do this if not already done: Select App Target and go to Build Phase and add a Run Script step to your build steps, set it to use /bin/sh and enter the following script:


# This script loops through the frameworks embedded in the application and
# removes unused architectures.
find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK
    FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)
    echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"


    for ARCH in $ARCHS
        echo "Extracting $ARCH from $FRAMEWORK_EXECUTABLE_NAME"

    echo "Merging extracted architectures: ${ARCHS}"
    lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}"
    rm "${EXTRACTED_ARCHS[@]}"

    echo "Replacing original executable with thinned version"


This script is for removing unsupported architectures while exporting the build OR submitting app to app store.

Updated about a month ago

What's Next

Awesome, you are all set to use MoEngage now. Next we will see how to initialize MoEngage SDK and changes that are to be made to your AppDelegate file.

AppDelegate Changes

SDK Integration

How to integrate iOS SDK into your app

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.