All Products
Search
Document Center

Mobile Platform as a Service:Resolve iOS library conflicts

Last Updated:Jun 08, 2026

The mPaaS SDK may conflict with open source or third-party libraries in your iOS project, causing compilation failures. Resolution depends on whether the conflicting library is an mPaaS custom library.

Resolution depends on the library type:

  • mPaaS custom libraries: Use the mPaaS version.

  • Non-mPaaS custom libraries: Remove the mPaaS version and use your own.

mPaaS custom library conflicts

Use the mPaaS version for the following libraries.

Open source library

mPaaS library

Resolution

AlipaySDK

AlipaySDK

Use the mPaaS version to resolve conflicts with mPaaS RPC and UTDID. Also integrate the mPaaS_RPC component.

OpenSSL

APOpenSSL

Use the mPaaS version, which includes optimized Chinese cryptographic algorithms. How to resolve OpenSSL third-party library conflicts in iOS projects.

protocolBuffers

APProtocolBuffers

Use the mPaaS version.

Non-mPaaS custom library conflicts

For non-custom mPaaS libraries, remove the mPaaS version and use your own. The following table lists removable libraries. Remove conflicting third-party libraries.

remove_pod component

Open source library

mPaaS_SDWebImage

SDWebImage

mPaaS_Masonry

Masonry

mPaaS_MBProgressHud

MBProgressHUD

mPaaS_TTTAttributedLabel

TTTAttributedLabel

mPaaS_Lottie

Lottie

mPaaS_AMap

AMapSearchKit

AMapFoundationKit

MAMapKit

mPaaS_Security

SecurityGuardSGMain

mPaaS_APWebP

WebP

Remove conflicting third-party libraries

To replace a non-custom mPaaS library with your own version:

Procedure

  1. Install the beta version of the cocoapods-mPaaS plug-in.

    Note

    The beta cocoapods-mPaaS plug-in requires baseline 10.2.3.

    sh <(curl -s http://mpaas-ios-test.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

    Run pod mpaas version --plugin to verify the installation.

  2. Update the local baseline: pod mpaas update 10.2.3.

  3. In the Podfile, add remove_pod "mPaaS_xxx" before mPaaS_pod. For example, add remove_pod "mPaaS_SDWebImage" before mPaaS_pod "mPaaS_CommonUI" to remove SDWebImage.

    remove_pod "mPaaS_SDWebImage"
    
    mPaaS_pod "mPaaS_CommonUI"
    
    pod 'xxx' # The corresponding native third-party library
    Important

    If you use the AMapSearch pod, pin the version: pod 'AMapSearch', '9.3.1'.

  4. Run pod install to install your library version.