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

iOS Android Flutter Unity

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 erros 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:

mdfind -name .dSYM | while read -r line; do dwarfdump -u "$line"; done

Fazer upload dos seus dSYMs

Para fazer o upload manual dos seus arquivos dSYMs, use a opção "Arraste e solte" do console para enviar um arquivo ZIP com os dSYM. Acesse o Console do Firebase > Crashlytics > guia dSYMs.

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

Ao fazer upload de dSYMs de bitcode, pode ser útil remover todos os arquivos de ícone do arquivo ZIP. Para fazer isso, execute:

unzip appDsyms.zip
cd appDsyms rm -rf $(find . | grep Icon)
# Enumerate all the dSYMs
upload-symbols ... $(ls)

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

• Inclua a linha a seguir 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 \{\}

• 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