Implementação principal e ciclo de vida

Esta informação ajuda a implementar a biblioteca do iOS e coletar medições de ciclo de vida, como inicializações, atualizações, sessões, usuários envolvidos e assim por diante.

Baixar o SDK

Pré-requisitos

Antes de baixar o SDK, conclua as etapas em Criar um conjunto de relatórios na Implementação principal e no ciclo de vida para configurar um conjunto de relatórios de desenvolvimento e baixar uma versão pré-preenchida do arquivo de configuração.

Para baixar o SDK:

1. Baixe, descompacte o arquivo [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip e verifique se você tem os seguintes componentes de software no diretório AdobeMobileLibrary:

   • ADBMobile.h - o arquivo de cabeçalho Objetive-C usado para o SDK do iOS.

   • ADBMobileConfig.json - o arquivo de configuração do SDK que é personalizado para seu aplicativo.

   • AdobeMobile.xcframework - contém dois binários multiarquiterura, um para dispositivos iOS (armv7, armv7s, arm64) e simuladores (i386, x86_64, arm64).

     Esse XCFramework deve ser vinculado ao direcionar um aplicativo iOS.

   • AdobeMobileExtension.xcframework - contém dois binários multiarquiterura, um para dispositivos iOS (armv7, armv7s, arm64) e simuladores (i386, x86_64, arm64).

     Esse XCFramework deve ser vinculado ao direcionar uma extensão do iOS.

   • AdobeMobileWatch.xcframework - contém dois binários multiarquitetura, um para dispositivos watchOS (arm64_32, armv7k) e simuladores (i386, x86_64, arm64).

     Esse XCFramework deve ser vinculado ao direcionar um aplicativo Apple Watch (watchOS).

   • AdobeMobileTV.xcframework - contém dois binários multiarquitetura, um para dispositivos tvOS (arm64) e simuladores (x86_64, arm64).

     Esse XCFramework deve ser vinculado ao direcionar um aplicativo da Apple TV (tvOS).

1. Baixe, descompacte o arquivo [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip e verifique se você tem os seguintes componentes de software:

   • ADBMobile.h - arquivo de cabeçalho em Objective-C usado no AppMeasurement do iOS.

   • ADBMobileConfig.json - que é o arquivo de configuração de SDK personalizado para o seu aplicativo.

   • AdobeMobileLibrary.a - um binário multiarquitetura habilitado para código de bits que contém os builds da biblioteca de dispositivos (armv7, armv7s, arm64) e dos simuladores (i386 e x86_64) do iOS.

     Esse binário deve ser vinculado quando o destino for pretendido para um aplicativo do iOS.

   • AdobeMobileLibrary_Extension.a - um binário multiarquitetura habilitado para código de bits que contém os builds da biblioteca de dispositivos (armv7, armv7s, arm64) e dos simuladores (i386 e x86_64) do iOS.

     Esse binário deve ser vinculado quando o destino for pretendido para uma extensão do iOS.

   • AdobeMobileLibrary_Watch.a - um binário multiarquitetura habilitado para código de bits que contém os builds da biblioteca dos dispositivos (armv7k) e dos simuladores (i386 e x86_64) do Apple Watch.

     Esse binário deve ser vinculado quando o destino for pretendido para um aplicativo de extensão do Apple Watch (watchOS 2).

   • AdobeMobileLibrary_TV.a - um binário multiarquitetura habilitado para código de bits que apresenta os builds da biblioteca dos novos dispositivos (arm64) e simuladores (x86_64) da Apple TV.

     Esse binário deve ser vinculado quando o destino for pretendido para um aplicativo da Apple TV (tvOS).

Adicionar o SDK e o arquivo de configuração ao projeto

1. Abra o Xcode IDE e o seu aplicativo.

2. No Navegador de projetos, arraste a pasta AdobeMobileLibrary e solte-a no seu projeto.

3. Verifique o seguinte:

   • A caixa de seleção Copiar itens se necessário está marcada.
   • Criar grupos está selecionado.
   • Nenhuma das caixas de seleção na seção Adicionar aos destinos está marcada.

   

4. Clique em Concluir.

5. No Navegador de projetos, selecione ADBMobileConfig.json.

6. Em Inspetor de arquivos, adicione o arquivo JSON a todos os destinos em seu projeto que usarão o SDK da Adobe.

   

7. No Navegador de projetos, conclua as seguintes etapas:

   1. Clique no seu aplicativo.
   2. Na guia Geral, selecione seus alvos e vincule as estruturas e bibliotecas necessárias nas seções Estruturas vinculadas e Bibliotecas.

   • Destinos de aplicativos iOS

     • SystemConfiguration.framework
     • WebKit.framework
     • libsqlite3.0.tbd
     • AdobeMobileLibrary.a
     • CoreLocation.framework (opcional, porém obrigatório para recursos de rastreamento geográfico)

   • Destino de extensão do iOS

     • SystemConfiguration.framework
     • libsqlite3.0.tbd
     • AdobeMobileLibrary\_Extension.a

   • Destino Apple Watch (watchOS 2)

     • libsqlite3.0.tbd
     • AdobeMobileLibrary\_Watch.a

   • Destino da Apple TV (tvOS):

     • SystemConfiguration.framework
     • libsqlite3.0.tbd
     • AdobeMobileLibrary\_TV.a
   CUIDADO

   Vincular mais de um arquivo AdobeMobileLibrary*.a ao mesmo destino resultará em um comportamento inesperado ou na incapacidade de criar o build.

   IMPORTANTE

   Se estiver usando a versão 4.21.0 ou mais recente, verifique se o Adobe XCFrameworks não está incorporado.

   

8. Verifique se o aplicativo foi criado sem erros.

Implementar medições de ciclo de vida

Após habilitar o ciclo de vida, cada vez que o aplicativo é iniciado uma ocorrência é enviada para medir as inicializações, atualizações, usuários engajados e outras Medições de ciclo de vida.

Adicionar uma chamada collectLifecycleData/collectLifecycleDataWithAdditionalData em application:didFinishLaunchingWithOptions:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
 [ADBMobile collectLifecycleData];
    return YES;
}

Incluir dados adicionais com chamadas de ciclo de vida

Para incluir dados adicionais com chamadas de ciclo de vida, use collectLifecycleDataWithAdditionalData:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    NSMutableDictionary *contextData = [NSMutableDictionary dictionary];
    [contextData setObject:@"Game" forKey:@"myapp.category"];
    [ADBMobile collectLifecycleDataWithAdditionalData:contextData];
    return YES;
}

Os valores dos dados de contexto adicionais enviados com o collectLifecycleDataWithAdditionalData devem ser mapeados para variáveis personalizadas no Adobe Mobile Services:

As outras medições de ciclo de vida são coletadas automaticamente. Para obter mais informações, consulte Medições de ciclo de vida.

O que fazer em seguida

Conclua as seguintes tarefas:

• Rastrear estados do aplicativo
• Rastrear ações do aplicativo