Primeiros passos com o Firebase Crashlytics

Neste guia de início rápido, mostramos como configurar o Firebase Crashlytics para que você possa ver relatórios de falhas abrangentes no Console do Firebase.

ios

android

unity [beta]

Antes de começar

iOS

Para começar, você precisa de um aplicativo do Firebase com o Firebase Crashlytics ativado:

android

Para começar, você precisa de um aplicativo do Firebase com o Firebase Crashlytics ativado:

unity [beta]

Antes de usar o Crashlytics, é preciso registrar seu projeto do Unity e configurá-lo para usar o Firebase.

  • Se o projeto do Unity já usa o Firebase, ele já está registrado e configurado para o Firebase.

  • Se você não tiver um projeto do Unity, poderá fazer o download de um aplicativo de amostra.

A adição do Firebase ao seu projeto do Unity envolve tarefas no Console do Firebase e no projeto do Unity aberto (por exemplo, você faz o download dos arquivos de configuração do Firebase no console e os move para o projeto do Unity).

Configurar o Crashlytics no Console do Firebase

  1. No Console do Firebase, clique em Crashlytics no painel de navegação à esquerda.

  2. Caso seu projeto do Firebase tenha vários apps registrados nele, selecione seu novo projeto do Unity no menu suspenso ao lado de Crashlytics, na barra superior do console.

  3. Clique em Configurar o Crashlytics.

  4. Selecione Este app é novo no Crashlytics. Não há nenhuma versão do SDK.

Adicionar o SDK do Crashlytics ao projeto

ios

1. Adicionar bibliotecas do Crashlytics ao seu espaço de trabalho Xcode

Para começar, adicione os arquivos da biblioteca do SDK do Crashlytics ao seu projeto. Na maioria dos projetos, é mais fácil adicionar o CocoaPods do Crashlytics, mas, se o projeto não for compatível com ele, também é possível adicionar os arquivos manualmente.

2. Adicionar o script de execução do Crashlytics

As bibliotecas que você adicionou incluem um script de execução que inicializa o Crashlytics. Adicione-o às fases de compilação do seu projeto:

  1. Abra seu projeto no Xcode e selecione o arquivo apropriado no Navegador.
  2. Selecione seu destino de criação principal no menu suspenso Selecionar um projeto ou destino.
  3. Abra a guia Fases de compilação do destino.
  4. Clique em + Adicionar nova fase de compilação e selecione Nova fase de execução de script.
  5. Adicione a seguinte linha à caixa de texto Digite um script...:
    Instalação do CocoaPods
    "${PODS_ROOT}/Fabric/run"
    Instalação manual
    "${PROJECT_DIR}/Fabric.framework/run"
  6. Apenas para o Xcode 10: adicione a localização do Info.plist integrado do app no campo Arquivos de entrada da fase de criação:
    $(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

Depois de adicionar o SDK ao app, o Crashlytics automaticamente passa a detectar e coletar relatórios de erros.

android

Incluir o SDK nos seus arquivos de versão

  1. No arquivo build.gradle do nível do projeto, atualize sua versão do google-services para 3.1.2 ou posterior. Em seguida, adicione os repositórios e dependências do Crashlytics:

    buildscript {
        repositories {
            // ...
    
            // Add repository
            maven {
               url 'https://maven.fabric.io/public'
            }
        }
        dependencies {
            // ...
    
            // Check for v3.1.2 or higher
            classpath 'com.google.gms:google-services:4.2.0'
    
            // Add dependency
            classpath 'io.fabric.tools:gradle:1.26.1'
        }
    }
    
    allprojects { // ... repositories { // ... // Add repository maven { url 'https://maven.google.com/' } } }

  2. No arquivo build.gradle do nível do projeto, atualize sua versão do firebase-core para 11.4.2 ou posterior. Em seguida, adicione as dependências do Crashlytics:

    apply plugin: 'com.android.application'
    apply plugin: 'io.fabric'
    
    dependencies { // ... // Check for v11.4.2 or higher implementation 'com.google.firebase:firebase-core:16.0.7' // Add dependency implementation 'com.crashlytics.sdk.android:crashlytics:2.9.9' }

Depois de adicionar o SDK ao app, o Crashlytics automaticamente passa a detectar e coletar relatórios de erros.

unity [beta]

Etapa 1: adicionar o pacote do Crashlytics

  1. Faça o download do SDK para Unity do Firebase e descompacte o SDK em um local prático.

    O SDK para Unity do Firebase não é específico da plataforma.

  2. No seu projeto aberto do Unity, acesse Assets > Import Package > Custom Package.

  3. No SDK descompactado, selecione a opção para importar o SDK do Crashlytics (FirebaseCrashlytics.unitypackage).

    Também é possível importar qualquer outro serviço do Firebase compatível.

  4. Na janela Import Unity Package, clique em Import.

Etapa 2: inicializar o Crashlytics

  1. Crie um novo script C# e adicione-o a um GameObject na cena.

    1. Abra sua primeira cena e crie um GameObject em branco chamado CrashlyticsInitializer.

    2. Clique em Adicionar componente no Inspetor para o novo objeto.

    3. Selecione seu script CrashlyticsInit para adicioná-lo ao objeto CrashlyticsInitializer.

  2. Inicialize o Crashlytics no método Start do script:

      using System.Collections;
      using System.Collections.Generic;
      using UnityEngine;
    
      // Import Firebase
      using Firebase;
    
      public class CrashlyticsInit : MonoBehaviour {
          // Use this for initialization
          void Start () {
              // Initialize Firebase
              Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
                  var dependencyStatus = task.Result;
                  if (dependencyStatus == Firebase.DependencyStatus.Available)
                  {
                      // Create and hold a reference to your FirebaseApp,
                      // where app is a Firebase.FirebaseApp property of your application class.
                      // Crashlytics will use the DefaultInstance, as well;
                      // this ensures that Crashlytics is intitialized.
                      Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                      // WARNING: Do not call Crashlytics APIs from asynchronous tasks;
                      // they are not currently supported.
    
                      // Set a flag here for indicating that your project is ready to use Firebase.
                  }
                  else
                  {
                      UnityEngine.Debug.LogError(System.String.Format(
                        "Could not resolve all Firebase dependencies: {0}",dependencyStatus));
                      // Firebase Unity SDK is not safe to use here.
                  }
              });
          }
    
        // Update is called once per frame
        void Update()
          // ...
      }

Com o SDK adicionado e inicializado, o Crashlytics automaticamente passa a detectar e coletar relatórios de erros.

Etapa 3: criar seu projeto

Depois de exportar seu projeto para o iOS ou para o Android, verifique se o projeto foi exportado corretamente.

Se parecer que faltam arquivos depois de comparar seu projeto com as configurações de exportação de amostra abaixo, abra o Editor do Unity e execute o Resolvedor do Google Play Services.

iOS

Android

Execute o resolvedor (opcional)

Como executar o resolvedor do Google Play Services

Os resolvedores do Google Play Services garantem que seu projeto do Unity tenha as dependências apropriadas para exportar seu app para iOS ou Android.{/}

Para mais informações sobre o resolvedor, acesse o README do Resolvedor Jar do Unity.

iOS

O resolvedor do iOS é executado automaticamente e utiliza o Cocoapods para colocar as dependências do iOS no diretório Pods exportado.

  • Para fazer o download do Cocoapods para sua máquina:

    • Navegue para Recursos > Resolvedor do Play Services > Resolvedor do iOS > Instalar Cocoapods
  • Para ativar ou desativar a geração de podfiles (opcional):

    • Navegue para Recursos > Resolvedor do Play Services > Resolvedor do iOS > Configurações

Android

O resolvedor do Android é executado automaticamente e aproveita o gradle para colocar as dependências do Android em Assets/Plugins/Android.

  • Para executar manualmente o resolvedor:

    • Navegue para Recursos > Resolvedor do Play Services > Resolvedor do Android > Resolvedor
  • Para ativar ou desativar a resolução automática, que fica ativada por padrão:

    • Navegue para Recursos > Resolvedor do Play Services > Resolvedor do Android > Configurações

Assistir a um tutorial em vídeo

ios

Para orientações detalhadas sobre como começar a usar o Crashlytics, assista ao seguinte tutorial em vídeo:

Encontre mais vídeos no canal no YouTube do Firebase.

android

Para orientações detalhadas sobre como começar a usar o Crashlytics, assista ao seguinte tutorial em vídeo:

Encontre mais vídeos no canal no YouTube do Firebase.

Próximas etapas

  • Testar sua implementação: teste a configuração do Crashlytics forçando uma falha para gerar um relatório de erros no Console do Firebase.

  • Personalizar relatórios de erros: o Crashlytics começa a coletar relatórios de erros automaticamente assim que você adiciona o SDK. No entanto, é possível personalizar a configuração ao incluir relatórios, registros, chaves e rastreamento de erros não fatais.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.