O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Receber relatórios de falhas desofuscados com o SDK do Firebase Crashlytics

Por padrão, o Firebase Crashlytics processa automaticamente seus arquivos de símbolo de depuração (dSYM, na sigla em inglês) para gerar relatórios de falhas desofuscados e legíveis. Esse comportamento é definido quando você adiciona um script de execução que inicializa o Crashlytics na fase de compilação do app.

Infelizmente, há alguns casos que podem fazer com que o upload do dSYM falhe, como bitcode no seu app ou outras configurações exclusivas do projeto. Este guia fornece algumas maneiras de resolver problemas quando o Crashlytics não consegue localizar o dSYM do seu app.

Verificar se o Xcode está produzindo dSYMs

Com frequência, a causa da ausência dos arquivos dSYM é o simples fato de que o Xcode parou de produzi-los. Quando um upload falha, o Crashlytics exibe um alerta "dSYM ausente" no Console do Firebase. Se você receber esse alerta, primeiro verifique se o Xcode está produzindo o dSYM correto para cada build:

  1. Abra seu projeto no Xcode e selecione o arquivo de projeto dele no navegador.

  2. Selecione o arquivo de destino principal do build.

  3. Abra a guia Build Settings do destino e clique em All.

  4. Procure por "debug information format".

  5. Defina Debug Information Format como DWARF with dSYM File para todos os tipos de builds.

  6. Recompile seu app.

Seus relatórios de erros serão exibidos no Console do Firebase. Se o problema persistir ou você encontrar outros erros, tente localizar seu dSYM e fazer o upload dele manualmente no Crashlytics.

Localizar seus dSYMs

Às vezes, o Crashlytics não consegue localizar o dSYM do app devido a configurações de bitcode ou à conectividade do console. Quando isso acontece, há duas maneiras de resolver problemas:

Fazer upload dos seus dSYMs

Como backup, o Crashlytics inclui um script upload-symbols que pode ser chamado de qualquer lugar no processo de compilação para fazer upload manual dos dSYMs. O script fornece mais informações sobre o processo de upload e mensagens de erro mais eficientes (para outras notas de uso e instruções, execute upload-symbols sem parâmetros).

Para executar o script upload-symbols, use uma das seguintes opções:

  1. Inclua a seguinte linha no seu processo de compilação:

    find dSYM_directory -name "*.dSYM" | xargs -I \{\} $PODS_ROOT/FirebaseCrashlytics/upload-symbols -gsp /path/to/GoogleService-Info.plist -p platform \{\}
  2. Execute o script diretamente no seu terminal:

    /path/to/pods/directory/FirebaseCrashlytics/upload-symbols -gsp /path/to/GoogleService-Info.plist -p ios /path/to/dSYMs