Skip to content

Include iOS

Denis edited this page Oct 4, 2021 · 21 revisions

⚡ Before you start
Make sure you have correctly setup project settings.


The Clever Ads Solutions Unity plugin is distributed with the EDM4U library. This library is intended for use by any Unity plugin that requires access to iOS CocoaPods. It provides Unity plugins the ability to declare dependencies, which are then automatically resolved and copied into your Unity project.

Install Cocoapods

Make sure that Cocoapods is installed.
In the Unity editor, select: Assets > External Dependency Manager > iOS Resolver > Install Cocoapods

An xcworkspace is generated that includes the required dependency libraries.
⚠️ Use the generated .xcworkspace instead of the standard Xcode project.

🌟 iOS dependencies are identified using CocoaPods. CocoaPods is run as a post build process step.

Link frameworks statically

In the Unity editor, open Assets > External Dependency Manager > iOS Resolver > Settings menu.

  • Add use_frameworks!
  • Link frameworks statically

The Unity External Dependency Manager will add use_frameworks! :linkage => :static to your Podfile.
Failing to do this step may result in undefined behavior of the plugin.

Mute Other Audio Sources

Known issue when the sounds is disabled in the application after closing advertising with enabled "Mute Other Audio Sources" option.
Please turn off the option in menu:
Edit > Project Settings > Player > iOS > Other Settings > Mute Other Audio Source.
We will continue to look for ways to solve the conflict.

Track Location Enabled

The SDK are not collects location data automatically if the user allowed the app to track the location.
Check mark Track Location Enabled in Assets > CleverAdsSolutions > iOS Settings window to collects location data by default.
Or change the flag at any time using the following method:

CAS.MobileAds.settings.trackLocationEnabled = true;

App Pause On Background

Indicates if the Unity app should be automatically paused when a full screen ad (Interstitial or Rewarded video ad) is displayed.
Enabled by default.
Change the flag at any time using the following method:

CAS.MobileAds.settings.iOSAppPauseOnBackground = false;

Optional permissions

In iOS 10, Apple has extended the scope of its privacy controls by restricting access to features like the camera, photo library, etc. In order to unlock rich, immersive experiences in the SDK that take advantage of these services, please add the following entry to your apps plist:

<key>NSPhotoLibraryUsageDescription</key>
<string>Some ad content may require access to the photo library.</string>
<key>NSCameraUsageDescription</key>
<string>Some ad content may access camera to take picture.</string>
<key>NSMotionUsageDescription</key>
<string>Some ad content may require access to accelerometer for interactive ad experience.</string>

You can also use the settings provided by the Unity Player Settings > Other Settings > Usage Description.


What’s Next?