Configurar o Assurance

Além da instalação geral do SDK, o iOS também exige o seguinte código adicional para iniciar a sessão do Assurance para o seu aplicativo.

1. Navegue até Luma > Luma > SceneDelegate no navegador Project do Xcode.

2. Adicione o código a seguir a func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>:

   code language-swift
   // Called when the app in background is opened with a deep link. if let deepLinkURL = URLContexts.first?.url { // Start the Assurance session Assurance.startSession(url: deepLinkURL) }

   Esse código inicia uma sessão de controle quando o aplicativo é colocado em segundo plano e aberto usando um deep link.

Além da instalação geral do SDK, o Android também exige o seguinte código adicional para iniciar a sessão do Assurance para o seu aplicativo.

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

2. Adicione o código a seguir a fun handleDeeplink(deeplink: String?):

   code language-kotlin
   // Called when the app in background is opened with a deep link. if (deeplink.isNullOrEmpty()) { Log.w("Luma", "Deeplink is null or empty") return } Log.i("Luma", "Handling deeplink: $deeplink") Assurance.startSession(deeplink)

   Esse código inicia uma sessão de controle quando o aplicativo é colocado em segundo plano e aberto usando um deep link.

1. Abra o projeto no Xcode.
2. Selecione Luma no Navegador de projetos.
3. Selecione o destino Luma.
4. Selecione a guia Assinatura e Recursos.
5. Defina um Identificador de Pacote.

Use um identificador de conjunto exclusivo e substitua o identificador de conjunto com.adobe.luma.tutorial.swiftui, pois cada identificador de conjunto precisa ser exclusivo. Normalmente, você usa um formato de DNS reverso para cadeias de caracteres de ID de pacote, como com.organization.brand.uniqueidentifier. A versão Concluída deste tutorial, por exemplo, usa com.adobe.luma.tutorial.swiftui.

{modal="regular"}

1. Abra o projeto no Android Studio.
2. Selecione build.gradle.kts (Módulo :app) no navegador.
3. Use um identificador de conjunto exclusivo e substitua o valor com.adobe.luma.tutorial.android para namespace em android
4. Use o mesmo identificador de conjunto exclusivo e substitua o com.adobe.luma.tutorial.android por applicationId em defaultConfig em android

Normalmente, você usa um formato de DNS reverso para cadeias de caracteres de ID de pacote, como com.organization.brand.uniqueidentifier. A versão Concluída deste tutorial, por exemplo, usa com.adobe.luma.tutorial.android.

{modal="regular"}

1. Vá para o seu projeto no Xcode.

2. Selecione Luma no Navegador de projetos.

3. Selecione o destino Luma.

4. Selecione a guia Informações.

5. Para adicionar uma URL base, role para baixo até Tipos de URL e selecione o botão +.

6. Defina Identificador para o identificador de pacote de sua escolha e defina um Esquemas de URL de sua escolha.

   {modal="regular"}

Use um identificador de conjunto exclusivo e substitua o identificador de conjunto com.adobe.luma.tutorial.swiftui, pois cada identificador de conjunto deve ser exclusivo. Normalmente, você usa um formato de DNS reverso para cadeias de caracteres de ID de pacote, como com.organization.brand.uniqueidentifier. Você pode usar o mesmo identificador de conjunto usado em Definir identificador de conjunto.
Da mesma forma, use um esquema de URL exclusivo e substitua o lumatutorialswiftui já fornecido pelo seu esquema de URL exclusivo.

Para saber mais sobre os Esquemas de URL no iOS, consulte a documentação da Apple.

O Assurance funciona abrindo um URL, por meio de um navegador ou um código QR. Esse URL começa com o URL de base que abre o aplicativo e contém parâmetros adicionais. Esses parâmetros exclusivos são usados para conectar a sessão. No aplicativo de exemplo, o deep link é lumatutorialswiftui://.

1. Vá para a exibição Android do seu projeto no Android Studio.

2. Selecione app > manifests > AndroidManifest.xml no navegador.

3. Verifique se o elemento XML manifest > application > activity é semelhante a:

   code language-xml

   <activity android:name=".MainActivity" android:exported="true" android:theme="@style/Theme.LumaAndroid"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter android:label="@string/app_name"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="lumatutorialandroid" android:host="default" /> </intent-filter> </activity>

Certifique-se de especificar um android:scheme (por exemplo. lumatutorialandroid) e android:host (por exemplo default) para definir a URL base.

Para saber mais sobre deep links no Android, consulte Criar deep links para conteúdo do aplicativo.

O Assurance funciona abrindo um URL, por meio de um navegador ou um código QR. Esse URL começa com o URL de base, que abre o aplicativo e contém parâmetros adicionais. Esses parâmetros exclusivos são usados para conectar a sessão. No aplicativo de exemplo, o deep link é lumatutorialandroid://default.

No Xcode:

1. Compile ou recompile e execute o aplicativo no simulador ou em um dispositivo físico do Xcode, usando .

   Opcionalmente, talvez você queira limpar sua compilação, especialmente quando vir resultados inesperados. Selecione Pasta de Compilação Limpa… no menu Xcode Produto.

2. Na caixa de diálogo Permitir que o "Aplicativo Luma" use sua localização, selecione Permitir ao Usar o Aplicativo.

   {width="300"}

3. Na caixa de diálogo "Aplicativo Luma" Deseja Enviar Notificações, selecione Permitir.

   {width="300"}

4. Selecione Continuar… para permitir que o aplicativo acompanhe sua atividade.

   {width="300"}

5. Na caixa de diálogo Permitir que o "Aplicativo Luma" acompanhe sua atividade nos aplicativos e sites de outras empresas, selecione Permitir.

   {width="300"}

6. Selecione Continuar.

No navegador:

1. Vá para a interface da Coleção de dados.

2. Selecione Assurance no painel esquerdo.

3. Selecione Criar nova sessão e a opção Conexão de deep link.

4. Selecione Iniciar.

5. Forneça um Nome da Sessão, como Luma Mobile App Session e a URL Base, que são os Esquemas de URL inseridos no Xcode, seguido de :// Por exemplo: lumatutorialswiftui://

6. Selecione Próximo.
   {modal="regular"}

7. Na caixa de diálogo modal Criar nova sessão:

   Se você estiver usando um dispositivo físico:

   • Selecione Digitalizar código QR. Para abrir o aplicativo, use a câmera do dispositivo físico para digitalizar o código QR e toque no link.

     {modal="regular"}

   Se estiver usando um simulador:

   1. Selecione Copiar Link.

   2. Copie o deep link usando e use o deep link para abrir o aplicativo com o Safari no simulador.

      {modal="regular"}

8. Quando o aplicativo é carregado, uma caixa de diálogo modal é exibida solicitando que você insira o PIN mostrado na etapa 7.

   {width="300"}

   Insira o PIN e selecione Conectar.

9. Se a conexão tiver sido bem-sucedida, você verá:

   • Um ícone do Assurance que flutua sobre seu aplicativo.

     {width="300"}

   • Atualizações do Experience Cloud que vêm pela interface do usuário do Assurance, mostrando:

     1. Eventos de experiência provenientes do aplicativo.

     2. Detalhes de um evento selecionado.

     3. O dispositivo e a linha do tempo.

        {modal="regular"}

10. Selecione Continuar para ir para a tela inicial.

No Android Studio:

1. Compile ou recompile e execute o aplicativo no simulador ou em um dispositivo físico do Android Studio, usando .

   Opcionalmente, talvez você queira limpar sua compilação, especialmente quando vir resultados inesperados. Selecione Limpar Projeto no menu Compilação do Android Studio.

2. Na caixa de diálogo Permitir que o Luma Android envie notificações, selecione Permitir.

   {width="300"}

3. Selecione Mostrar caixa de diálogo de permissões.

   {width="300"}

4. Em Permitir que o Luma Android acesse a localização deste dispositivo?…

   {width="300"}

   • Selecione Preciso.
   • Selecione Ao usar o aplicativo.

5. De volta à tela de introdução do aplicativo, selecione Abrir configurações do dispositivo.

6. Na tela Permissão de localização, selecione Permitir o tempo todo. Em seguida, selecione Esquerda para retornar à tela de introdução do aplicativo.

   {width="300"}

7. Selecione Continuar para ir para a tela inicial.

No navegador:

1. Vá para a interface da Coleção de dados.

2. Selecione Assurance no painel esquerdo.

3. Selecione Criar nova sessão e a opção Conexão de deep link.

4. Selecione Iniciar.

5. Forneça um Nome da Sessão, como Luma Mobile App Session e a URL Base, que são o android:scheme e o android:host definidos no AndroidManifest.xml no Android Studio, separados por :// Por exemplo: lumatutorialandroid://default

6. Selecione Próximo.
   {modal="regular"}

7. Na caixa de diálogo modal Criar nova sessão:

   Se você estiver usando um dispositivo físico:

   • Selecione Digitalizar código QR. Para abrir o aplicativo, use a câmera do dispositivo físico para digitalizar o código QR e toque no link.

     {modal="regular"}

   Se estiver usando um simulador:

   1. Selecione Copiar Link.
   2. Copie o deep link usando e use o deep link para abrir o aplicativo com o Chrome no simulador.

   {modal="regular"}

   Quando solicitado no Chrome para Continuar para o Luma Android, selecione Continuar.

8. Quando o aplicativo é carregado, uma caixa de diálogo modal é exibida solicitando que você insira o PIN mostrado na etapa 7.

   {width="300"}

   Insira o PIN e selecione Conectar.

9. Se a conexão tiver sido bem-sucedida, você verá:

   • Um ícone do Assurance que flutua sobre seu aplicativo.

     {width="300"}

   • Atualizações do Experience Cloud que vêm pela interface do usuário do Assurance, mostrando:

     1. Eventos de experiência provenientes do aplicativo.

     2. Detalhes de um evento selecionado.

     3. O dispositivo e a linha do tempo.

        {modal="regular"}

{modal="regular"}

Para atualizar suas versões de extensão (por exemplo, Mensagens e Otimizar), selecione o pacote (extensão) de Dependências de Pacote (por exemplo, AEPMessaging) e, no menu de contexto, selecione Atualizar Pacote. O Xcode atualiza as dependências do pacote.

{modal="regular"}

Se você vir extensões desatualizadas, consulte a documentação do Android Studio sobre como atualizar os módulos de dependência para o seu projeto.