TÓPICOS×

Implementação principal e ciclo de vida

Estas informações ajudam a implementar a biblioteca do Android e coletar medições de ciclo de vida, como lançamentos, atualizações, sessões, usuários envolvidos e assim por diante.

Introdução

Baixar o SDK

Para baixar o SDK, é necessário usar o Android 2.2, ou versão posterior.

Complete as etapas nas seções a seguir para configurar um conjunto de relatórios de desenvolvimento e baixar uma versão pré-preenchida do arquivo de configuração:
- Criar um conjunto de relatórios
- Baixar o SDK
Baixe e descompacte o arquivo [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip e verifique se os seguintes componentes de software existem:
- adobeMobileLibrary.jar , que é a biblioteca que será usada pelos dispositivos e simuladores Android.
- ADBMobileConfig.json , que é o arquivo de configuração de SDK personalizado para o seu aplicativo.
Se você baixar o SDK fora da interface do Adobe Mobile Services, o arquivo ADBMobileConfig.json deverá ser configurado manualmente. Se você nunca usou o Analytics e o Mobile SDK, e deseja configurar um conjunto de relatórios de desenvolvimento e baixar uma versão já preenchida do arquivo de configuração, consulte Antes de começar .

Adicionar o SDK e o arquivo de configuração ao projeto IntelliJ IDEA ou Eclipse

Projeto IntelliJ IDEA

Para adicionar o SDK e o arquivo de configuração ao projeto:

Adicione o arquivo ADBMobileConfig.json à pasta assets do projeto.
Clique com o botão direito no seu projeto, no painel Navegação do projeto.
Selecione Abrir configurações do módulo .
Em Configurações do projeto , selecione Bibliotecas .
Clique no ícone + para adicionar uma nova biblioteca.
Selecione Java e navegue até o arquivo adobeMobileLibrary.jar .
Selecione os módulos nos quais planeja usar a biblioteca móvel.
Clique em Aplicar e em OK para fechar a janela Configurações do módulo.

Projeto Eclipse

Para adicionar o SDK e o arquivo de configuração ao projeto:

Adicione o arquivo ADBMobileConfig.json à pasta assets do projeto.
No Eclipse IDE , clique com o botão direito do mouse no nome do projeto.
Clique em Criar caminho > Adicionar arquivos externos .
Selecione adobeMobileLibrary.jar .
Clique em Abrir .
Clique com o botão direito no projeto novamente e selecione Criar caminho > Configurar caminho de construção .
Na guia Fazer pedido e exportar , certifique-se de que o adobeMobileLibrary.jar esteja selecionado.

Adicionar permissões do aplicativo

A biblioteca do AppMeasurement pede as seguintes permissões para enviar dados e gravar chamadas de rastreamento offline:

INTERNET
ACCESS_NETWORK_STATE

Para adicionar essas permissões, adicione as seguintes linhas no arquivo AndroidManifest.xml , localizado no diretório do projeto do aplicativo:

<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Definir o contexto do aplicativo

O código a seguir deve ser adicionado ao método onCreate da atividade principal:

   @Override
   public void onCreate(BundlesavedInstanceState){
     super.onCreate(savedInstanceState)
     setContentView(R.layout.main);
     Config.setContext(this.getApplicationContext());
   }

Implementar métricas 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 muitas outras métricas. Para obter mais informações, consulte Medições de ciclo de vida .

Complete as etapas a seguir em cada atividade do aplicativo:

Importe a biblioteca:
```
import com.adobe.mobile.*;
```

Na função onResume , inicie a coleção de dados do ciclo de vida:

@Override 
public void onResume() { 
    Config.collectLifecycleData(this); 
    // -or- Config.collectLifecycleData(this, contextData); 
}

Na função onPause , pause a coleção de dados do ciclo de vida:

@Override 
public void onPause() { 
    Config.pauseCollectingLifecycleData(); 
}

É necessário adicionar essas chamadas em todas as atividades para garantir relatórios de falhas precisos. Para obter mais informações, consulte Rastrear falhas do aplicativo .

Incluir dados adicionais com chamadas de ciclo de vida

Para incluir dados adicionais com chamadas de medições de ciclo de vida, passe um parâmetro adicional para o collectLifecycleData que contém os dados de contexto:

@Override 
public void onResume() {
    HashMap<String, Object> contextData = new HashMap<String, Object>(); 
    contextData.put("myapp.category", "Game"); 
    Config.collectLifecycleData(this, contextData); 
}

Os valores dos dados de contexto adicionais enviados com o collectLifecycleData 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:

Título da Guia