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

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

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

{modal="regular"}

Xcode では、File > Add Packages… を使用してパッケージを追加できます。 次の表は、パッケージの追加に使用する URL へのリンクを示しています。 また、リンクでは、それぞれの特定のパッケージに関する詳細も示されます。

拡張機能の読み込み

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. @AppStorage の YOUR_ENVIRONMENT_ID_GOES_HERE 値 environmentFileId を、SDK インストール手順の生成のタグから取得した環境ファイル 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. デフォルトの同意を不明に設定します。 詳しくは、チュートリアルの 同意手順を参照してください。

作成するタグ環境（開発、ステージングまたは実稼動）の MobileCore.configureWith(appId: self.environmentFileId) に基づいて、appId を使用して environmentFileId を更新してください。

Gradle

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

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

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

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

   {modal="regular"}

Android Studio では、File/Project Structure… を使用して、モジュールの依存関係を追加できます。 依存関係 を選択してから、モジュール を使用してモジュールを追加してください。 次の表は、依存関係モジュールの追加に使用する 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

app/kotlin+java/com.adobe.luma.tutorial.android/models/MobileSDK に対して、同じ操作を行います。

LumaApplication の更新

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

1. "YOUR_ENVIRONMENT_FILE_ID" の private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" を、SDK インストール手順の生成のタグから取得した環境ファイル ID 値に置き換えます。

   code language-kotlin
   private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

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

   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. デフォルトの同意を不明に設定します。 詳しくは、チュートリアルの 同意手順を参照してください。

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