Primeiros passos com o Firebase Crashlytics

iOS+ Android Flutter Unity

Este início rápido descreve como configurar o Firebase Crashlytics em seu aplicativo com o SDK do Firebase Crashlytics para que você possa obter relatórios de falhas abrangentes no Firebase console.Com o Crashlytics para Android, você obtém relatórios de falhas, erros não fatais e erros "Application Not Responding" (ANR).

A configuração do Crashlytics requer tarefas no console do Firebase e no ambiente de desenvolvimento integrado (como adicionar um arquivo de configuração do Firebase e o SDK do Crashlytics). Para concluir a configuração, você precisará forçar uma falha de teste para enviar seu primeiro relatório de falha ao Firebase.

Antes de você começar

1. Se ainda não o fez, adicione o Firebase ao seu projeto Android. Se você não tiver um aplicativo para Android, faça o download de um aplicativo de amostra .

2. Recomendado : para obter recursos como usuários sem falhas, logs de navegação e alertas de velocidade, você precisa ativar o Google Analytics em seu projeto do Firebase.

   • Se seu projeto existente do Firebase não tiver o Google Analytics ativado, você poderá ativar o Google Analytics na guia Integrações de suas settings > Configurações do projeto no console do Firebase.

   • Se você estiver criando um novo projeto do Firebase, ative o Google Analytics durante o fluxo de trabalho de criação do projeto.

Etapa 1 : adicionar o SDK do Crashlytics ao seu aplicativo

Para uma experiência ideal com o Crashlytics, recomendamos ativar o Google Analytics em seu projeto do Firebase e adicionar o SDK do Firebase para Google Analytics ao seu aplicativo.

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:31.1.0')

    // Add the dependencies for the Crashlytics and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-crashlytics'
    implementation 'com.google.firebase:firebase-analytics'
}

dependencies {
    // Add the dependencies for the Crashlytics and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-crashlytics:18.3.2'
    implementation 'com.google.firebase:firebase-analytics:21.2.0'
}

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:31.1.0')

    // Add the dependencies for the Crashlytics and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-crashlytics-ktx'
    implementation 'com.google.firebase:firebase-analytics-ktx'
}

dependencies {
    // Add the dependencies for the Crashlytics and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-crashlytics-ktx:18.3.2'
    implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0'
}

Etapa 2 : adicione o plug-in Crashlytics Gradle ao seu aplicativo

1. Em seu arquivo Gradle de nível raiz (nível de projeto) ( <project>/build.gradle ), adicione o plug-in Crashlytics Gradle como uma dependência de buildscript:

   buildscript {
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
           ...
           classpath 'com.android.tools.build:gradle:7.2.0'
   
           // Make sure that you have the Google services Gradle plugin dependency
           classpath 'com.google.gms:google-services:4.3.14'
   
           // Add the dependency for the Crashlytics Gradle plugin
           classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.2'
       }
   }

2. No arquivo Gradle do módulo (nível do aplicativo) (geralmente <project>/<app-module>/build.gradle ), adicione o plug-in Gradle do Crashlytics:

   plugins {
       id 'com.android.application'
   
       // Make sure that you have the Google services Gradle plugin
       id 'com.google.gms.google-services'
   
       // Add the Crashlytics Gradle plugin
       id 'com.google.firebase.crashlytics'
       ...
   }

Etapa 3 : forçar uma falha de teste para concluir a configuração

Para concluir a configuração do Crashlytics e ver os dados iniciais no painel do Crashlytics do console do Firebase, você precisa forçar uma falha de teste.

1. Adicione código ao seu aplicativo que você pode usar para forçar uma falha de teste.

   Você pode usar o seguinte código na MainActivity do seu aplicativo para adicionar um botão ao seu aplicativo que, quando pressionado, causa uma falha. O botão é rotulado como "Test Crash".

   Java

   Button crashButton = new Button(this);
   crashButton.setText("Test Crash");
   crashButton.setOnClickListener(new View.OnClickListener() {
      public void onClick(View view) {
          throw new RuntimeException("Test Crash"); // Force a crash
      }
   });
   
   addContentView(crashButton, new ViewGroup.LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT,
          ViewGroup.LayoutParams.WRAP_CONTENT));
   

   Kotlin+KTX

   val crashButton = Button(this)
   crashButton.text = "Test Crash"
   crashButton.setOnClickListener {
      throw RuntimeException("Test Crash") // Force a crash
   }
   
   addContentView(crashButton, ViewGroup.LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT,
          ViewGroup.LayoutParams.WRAP_CONTENT))
   

2. Crie e execute seu aplicativo.

3. Force a falha de teste para enviar o primeiro relatório de falha do seu aplicativo:

   1. Abra seu aplicativo em seu dispositivo de teste ou emulador.

   2. Em seu aplicativo, pressione o botão "Test Crash" que você adicionou usando o código acima.

   3. Depois que o app travar, reinicie-o para que o app possa enviar o relatório de falhas ao Firebase.

4. Acesse o painel do Crashlytics do console do Firebase para ver a falha do teste.

   Se você atualizou o console e ainda não está vendo a falha de teste após cinco minutos, habilite o log de depuração para ver se seu aplicativo está enviando relatórios de falha.

E é isso! O Crashlytics agora está monitorando seu aplicativo em busca de falhas, erros não fatais e ANRs. Visite o painel do Crashlytics para visualizar e investigar todos os seus relatórios e estatísticas.

Próximos passos

• Personalize a configuração do seu relatório de falhas adicionando relatórios opcionais, logs, chaves e rastreamento de erros não fatais.

• Integre-se ao Google Play para que você possa filtrar os relatórios de falhas do seu aplicativo Android pela faixa do Google Play diretamente no painel do Crashlytics. Isso permite que você concentre melhor seu painel em compilações específicas.

• Visualize rastreamentos de pilha e estatísticas de falhas diretamente ao lado de seu código com a janela App Quality Insights no Android Studio. Usando essa ferramenta, você não precisa alternar entre o painel do Crashlytics e o IDE para começar a resolver os principais problemas.
  • Obtenha acesso a este recurso na versão mais recente do Android Studio Canary - Electric Eel | 2022.1.1 .
  • Saiba mais sobre como usar esse recurso na documentação de novos recursos do Android Studio.
  • Como este é um recurso canário, gostaríamos de ouvir você! Se você tiver algum feedback ou encontrar algum problema, registre um relatório de bug .