SDK 統合手順 v9.x

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

要件

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

インストール

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

• CocoaPods
• カルタゴ
• XCFramework
• Swift Package Manager

CocoaPods

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

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

   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 をインストールしたら、次の手順に従います。

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

   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. カートファイルを保存します。 次のコマンドを実行して依存関係を更新します。

   carthage update --use-xcframeworks
   

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

   • [ターゲット ] → [全般 ] → [埋め込みバイナリ] に移動します。
   • + アイコンをクリックして、AppNexusSDKDynamic.xcframeworkとOMSDK_AppNexus.xcframeworkを追加します。

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

XCFramework

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

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

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

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

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

   • プロジェクトのターゲット設定に移動します。
   • [ ターゲット>全般] に移動します。
   • [フレームワーク、ライブラリ、埋め込みコンテンツ] セクションの下にある [+] ボタンをクリックします。
   • [Add Other ]、[Add Files] の順にクリックします。
   • AppNexusSDK.xcframeworkファイルを選択し、[開く] をクリックします。

   

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

   • ターゲット>ビルド フェーズに移動します。
   • [ Copy Bundle Resources ] 行を展開し、 + アイコンをクリックします。
   • ANSDKResources.bundleファイルを選択し、[開く] をクリックします。

   

Swift Package Manager

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