SDK integration instructions v9.x

This page describes how to integrate iOS Mobile SDK v9.x within your Xcode project, as well as how to display ads in your app. For instructions on displaying different ad types, see respective Ad Unit pages.

Requirements

• This SDK requires Xcode version 15.0 or higher.
• Your app should target iOS 12.0 or higher.
• In order to show ads, you must have a valid Xandr placement ID and member ID.

Installation

There are four ways to get our SDK:

• CocoaPods
• Carthage
• XCFramework
• Swift Package Manager

CocoaPods

If you are unfamiliar with CocoaPods review their documentation. Once you have CocoaPods installed:

1. Use Terminal or your command line editor of choice, navigate to the root directory of your project and create a podfile.

   pod init
   

2. Using a text editor, open the newly created podfile. Set the platform version to 12.0 and add podAppNexusSDX`` to the target.

   # iOS: Podfile config to include our SDK
   platform :ios, '12.0'
   project 'FunBanner'
   target 'FunBanner' do
     pod 'AppNexusSDK'
   end
   
   

3. Save your changes and return to the Terminal and enter:

   pod install
   

4. CocoaPods downloads the Xandr SDK and creates a workspace (.xcworkspace) in the project directory. If your project is currently open, close it and open the xcworkspace.

Carthage

If you are unfamiliar with Carthage review their documentation. Once you've installed Carthage on your computer, follow these steps:

1. Open the Terminal app and navigate to the root directory of your project. Create a Cartfile.

   touch Cartfile
   

2. Open the Cartfile in Xcode to edit it.

   open -a Xcode Cartfile
   

3. Add the following lines to the Cartfile.

   # iOS: Carthage config to include our SDK
   binary "https://adsdkprod.azureedge.net/mobile/ios/releases/carthage/AppNexusSDK.json"
   binary "https://adsdkprod.azureedge.net/mobile/ios/releases/carthage/OMSDK_Microsoft.json"
   
   

   Tip

   You can use editor's other than Xcode to edit the Cartfile but be aware that other editing programs such as TextEdit might automatically include smart quotes instead of straight quotes. Carthage does not recognize content within smart quotes and not perform correctly.

4. Save the Cartfile. Run the following command to update dependencies:

   carthage update --use-xcframeworks
   

5. To use AppNexusSDK SDK, add the AppNexusSDKDynamic.xcframework and OMSDK_AppNexus.xcframework to the Embedded Binaries section:

   • Navigate to Target → General → Embedded Binaries.
   • Click the + icon and sadd the AppNexusSDKDynamic.xcframework and OMSDK_AppNexus.xcframework.

6. If you are using Carthage for an application, select Embed & Sign. Otherwise select Do Not Embed.

XCFramework

Download the latest iOS SDK v9.x from Azure CDN. The downloaded zip file contains the following frameworks and resources bundle. Ensure that you are using the appropriate framework that best suits your needs. The AppNexusSDK is the recommendation for general use.

1. Open the app’s Xcode project or workspace.

2. Go to the app target’s General configuration page.

3. To use the AppNexusSDK, you need to add the AppNexusSDK.xcframework and ANSDKResources.bundle.

4. To import the AppNexusSDK.xcframework,

   • Navigate to your project's Target settings.
   • Navigate to Target > General.
   • Click the + button under the Frameworks, Libraries, and Embedded Content section.
   • Click Add Other and then Add Files.
   • Choose the AppNexusSDK.xcframework file and click Open.

   

5. To include the ANSDKResources.bundle,

   • Navigate to Target > Build Phase.
   • Expand the Copy Bundle Resources row and click the + icon.
   • Choose the ANSDKResources.bundle file and click Open.

   

Swift Package Manager

1. Go to Package Dependencies under your Xcode project and click on the + button.
2. Copy and paste the URL https://github.com/appnexus/mobile-sdk-ios-spm in the search box and press Enter/Return.
3. In Choose Package Products for mobile-sdk-ios-spm pop up window, different package products will be present. Select AppNexusSDK and click Add Package.
4. The selected package will be displayed and click on Add Package to save the configuration in Package Dependencies.