Adobe Experience Platform Mobile SDK のインストール tutorial_install_mobile_sdks

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

CocoaPodsとPod ファイル（SDKのインストール手順の生成で説明）を使用する代わりに、Xcodeのネイティブ Swift パッケージマネージャーを使用して個々のパッケージを追加します。 Xcode プロジェクトには、すべてのパッケージの依存関係が既に追加されています。 Xcode パッケージ依存関係​の画面は次のようになります。

{modal="regular"}

Xcodeでは、ファイル > パッケージを追加…​を使用してパッケージを追加できます。 次の表は、パッケージの追加に使用するURLへのリンクを示しています。 また、各パッケージに関する詳細情報も記載されています。

拡張機能をインポート

サンプルアプリの​Start フォルダーでプロジェクトをXcodeで開きます。

Xcodeで、Luma > Luma > AppDelegate​に移動し、次のインポートがこのソースファイルに含まれていることを確認します。

// import AEP MobileSDK libraries
import AEPCore
import AEPServices
import AEPIdentity
import AEPSignal
import AEPLifecycle
import AEPEdge
import AEPEdgeIdentity
import AEPEdgeConsent
import AEPUserProfile
import AEPPlaces
import AEPMessaging
import AEPOptimize
import AEPAssurance

Luma > Luma > Utils > MobileSDK​に対して同じことを行います。

AppDelegateを更新

Xcode プロジェクトナビゲーターで​Luma > Luma > AppDelegate​に移動します。

1. environmentFileIdの@AppStorage値YOUR_ENVIRONMENT_ID_GOES_HEREを、Generate SDK install instructionsのタグから取得したEnvironment File ID値に置き換えます。

   code language-swift
   @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. 次のコードをapplication(_, didFinishLaunchingWithOptions)関数に追加します。

   code language-swift

   // Define extensions let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ] // Register extensions MobileCore.registerExtensions(extensions, { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Logger.aepMobileSDK.info("Luma - using mobile config: \(self.environmentFileId)") MobileCore.configureWith(appId: self.environmentFileId) // set this to false or comment it when deploying to TestFlight (default is false), // set this to true when testing on your device. MobileCore.updateConfigurationWith(configDict: ["messaging.useSandbox": true]) if appState != .background { // only start lifecycle if the application is not in the background MobileCore.lifecycleStart(additionalContextData: nil) } // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(.unknown) })

上記のコードでは、次の操作を行います。

1. 必要な拡張機能を登録します。
2. タグプロパティ設定を使用するようにMobileCoreおよびその他の拡張機能を設定します。
3. デバッグログを有効にします。 詳細とオプションについては、Adobe Experience Platform Mobile SDK ドキュメント ​を参照してください。
4. ライフサイクル監視を開始します。 詳しくは、チュートリアルの​ ライフサイクル ​ ステップを参照してください。
5. デフォルトの同意を不明に設定します。 詳しくは、チュートリアルの「同意 ステップ」を参照してください。

ビルド中のタグ環境（開発、ステージング、実稼動環境）から、environmentFileIdに基づくappIdを使用してMobileCore.configureWith(appId: self.environmentFileId)を更新してください。

Gradle

Generate SDKのインストール手順の依存関係を使用して、GradleとAndroid Studioの統合を使用して個々のパッケージを追加します。Android Studio プロジェクトには、すべてのパッケージの依存関係が既に追加されています。

1. ツールとして を選択します。

2. Android ビューを選択します。

3. 左側のペインから​Gradle scripts > build.gradle.kts （モジュール :app）​を選択します。 次に、右側のペインで、dependenciesが表示されるまでスクロールします。

   {modal="regular"}

Android Studioでは、ファイル > プロジェクト構造…​を使用して、モジュールの依存関係を追加できます。 依存関係​を選択し、モジュール を使用してモジュールを追加します。 以下の表は、依存関係モジュールの追加に使用するURLへのリンクを示しています。 また、各モジュールに関する詳細な情報も表示されます。

拡張機能をインポート

Android Studioで、app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication​に移動し、次のインポートがソースファイルの一部であることを確認します。

import com.adobe.marketing.mobile.Assurance
import com.adobe.marketing.mobile.Edge
import com.adobe.marketing.mobile.Lifecycle
import com.adobe.marketing.mobile.LoggingMode
import com.adobe.marketing.mobile.Messaging
import com.adobe.marketing.mobile.MobileCore
import com.adobe.marketing.mobile.MobilePrivacyStatus
import com.adobe.marketing.mobile.Places
import com.adobe.marketing.mobile.Signal
import com.adobe.marketing.mobile.UserProfile
import com.adobe.marketing.mobile.edge.consent.Consent
import com.adobe.marketing.mobile.edge.identity.Identity
import com.adobe.marketing.mobile.optimize.Optimize

アプリ > kotlin+java > com.adobe.luma.tutorial.android > モデル > MobileSDK​に対して同じことを行います。

LumaApplicationの更新

Android ビューで、Android Studioの​app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication​に移動します。

1. private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"の"YOUR_ENVIRONMENT_FILE_ID"を、Generate SDK install instructionsのタグから取得したEnvironment File ID値に置き換えます。

   code language-kotlin
   private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. 次のコードをclass LumaApplication : Application()のoverride fun onCreate()関数に追加します。

   code language-kotlin

   // Define extensions val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION ) // Register extensions MobileCore.registerExtensions(extensions) { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Log.i("Luma", "Using mobile config: $environmentFileId") MobileCore.configureWithAppID(environmentFileId) // set this to true when testing on your device, default is false. //MobileCore.updateConfiguration(mapOf("messaging.useSandbox" to true)) // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(MobilePrivacyStatus.UNKNOWN) }

   上記のコードでは、次の操作を行います。

   1. 必要な拡張機能を登録します。
   2. タグプロパティ設定を使用するようにMobileCoreおよびその他の拡張機能を設定します。
   3. デバッグログを有効にします。 詳細とオプションについては、Adobe Experience Platform Mobile SDK ドキュメント ​を参照してください。
   4. ライフサイクル監視を開始します。 詳しくは、チュートリアルの​ ライフサイクル ​ ステップを参照してください。
   5. デフォルトの同意を不明に設定します。 詳しくは、チュートリアルの「同意 ステップ」を参照してください。

構築中のタグ環境（開発、ステージング、実稼動環境）の環境ファイル IDに基づいて、MobileCore.configureWith(environmentFileId)をenvironmentFileIdに更新してください。