Obtenha relatórios de falhas do Android NDK

Veja as instruções para esta opção

A tarefa padrão de upload de símbolos do Crashlytics pressupõe que você esteja criando suas bibliotecas nativas como parte da compilação Gradle do módulo do seu aplicativo, usando ferramentas de compilação padrão do NDK, como o CMake.

No entanto, se você estiver usando um processo de compilação NDK personalizado no Gradle ou se suas bibliotecas nativas forem criadas em um módulo de biblioteca/recurso ou fornecidas por terceiros, talvez seja necessário especificar explicitamente o caminho para suas bibliotecas não removidas. Para fazer isso, você pode adicionar a propriedade unstrippedNativeLibsDir na extensão Crashlytics em seu arquivo de compilação do Gradle.

1. Certifique-se de ter concluído as seguintes tarefas iniciais do fluxo de trabalho principal anteriormente nesta página:

   1. Ativado o Crashlytics no console do Firebase.

   2. Adicionados o Crashlytics SDK para NDK e o plug-in Crashlytics Gradle .

   3. Adicionada a extensão Crashlytics ao seu build.

   4. Configure o upload automático de símbolos nativos.

2. Para que a tarefa de upload automático de símbolos possa encontrar as informações do seu símbolo, adicione o seguinte ao arquivo Gradle do módulo (nível do aplicativo) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle ):

   Kotlin

   import com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension
   
   // ...
   
   android {
       // ...
       buildTypes {
           release {
               configure<CrashlyticsExtension> {
                   nativeSymbolUploadEnabled = true
                   unstrippedNativeLibsDir = file("PATH/TO/UNSTRIPPED/DIRECTORY")
               }
           }
       }
   }
   

   Groovy

   // ...
   
   android {
       // ...
       buildTypes {
           release {
               firebaseCrashlytics {
                   nativeSymbolUploadEnabled true
                   unstrippedNativeLibsDir file("PATH/TO/UNSTRIPPED/DIRECTORY")
               }
           }
       }
   }
   

   O plug-in Crashlytics pesquisará recursivamente no diretório especificado em busca de bibliotecas nativas com uma extensão .so . O Crashlytics então extrai símbolos de depuração de todas essas bibliotecas e os carrega nos servidores Firebase.

   Aqui está o que você pode especificar na propriedade unstrippedNativeLibsDir :

   • Qualquer argumento permitido para org.gradle.api.Project#files(Object...) , incluindo: java.lang.String , java.io.File ou org.gradle.api.file.FileCollection

   • Vários diretórios para um único tipo de compilação, fornecendo uma lista ou instância FileCollection

3. Por fim, force uma falha de teste para concluir a configuração do Crashlytics e ver os dados iniciais no painel do Crashlytics do console do Firebase.

Veja as instruções para esta opção

Esta opção requer que você execute um comando Firebase CLI ao criar uma versão ou qualquer compilação para a qual deseja ver rastreamentos de pilha simbolizados no console do Firebase.

1. Certifique-se de ter concluído as seguintes tarefas iniciais do fluxo de trabalho principal anteriormente nesta página:

   1. Ativado o Crashlytics no console do Firebase.

   2. Adicionados o Crashlytics SDK para NDK e o plug-in Crashlytics Gradle .

   Observe que, com esta opção, você não precisa adicionar a extensão firebaseCrashlytics ou configurar o upload automático de símbolos porque, em vez disso, usará a CLI do Firebase (próximas etapas abaixo) para gerar e fazer upload de seus arquivos de símbolos.

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. Adicione o seguinte atributo à tag do aplicativo: <application android:allowNativeHeapPointerTagging="false" ... />

3. Construa seu projeto.

4. Carregue as informações dos seus símbolos.

   Assim que a compilação for concluída, gere um arquivo de símbolo compatível com Crashlytics e faça upload dele nos 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

     Precisa encontrar o ID do seu aplicativo Firebase?

     Aqui estão duas maneiras de encontrar seu ID do aplicativo Firebase:

     • No arquivo google-services.json , o ID do aplicativo é o valor mobilesdk_app_id ; ou

     • No console do Firebase, acesse as configurações do projeto . Role para baixo até o cartão Seus aplicativos e clique no aplicativo Firebase desejado para encontrar seu ID do aplicativo.

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

     • Exportado para um projeto Android Studio — PATH/TO/SYMBOLS pode ser qualquer diretório. A CLI do Firebase pesquisará recursivamente no diretório especificado em busca de bibliotecas nativas com uma extensão .so .

     • 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

5. Por fim, force uma falha de teste para concluir a configuração do Crashlytics e ver os dados iniciais no painel do Crashlytics do console do Firebase.

   Depois de criar seu aplicativo como parte do processo de forçar uma falha, execute o comando crashlytics:symbols:upload da CLI do Firebase para fazer upload do arquivo de símbolo.