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.
Baixar o SDK
Para baixar o SDK, é necessário usar o Android 2.2, ou versão posterior.
- Conclua as etapas nas seções a seguir para configurar um conjunto de relatórios de desenvolvimento e baixar uma versão já preenchida do arquivo de configuração:
- 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 Caminho de criação > Adicionar arquivos externos .
- Select adobeMobileLibrary.jar .
- Clique em Abrir .
- Clique com o botão direito no projeto novamente e selecione Caminho de criação > Configurar caminho de criaçã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: