Rastreamento de falhas do aplicativo

Essas informações ajudam a entender como as falhas são rastreadas e as práticas recomendadas para lidar com falsas falhas.

Quando as medições de ciclo de vida são implementadas, é feita uma chamada Config.collectLifecycleData no método OnResume para cada atividade. No método onPause, é feita uma chamada para Config.pauseCollectingLifeCycleData.

Em pauseCollectingLifeCycleData, é definido um sinalizador pra indicar uma saída. Quando o aplicativo é inicializado novamente ou retomado, o collectLifecycleData seleciona esse sinalizador. Se o aplicativo não for bem sucedido ao sair, como determinado pelo status do sinalizador, um dado de contexto a.CrashEvent é enviado com a próxima chamada, e é reportado um evento de falha.

Para assegurar um relatório de falhas preciso, você deve chamar pauseCollectingLifeCycleData no método onPause de cada atividade. Para entender porque isso é essencial, esta é uma ilustração do ciclo de vida de uma atividade no Android:

Para obter mais informações sobre o ciclo de vida da atividade do Android, consulte Atividades.

Esta ilustração do ciclo de vida do Android foi criada e compartilhada pelo Projeto de fonte aberta do Android e usado de acordo com os termos na Licença de atribuição dos Comuns criativos 2.5.

O que pode causar o relato de falhas falsas?

1. Se estiver fazendo uma depuração com um IDE, como o Android Studio, iniciar o aplicativo novamente a partir do IDE enquanto o aplicativo está em primeiro plano causa uma falha.

   DICA

   É possível evitar essa falha colocando o aplicativo em segundo plano antes de iniciar novamente pelo IDE.

2. Se a última atividade em primeiro plano do aplicativo for posta em segundo plano e não fizer chamada Config.pauseCollectingLifecycleData(); no onPause, e se seu aplicativo for fechado manualmente ou suspenso pelo OS, a próxima inicialização resultará em falha.

Como gerenciar os Fragmentos?

Os fragmentos têm eventos de ciclo de vida do aplicativo semelhantes a Atividades. No entanto, um Fragmento não pode estar ativo sem estar anexado a uma Atividade.

(Opcional) Implementar chamadas de retorno do ciclo de vida da Atividade

A partir da API nível 14, o Android permite chamadas de retorno de ciclos de vida globais nas atividades. Para obter mais informações, consulte Aplicativo.

É possível usar essas chamadas de retorno para garantir que todas as atividades façam chamadas collectLifecycleData() e pauseCollectingLifecycleData() de maneira correta. É necessário adicionar esse código apenas na Atividade principal e qualquer outra Atividade no site que pode ser iniciada pelo aplicativo:

import com.adobe.mobile.Config;

public class MainActivity extends Activity {
...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        getApplication().registerActivityLifecycleCallbacks(new Application.ActivityLifecycleCallbacks() {
            @Override
            public void onActivityResumed(Activity activity) {
                Config.setContext(activity.getApplicationContext());
                Config.collectLifecycleData(activity);
            }

            @Override
            public void onActivityPaused(Activity activity) {
                Config.pauseCollectingLifecycleData();
            }

            // the following methods aren't needed for our lifecycle purposes, but are required to be implemented
            // by the ActivityLifecycleCallbacks object
            @Override
            public void onActivityCreated(Activity activity, Bundle savedInstanceState) {}
            @Override
            public void onActivityStarted(Activity activity) {}
            @Override
            public void onActivityStopped(Activity activity) {}
            @Override
            public void onActivitySaveInstanceState(Activity activity, Bundle outState) {}
            @Override
            public void onActivityDestroyed(Activity activity) {}
        });
    }
...
}

Para enviar dados de contexto adicionais na chamada do ciclo de vida usando Config.collectLifecycleData(Activity activity, Map<String, Object> contextData), é necessário substituir o método onResume daquela atividade e realizar uma chamada super.onResume() após fazer uma chamada collectLifecycleData manualmente.

@Override
protected void onResume() {
    HashMap<String, Object> cdata = new HashMap<>();
    cdata.put("someKey", "someValue");
    Config.collectLifecycleData(this, cdata);

    super.onResume();
}