Pangle: A global platform dedicated to developer growth.|Integration Docs
Knowledge Center

Integrate Pangle SDK for iOS

NOTICE: If you use Xcode 14 and above to develop your app, please make sure update Pangle iOS SDK to v4.7.0.8 and above, otherwise it will cause some compatibility problems.

This guide is for publishers who only want to monetize an iOS app with the traffic outside of China. If you also want to monetize with the traffic in China Mainland with the same build, please follow the guide How to import both Pangle and CSJ

Environment requirement

  • IOS 10.X and higher;
  • SDK compilation environment Xcode 12;
    • NOTICE: If you use Xcode 14 and above to develop your app, please make sure update Pangle iOS SDK to v4.7.0.8 and above, otherwise it will cause some compatibility problems.
  • Supporting architecture: x86-64, armv7, arm64,i386

Note: ios 9 is no longer supported starting from v3.5.0.0

Import Pangle SDK through CocoaPods(preferred):

The simplest way to import the SDK into an iOS project is to use CocoaPods. Open your project's Podfile and add this line to your app's target:

  • Note: import Pangle SDK that the version is higher v3.4.0.0

 

  • Note: if you want to import old version of Pangle SDK that the version is lower v3.4.0.0, as shown below:

 

Download Pangle SDK Manually:

Download and unzip the SDK framework from Pangle Platform directly, and import the following frameworks and bundles into your Xcode project manually:


  • BUAdSDK.framework
  • BUFoundation.framework
  • BUAdSDK.bundle
  • BUVAAuxiliary.framework
  • BURelyFoundation_Global.framework(v4.3.0.0 added, BURelyFoundation_Global is the underlying basic function library, providing basic functions for Pangle.)
  • PAGAdSDK.framework  (v4.5.0.0 added, providing basic functions for Pangle.)
  • PAGAdSDK.bundle (v4.5.0.0 added, providing basic functions for Pangle.)



destination.png

Note: When you upgrade the SDK, you need to update all frameworks and bundle files.

Please make sure that Copy Bundle Resource contains BUAdSDK.bundle.

bundle.png

Xcode Compiler Option Settings

Add Permissions

Add the parameter -ObjC to Other Linker Flags in build settings, and the SDK before 4.5.0.0 supports - all_ load

Detailed Steps:

permission.png

Add Dependency Libraries

Project needs to find Link Binary With Libraries in TARGETS - > Build Phases, click "+", and then add the following dependent libraries in order.

  • AppTrackingTransparency.framework
  • StoreKit.framework
  • MobileCoreServices.framework
  • WebKit.framework
  • MediaPlayer.framework
  • CoreMedia.framework
  • AVFoundation.framework
  • CoreTelephony.framework
  • SystemConfiguration.framework
  • AdSupport.framework
  • CoreMotion.framework
  • Accelerate.framework
  • libresolv.9.tbd
  • libc++.tbd
  • libz.tbd
  • libsqlite3.tbd
  • libbz2.tbd
  • libxml2.tbd
  • libiconv.tbd
  • libc++abi.tbd (newly required from sdk v3.5.0.0)
  • Security.framework
  • JavaScriptCore.framework
  • AudioToolbox.framework
  • DeviceCheck.framework (newly required from sdk v4.7.0.8)

Note: Add the ImageIO.framework if the above dependency library is still reporting errors.

Detailed Steps:

library.png

Add language configuration

language.png

Advanced topics

The app-ads.txt project is an initiative of the Interactive Advertising Bureau (IAB) that aims to reduce mobile advertising fraud.Developers need to refer to the documentation to configure app-ads.