Show Menu
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.
  1. 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:
  2. 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:
  1. Adicione o arquivo ADBMobileConfig.json à pasta assets do projeto.
  2. Clique com o botão direito no seu projeto, no painel Navegação do projeto.
  3. Selecione Abrir configurações do módulo .
  4. Em Configurações do projeto , selecione Bibliotecas .
  5. Clique no ícone + para adicionar uma nova biblioteca.
  6. Selecione Java e navegue até o arquivo adobeMobileLibrary.jar .
  7. Selecione os módulos nos quais planeja usar a biblioteca móvel.
  8. 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:
  1. Adicione o arquivo ADBMobileConfig.json à pasta assets do projeto.
  2. No Eclipse IDE , clique com o botão direito do mouse no nome do projeto.
  3. Clique em Caminho de criação > Adicionar arquivos externos .
  4. Select adobeMobileLibrary.jar .
  5. Clique em Abrir .
  6. Clique com o botão direito no projeto novamente e selecione Caminho de criação > Configurar caminho de criação .
  7. 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:
  1. Importe a biblioteca:
    import com.adobe.mobile.*;
    
    
  2. 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); 
    }
    
    
  3. 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: