Install the Unity Ads SDK for iOS
Install the Unity Ads SDK in your iOS project. Add the SDK through CocoaPods or manual integration, and configure your Xcode project as needed.
Read time 1 minuteLast updated 3 days ago
To install Unity Ads, you can use CocoaPods for UnityAds or you can manually install Unity Ads.
CocoaPods
To use CocoaPods for UnityAds:- Add the following line to your project's Podfile:
pod 'UnityAds' - Run the following command:
pod install
Manual installation
To manually install Unity Ads:Note
This integration method requires that you set the Framework Search Paths and Header Search Paths properties in your Build settings.
- Download the Unity Ads framework from the Assets section of your preferred SDK release. It's recommended to download the latest SDK to ensure you have the best available support.
- Drag and drop the Unity Ads framework into your workspace.
Important
Projects that target users running iOS 14 or later must implement Unity Ads' network ID in the information property list file ().
Info.plistSwift
Starting in SDK version 4.4.0, Unity Ads has been optimized by using the Swift programming language.- If your project already uses Swift, then no further action is required.
- If your project does not use Swift, add an empty Swift file to your project in Xcode by selecting File > New > Swift file.
Note
If your project is targeting an iOS version earlier than 12.4, ensure that you set the Always embed Swift standard libraries setting to under the Build settings of your application's target in Xcode.
YESTroubleshooting Swift interoperability errors
The following list details common Swift interoperability issues that could occur during the Unity Ads SDK installation:- Xcode emits many errors.
Undefined symbol_swift_FORCE_LOAD$_- To fix this, add an empty Swift file to your project in Xcode by selecting File > New > Swift file.
- The application crashes after start with the error:
dyld: Library not loaded: @rpath/libswiftCore.dylib- To fix this, ensure that you set Always embed Swift standard libraries to under Build settings for your application's target in Xcode.
YES
- To fix this, ensure that you set Always embed Swift standard libraries to