Instalar SDKs da Adobe Experience Platform para dispositivos móveis tutorial_install_mobile_sdks

Gerenciador de pacotes Swift

Em vez de usar CocoaPods e um arquivo Pod (como descrito em Gerar instruções de instalação do SDK), adicione pacotes individuais usando o gerenciador de pacotes Swift nativo do Xcode. O projeto Xcode já tem todas as dependências de pacotes adicionadas para você. A tela Dependências de Pacote do Xcode deve ser semelhante a:

{modal="regular"}

No Xcode, você pode usar Arquivo > Adicionar pacotes… para adicionar pacotes. A tabela abaixo fornece links para os URLs que você usaria para adicionar pacotes. Os links também direcionam você para mais informações sobre cada pacote específico.

Importar extensões

Abra o projeto no Xcode na pasta Start do aplicativo de amostra.

No Xcode, navegue até Luma > Luma > AppDelegate e verifique se as importações a seguir fazem parte deste arquivo de origem.

// 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

Faça o mesmo para Luma > Luma > Utils > MobileSDK.

Atualizar AppDelegate

Navegue até Luma > Luma > AppDelegate no navegador de projetos Xcode.

1. Substitua o @AppStorage valor YOUR_ENVIRONMENT_ID_GOES_HERE de environmentFileId pelo valor da ID de Arquivo de Ambiente que você recuperou das marcas em Gerar instruções de instalação do SDK.

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

2. Adicione o seguinte código à função 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) })

O código acima faz o seguinte:

1. Registra as extensões necessárias.
2. Configura o MobileCore e outras extensões para usar a configuração de propriedade da tag.
3. Ativa o log de depuração. Mais detalhes e opções podem ser encontrados na documentação do Adobe Experience Platform Mobile SDK.
4. Inicia o monitoramento do ciclo de vida. Consulte a etapa Ciclo de vida do tutorial para obter mais detalhes.
5. Define o consentimento padrão como desconhecido. Consulte a etapa Consentimento do tutorial para obter mais detalhes.

Atualize MobileCore.configureWith(appId: self.environmentFileId) com o appId baseado no environmentFileId do ambiente de marcas para o qual você está criando (desenvolvimento, preparo ou produção).

Gradle

Use as dependências da Gerar instruções de instalação do SDK para adicionar pacotes individuais usando a integração do Gradle com o Android Studio. O projeto do Android Studio já tem todas as dependências de pacotes adicionadas para você.

1. Selecione como a ferramenta.

2. Selecione a exibição Android.

3. Selecione Gradle scripts > build.gradle.kts (Módulo :app) no painel esquerdo. Em seguida, no painel direito, role até ver dependencies.

   {modal="regular"}

No Android Studio, você pode usar Arquivo > Estrutura de Projeto… para adicionar dependências de módulo. Selecione Dependências e use Módulos para adicionar módulos. A tabela abaixo fornece links para os URLs que você usaria para adicionar módulos de dependência. Os links também direcionam você para mais informações sobre cada módulo específico.

Importar extensões

No Android Studio, navegue até app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication e verifique se as importações a seguir fazem parte do arquivo de origem.

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

Faça o mesmo para app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK.

Atualizar LumaApplication

No modo de exibição Android, navegue até app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication no Android Studio.

1. Substitua "YOUR_ENVIRONMENT_FILE_ID" em private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" pelo valor da ID de Arquivo de Ambiente que você recuperou das marcas em Gerar instruções de instalação do SDK.

   code language-kotlin
   private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. Adicione o seguinte código à função override fun onCreate() em 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) }

   O código acima faz o seguinte:

   1. Registra as extensões necessárias.
   2. Configura o MobileCore e outras extensões para usar a configuração de propriedade da tag.
   3. Ativa o log de depuração. Mais detalhes e opções podem ser encontrados na documentação do Adobe Experience Platform Mobile SDK.
   4. Inicia o monitoramento do ciclo de vida. Consulte a etapa Ciclo de vida do tutorial para obter mais detalhes.
   5. Define o consentimento padrão como desconhecido. Consulte a etapa Consentimento do tutorial para obter mais detalhes.

Atualize MobileCore.configureWith(environmentFileId) com o environmentFileId baseado na ID do Arquivo de Ambiente do ambiente de marcas que você está criando para (desenvolvimento, preparo ou produção).