Instalar SDKs do Adobe Experience Platform Mobile
Saiba como implementar o Adobe Experience Platform Mobile SDK em um aplicativo móvel.
Pré-requisitos
- Biblioteca de tags criada com sucesso com as extensões descritas em lição anterior.
- ID do arquivo do ambiente de desenvolvimento do Instruções de instalação em dispositivos móveis.
- Baixou o vazio aplicativo de amostra.
- 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 (conforme descrito em Gerar instruções de instalação do SDK), você adiciona 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ê. O Xcode Dependências de pacote A tela deve ter a seguinte aparência:
{zoom="yes"}
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.
A variável AEPCore
, AEPServices
, e AEPIdentity
As extensões representam a base do SDK do Adobe Experience Platform - 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.
AEPCore
contém a implementação do Hub de eventos. O Hub de eventos é o mecanismo usado para fornecer eventos entre o aplicativo e o SDK. O Hub de eventos também é usado para compartilhar dados entre extensões.AEPServices
O fornece várias implementações reutilizáveis necessárias para suporte à plataforma, incluindo rede, acesso ao disco e gerenciamento de banco de dados.AEPIdentity
implementa a integração com os serviços de identidade da Adobe Experience Platform.AEPSignal
representa a extensão de sinal dos SDKs da Adobe Experience Platform que permite aos profissionais de marketing enviar um "sinal" para seus aplicativos a fim de enviar dados para destinos externos ou abrir URLs.AEPLifecycle
representa a extensão Lifecycle 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 da 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 da Rede de borda é uma extensão para o SDK do Adobe Experience Platform e requer o
AEPCore
e AEPServices
extensões para manipulação de eventos, bem como a AEPEdgeIdentity
extensão para recuperar as identidades, como ECID.AEPEdgeIdentity
) permite a manipulação de dados de identidade do usuário de um aplicativo móvel ao usar o SDK do Adobe Experience Platform e a extensão Edge Network.AEPConsent
) ativa a coleção de preferências de consentimento do aplicativo móvel ao usar o SDK do Adobe Experience Platform e a extensão Edge Network.AEPUserProfile
) é uma extensão para gerenciar perfis de usuário para o SDK do Adobe Experience Platform.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 workflows de personalização em tempo real nos SDKs do Adobe Experience Platform Mobile usando o Adobe Target ou o Adobe Journey Optimizer Offer Decisioning. Exige AEPCore
e AEPEdge
extensões para enviar eventos de consulta de personalização para a rede Experience Edge.AEPAssurance
) para ajudá-lo a inspecionar, testar, simular e validar a maneira como você coleta dados ou fornece 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 importações a seguir fazem parte desse 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 do Projeto Xcode.
-
Substitua o
@AppStorage
valueYOUR_ENVIRONMENT_ID_GOES_HERE
paraenvironmentFileId
ao valor da ID do arquivo do ambiente de desenvolvimento que você recuperou das tags na 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 à
application(_, didFinishLaunchingWithOptions)
função.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 SDK do Adobe Experience Platform Mobile.
- Inicia o monitoramento do ciclo de vida. Consulte Ciclo de vida etapa no tutorial para obter mais detalhes.
- Define o consentimento padrão como desconhecido. Consulte Consentimento etapa no tutorial para obter mais detalhes.
MobileCore.configureWith(appId: self.environmentFileId)
com o appId
com base no environmentFileId
no ambiente de tags que você está criando para (desenvolvimento, armazenamento temporário ou produção).Próximo: Configurar o Assurance