Instalar SDKs da Adobe Experience Platform para dispositivos móveis tutorial_install_mobile_sdks
Saiba como implementar o SDK da Adobe Experience Platform para dispositivos móveis em um aplicativo móvel.
Pré-requisitos
- Biblioteca de marcas criada com êxito com as extensões descritas na lição anterior.
- ID do Arquivo de Ambiente de Desenvolvimento das Instruções de Instalação Móvel.
- Baixe o aplicativo de amostra vazio.
- Experiência com Xcode.
Objetivos de aprendizagem
Nesta lição, você vai:
- Adicione os SDKs necessários ao seu projeto usando o Gerenciador de pacotes do Swift.
- Registre as extensões.
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:
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.
As extensões AEPCore, AEPServices e AEPIdentity representam a base do Adobe Experience Platform SDK - todos os aplicativos que usam o SDK devem incluí-las. Esses módulos contêm um conjunto comum de funcionalidades e serviços exigidos por todas as extensões do SDK.
AEPCorecontém a implementação do Hub de Eventos. O Hub de eventos é o mecanismo usado para fornecer eventos entre o aplicativo e a SDK. O Hub de eventos também é usado para compartilhar dados entre extensões.- O
AEPServicesfornece várias implementações reutilizáveis necessárias para suporte à plataforma, incluindo rede, acesso a disco e gerenciamento de banco de dados. AEPIdentityimplementa a integração com os serviços de identidade da Adobe Experience Platform.AEPSignalrepresenta a extensão de Sinal dos SDKs da Adobe Experience Platform que permite aos profissionais de marketing enviar um "sinal" para seus aplicativos enviar dados para destinos externos ou abrir URLs.AEPLifecyclerepresenta a extensão de ciclo de vida dos SDKs da Adobe Experience Platform que ajuda a coletar métricas de ciclo de vida do aplicativo, como informações de instalação ou atualização do aplicativo, informações de inicialização e sessão do aplicativo, informações do dispositivo e quaisquer dados de contexto adicionais fornecidos pelo desenvolvedor do aplicativo.
AEPEdge) permite enviar dados para a Rede Adobe Edge a partir de um aplicativo para dispositivos móveis. Essa extensão permite implementar os recursos do Adobe Experience Cloud de forma mais robusta, atender a várias soluções de Adobe por meio de uma chamada de rede e, simultaneamente, encaminhar essas informações para a Adobe Experience Platform.A extensão móvel do Edge Network é uma extensão para o Adobe Experience Platform SDK e requer as extensões
AEPCore e AEPServices para manipulação de eventos, bem como a extensão AEPEdgeIdentity para recuperação de identidades, como ECID.AEPEdgeIdentity) permite o tratamento de dados de identidade do usuário de um aplicativo para dispositivos móveis ao usar o Adobe Experience Platform SDK e a extensão Edge Network.AEPConsent) habilita a coleção de preferências de consentimento do aplicativo móvel ao usar o Adobe Experience Platform SDK e a extensão Edge Network.AEPUserProfile) é uma extensão para gerenciar perfis de usuário do Adobe Experience Platform SDK.AEPPlaces) permite rastrear eventos de geolocalização conforme definido na interface do Adobe Places e nas regras de tag da coleção de dados do Adobe.AEPMessaging) permite enviar tokens de notificação por push e feedback de click-through de notificação por push para a Adobe Experience Platform.AEPOptimize) fornece APIs para permitir fluxos de trabalho de personalização em tempo real nos SDKs do Adobe Experience Platform Mobile usando o Adobe Target ou o Adobe Journey Optimizer Offer Decisioning. Ela requer as extensões AEPCore e AEPEdge para enviar eventos de consulta de personalização para a rede da Experience Edge.AEPAssurance) para ajudá-lo a inspecionar, testar, simular e validar como você coleta dados ou oferece experiências em seu aplicativo móvel. Essa extensão habilita seu aplicativo para Assurance.Importar extensões
No Xcode, navegue até Luma > Luma > AppDelegate e verifique se as seguintes importações 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.
-
Substitua o valor
@AppStorageYOUR_ENVIRONMENT_ID_GOES_HEREdeenvironmentFileIdpelo valor da ID do Arquivo do Ambiente de Desenvolvimento 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" -
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:
- Registra as extensões necessárias.
- Configura o MobileCore e outras extensões para usar a configuração de propriedade da tag.
- Ativa o log de depuração. Mais detalhes e opções podem ser encontrados na documentação do Adobe Experience Platform Mobile SDK.
- Inicia o monitoramento do ciclo de vida. Consulte a etapa Ciclo de vida do tutorial para obter mais detalhes.
- Define o consentimento padrão como desconhecido. Consulte a etapa Consentimento do tutorial para obter mais detalhes.
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).Próximo: Configurar Assurance