安裝 Adobe Experience Platform Mobile SDK tutorial_install_mobile_sdks

Swift封裝管理程式

您可以使用Xcode的原生Swift封裝管理員，新增個別封裝，而不使用CocoaPods和Pod檔案(如產生SDK安裝指示中所述)。 Xcode專案已經為您新增了所有套件相依性。 Xcode 封裝相依性 ​畫面應該如下所示：

{modal="regular"}

在Xcode中，您可以使用​ 檔案 > 新增封裝…… ​來新增封裝。 下表提供您用來新增套件的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安裝指示中的標籤擷取到的環境檔案識別碼值。

   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指令碼 > build.gradle.kts （模組:app）。 然後在右窗格中捲動，直到您看到dependencies為止。

   {modal="regular"}

在Android Studio中，您可以使用​ 檔案 > 專案結構…… ​來新增模組相依性。 選取​ 相依性，然後使用​ 模組 來新增模組。 下表提供您用來新增相依性模組的URL連結。 這些連結也會將您導向每個特定模組的詳細資訊。

匯入擴充功能

在Android Studio中，導覽至​ 應用程式 > 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 ​執行相同動作。

更新LumaApp

在​ Android ​檢視中，導覽至Android Studio中的​ 應用程式 > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication。

1. 將"YOUR_ENVIRONMENT_FILE_ID"中的private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"取代為您從產生SDK安裝指示中的標籤擷取到的環境檔案識別碼值。

   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. 將預設同意設定為未知。 如需詳細資訊，請參閱教學課程中的同意步驟。

請確定您根據您正在建置的標籤環境（開發、測試或生產）中的環境檔案ID，使用MobileCore.configureWith(environmentFileId)更新environmentFileId。