Obtenha relatórios de falhas legíveis no painel do Crashlytics

iOS+ (plataformas Apple)

Para aplicativos da plataforma Apple que usam o Crashlytics Unity SDK 8.2.0+, o plug-in Firebase Unity Editor configura automaticamente seu projeto Xcode para fazer upload de símbolos. Baixe a versão mais recente.

Android

Para aplicativos Android, o Crashlytics Unity SDK 8.6.1+ inclui automaticamente relatórios de falhas do NDK, o que permite que o Crashlytics relate automaticamente falhas do Unity IL2CPP no Android. No entanto, para ver rastreamentos de pilha simbolizados para falhas de bibliotecas nativas no painel do Crashlytics, você deve fazer upload das informações do símbolo no momento da criação usando a CLI do Firebase.

  1. Certifique-se de estar usando o SDK do Crashlytics Unity v8.6.1 ou posterior. Baixe a versão mais recente.

  2. Configure seu ambiente e projeto para upload de símbolos:

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

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

    2. (apenas para aplicativos que usam Android API nível 30+) Atualize o modelo AndroidManifest.xml do seu aplicativo para desativar a marcação de ponteiro:

      1. Marque a caixa Android Player Settings > Publishing Settings > Build > Custom Main Manifest .

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

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

  3. Construa seu projeto e carregue símbolos.

    Conclua estas etapas sempre que criar um build de lançamento ou qualquer build para o qual deseja ver rastreamentos de pilha simbolizados no Console do Firebase.

    1. Na caixa de diálogo Configurações de compilação , siga um destes procedimentos:

      • Exporte para um projeto do Android Studio para construir seu projeto; ou

      • Crie seu APK diretamente do Unity Editor.
        Antes de construir, certifique-se de que a caixa de seleção Criar símbolos.zip esteja marcada na caixa de diálogo Configurações de construção .

    2. Assim que a compilação for concluída, gere um arquivo de símbolo compatível com Crashlytics e faça upload dele para os servidores do Firebase executando o seguinte comando Firebase CLI:

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

      • FIREBASE_APP_ID : seu ID do aplicativo Android do Firebase (não o nome do seu pacote)
        Exemplo de ID do aplicativo 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ê cria o aplicativo via Gradle ou Android Studio.

        • Construído o APK diretamente do Unity — PATH/TO/SYMBOLS é o caminho do arquivo de símbolo compactado gerado no diretório raiz do projeto quando sua compilação foi concluída (por exemplo: myproject/myapp-1.0-v100.symbols.zip ).

      Veja opções avançadas para usar o comando Firebase CLI para geração e upload de arquivos de símbolos

      Bandeira Descrição
      --generator=csym

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

      Não recomendado para uso. Recomendamos usar o gerador de arquivo de símbolos Breakpad padrão.

      --generator=breakpad

      Usa o gerador de arquivo de símbolos Breakpad

      Observe que o padrão para geração de arquivos de símbolos é Breakpad. Use este sinalizador apenas se você adicionou symbolGenerator { csym() } em sua configuração de compilação e você deseja substituí-lo para usar o Breakpad.

      --dry-run

      Gera os arquivos de símbolos, mas não os carrega

      Este sinalizador é útil se você deseja inspecionar o conteúdo dos arquivos enviados.

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