SDK 統合手順 v9.x

このページでは、Xcode プロジェクト内に iOS Mobile SDK v9.x を統合する方法と、アプリに広告を表示する方法について説明します。 さまざまな広告の種類を表示する手順については、それぞれの 広告ユニット ページを参照してください。

要件

• この SDK には Xcode バージョン 15.0 以降が必要です。
• アプリは iOS 12.0 以降をターゲットにする必要があります。
• 広告を表示するには、有効な Xandr 配置 ID とメンバー ID が必要です。

インストール

SDK を取得するには、次の 4 つの方法があります。

• CocoaPods
• カルタゴ
• XCFramework
• Swift パッケージ マネージャー

CocoaPods

CocoaPods に慣れていない場合は、ドキュメントを確認 してください。 CocoaPods がインストールされたら、次の手順を実行します。

1. ターミナルまたは任意のコマンド ライン エディターを使用し、プロジェクトのルート ディレクトリに移動し、ポッドファイルを作成します。

   pod init
   

2. テキスト エディターを使用して、新しく作成した podfile を開きます。 プラットフォームのバージョンを 12.0 に設定し、ターゲット podAppNexusSDX'' を追加します。

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

3. 変更を保存してターミナルに戻り、次のように入力します。

   pod install
   

4. CocoaPods は Xandr SDK をダウンロードし、プロジェクト ディレクトリにワークスペース (.xcworkspace) を作成します。 プロジェクトが現在開いている場合は、プロジェクトを閉じて xcworkspace を開きます。

カルタゴ

Carthage に慣れていない場合は、 そのドキュメントを確認してください。 コンピューターに Carthage をインストールしたら、次の手順に従います。

1. ターミナル アプリを開き、プロジェクトのルート ディレクトリに移動します。 Cartfile を作成します。

   touch Cartfile
   

2. Xcode で Cartfile を開いて編集します。

   open -a Xcode Cartfile
   

3. 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"
   
   

   ヒント

   Xcode 以外のエディターを使用して Cartfile を編集できますが、TextEdit などの他の編集プログラムには、直線引用符ではなくスマート引用符が自動的に含まれる場合があることに注意してください。 Carthage はスマートクォート内のコンテンツを認識せず、正しく動作しません。

4. Cartfile を保存します。 次のコマンドを実行して、依存関係を更新します。

   carthage update --use-xcframeworks
   

5. AppNexusSDK SDK を使用するには、AppNexusSDKDynamic.xcframeworkとOMSDK_AppNexus.xcframeworkを [埋め込みバイナリ] セクションに追加します。

   • [ Target → General → Embedded バイナリ] に移動します。
   • +アイコンをクリックし、AppNexusSDKDynamic.xcframeworkとOMSDK_AppNexus.xcframeworkを悲し。

6. アプリケーションに Carthage を使用している場合は、[ 埋め込み & 記号] を選択します。 それ以外の場合 は、[埋め込み不可] を選択します。

XCFramework

CDN から最新の iOS SDK v9.x Azureダウンロードします。 ダウンロードした zip ファイルには、次のフレームワークとリソース バンドルが含まれています。 ニーズに最適な適切なフレームワークを使用していることを確認します。 AppNexusSDK は、一般的な使用に関する推奨事項です。

1. アプリの Xcode プロジェクトまたはワークスペースを開きます。

2. アプリ ターゲットの [全般 ] 構成ページに移動します。

3. AppNexusSDKを使用するには、AppNexusSDK.xcframeworkとANSDKResources.bundleを追加する必要があります。

4. AppNexusSDK.xcframeworkをインポートするには、

   • プロジェクトのターゲット設定に移動します。
   • [ Target>General] に移動します。
   • [フレームワーク]、[ライブラリ]、[埋め込みコンテンツ] セクションの [+] ボタンをクリックします。
   • [ その他の追加] をクリックし、[ ファイルの追加] をクリックします。
   • AppNexusSDK.xcframework ファイルを選択し、[開く] をクリックします。

   

5. ANSDKResources.bundleを含めるには、

   • [Target>Build Phase] に移動します。
   • [ バンドル リソースのコピー ] 行を展開し、[ + ] アイコンをクリックします。
   • ANSDKResources.bundle ファイルを選択し、[開く] をクリックします。

   

Swift パッケージ マネージャー

1. Xcode プロジェクトの [ パッケージの依存関係 ] に移動し、[ + ] ボタンをクリックします。
2. 検索ボックスに URL https://github.com/appnexus/mobile-sdk-ios-spm をコピーして貼り付け、 Enter/Returnキーを押します。
3. [ Mobile-sdk-ios-spm 用パッケージ製品の選択 ] ポップアップ ウィンドウには、さまざまなパッケージ製品が表示されます。 [ AppNexusSDK ] を選択し、[ Add Package] をクリックします。
4. 選択したパッケージが表示され、 Add Package をクリックしてパッケージの依存関係に構成を保存 します。