Receber relatórios de erros legíveis no painel do Crashlytics

iOS+ (plataformas da Apple)

Em apps da plataforma Apple que usam o SDK do Crashlytics para Unity 8.2.0 ou versões posteriores, o plug-in do editor do Firebase para Unity configura automaticamente seu projeto do Xcode para fazer upload de símbolos. Faça o download da versão mais atual.

Android

Para apps Android, o SDK do Crashlytics para Unity 8.6.1 ou versões posteriores inclui automaticamente os relatórios de erros do NDK, que permitem ao Crashlytics reportar automaticamente as falhas do IL2CPP do Unity no Android. No entanto, para ver stack traces simbolizados para falhas da biblioteca nativa no painel do Crashlytics, faça upload das informações de símbolos no momento da compilação usando a CLI do Firebase.

  1. Verifique se você está usando o SDK do Crashlytics para Unity v8.6.1 ou posterior. Faça o download da versão mais atual.

  2. Configure seu ambiente e projeto para fazer o upload dos símbolos:

    1. Siga as instruções para instalar a CLI do Firebase.

      Se você já instalou a CLI, atualize-a para a versão mais recente.

    2. (somente para apps que usam o nível 30 da API do Android ou níveis acima desse) Atualize o modelo AndroidManifest.xml do seu app para desativar a inclusão de tags do ponteiro:

      1. Marque a caixa de seleção de Android Player Settings > Publishing Settings > Build > Custom Main Manifest.

      2. Abra o modelo de manifesto localizado em Assets/Plugins/Android/AndroidManifest.xml.

      3. (apenas para apps que usam uma versão do SDK anterior à 8.8.0) Adicione o seguinte atributo à tag do aplicativo: <application android:allowNativeHeapPointerTagging="false" ... />

  3. Crie seu projeto e faça o upload dos símbolos.

    Siga estas etapas sempre que você criar um build de lançamento ou qualquer build com stack traces que você queira ver simbolizados no Console do Firebase.

    1. Na caixa de diálogo Build Settings, siga um destes procedimentos:

      • Exporte para o Android Studio para criar seu projeto ou

      • Crie seu APK diretamente no Editor do Unity.
        Antes de começar a criar, verifique se a caixa de seleção Create symbols.zip está marcada na caixa de diálogo Build Settings.

    2. Quando o build estiver concluído, gere um arquivo de símbolos compatível com o Crashlytics e faça upload dele para os servidores do Firebase. Para isso, execute o seguinte comando na CLI do Firebase:

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: seu ID do app Android do Firebase (não o nome do pacote)
        Exemplo de ID do app Android do Firebase: 1:567383003300:android:17104a2ced0c9b9b

      • PATH/TO/SYMBOLS: o caminho para o arquivo de símbolos gerado pela CLI

        • Exportado para um projeto do Android Studio: PATH/TO/SYMBOLS é o diretório unityLibrary/symbols, que é criado na raiz do projeto exportado depois que você compila o app usando o Gradle ou o Android Studio.

        • Crie o APK diretamente no Unity: PATH/TO/SYMBOLS é o caminho do arquivo de símbolos compactado gerado no diretório raiz do projeto quando o build foi concluído (por exemplo: myproject/myapp-1.0-v100.symbols.zip).

      Veja opções avançadas para usar o comando da CLI do Firebase para gerar e fazer upload de arquivos de símbolos

      Flag Descrição
      --generator=csym

      Usa o gerador de arquivos de símbolo legado do cSYM em vez do gerador padrão do Breakpad.

      Não recomendado. Recomendamos o uso do gerador de arquivos de símbolo padrão do Breakpad.

      --generator=breakpad

      Usa o gerador de arquivos de símbolo do Breakpad

      O padrão para a geração de arquivos de símbolo é o Breakpad. Use essa sinalização apenas se você tiver adicionado symbolGenerator { csym() } à configuração do build e quiser substitui-la para utilizar o Breakpad.

      --dry-run

      Gera os arquivos de símbolo, mas não faz upload deles

      Essa sinalização é útil se você quiser inspecionar o conteúdo dos arquivos enviados.

      --debug Fornece informações de depuração adicionais