CAS.AI iOS Framework

Integrating CAS SDK into an app is the first step toward displaying ads and earning revenue. Once you've integrated and initialized the SDK, you can choose an ad format and follow the steps to implement it.

• Use Xcode 26.0 or higher
• Target minimum iOS 13.0 or higher

Follow these steps to integrate CAS.AI framework with CocoaPods. CocoaPods is a dependency manager for Objective-C and Swift; it automates and simplifies the SDK integration process.

The Podfile is a specification that describes the dependencies of the targets of one or more Xcode projects. You could use a pod init command to create the Podfile with smart defaults.

source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/cleveradssolutions/CAS-Specs.git'

use_frameworks!

Choose an integration path based on your app's target audience. If you're unsure which solution best fits your application, please contact your account manager.

pod 'CleverAdsSolutions-SDK/Optimal', '4.7.4'

• Open Xcode <Project>.xcodeproj
• Go to the Build Settings section for the app target
• Find the OTHER_LDFLAGS property, if customized.
• Make sure the $(inherited) flag is at the beginning of the list.

Open the terminal window and run:

cd into/your/project/folder

Run pod install with repo update:

pod update

Make sure that after Pod installation complete in the terminal, there are no issues that need to be fixed. Repeat the installation after resolving issues.

Make sure to always open the Xcode workspace instead of the project file when building your project:

open <Project>.xcworkspace

The Swift Package Manager is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system, automating the process of downloading, compiling, and linking dependencies.

To add CAS as a package dependency to your Xcode project:

1. Select File > Add Package Dependency

Enter the CAS Git repository URL into the Search or Enter Package URL field:

https://github.com/cleveradssolutions/CAS-iOS

3. Specify the Up to Next Minor version: 4.7.4.

4. Click Add Package.

5. Add each CAS adapter you want to use for monetization to your app target.

6. Open the Build Settings for your app target.

7. Locate the OTHER_LDFLAGS setting.

8. Ensure that $(inherited) and the -ObjC flag are at the beginning of the list.

For projects where you cannot use CocoaPods during Xcode build, you need to manually collect all frameworks from the CAS Pod dependencies and add them to the project. Our script, which can be found in the repository here, will assist you with this process.

Your project Info.plist requires additional configurations that can be performed automatically by a special script.

1. Download the casconfig.rb
2. Place the script in directory with the app .xcodeproj
3. Open the terminal window and run command:

cd into/your/project/folder

5. Run ruby script:

ruby casconfig.rb <CAS_ID>

For more details about the script and its updates, please refer to the the CAS iOS repository.

To display the App Tracking Transparency authorization request for accessing the IDFA, update your Info.plist to add the NSUserTrackingUsageDescription key with a custom message describing your usage. Below is an example description text:

<key>NSUserTrackingUsageDescription</key>
<string>Your data will remain confidential and will only be used to provide you a better and personalised ad experience</string>