Receber relatórios de erros fáceis de entender

O Firebase Crashlytics processa automaticamente os arquivos do seu símbolo de depuração (.dSYM) para fornecer relatórios de erros legíveis e fáceis de entender.

Há algumas situações em que os uploads do dSYM falham, geralmente devido a configurações de projeto exclusivas ou a um Bitcode no seu app. Quando um upload falhar, o Crashlytics exibirá um alerta "dSYM ausente" no Console do Firebase para informar você que não é possível exibir relatórios de falhas corretamente.

Se você receber esse alerta, tente resolver o problema da seguinte maneira: verifique se o Xcode está produzindo os arquivos dSYM corretos e, caso ele esteja, execute o script de upload do dSYM manualmente.

Verificar se o Xcode está produzindo arquivos de símbolos de depuração

Com frequência, a causa da ausência dos arquivos de símbolo é o simples fato de que o Xcode parou de produzi-los. Veja como verificar se o projeto está gerando dSYMs em cada criação:

  1. Abra seu projeto no Xcode e selecione o arquivo de projeto dele no navegador.
  2. Selecione seu destino de criação principal no menu suspenso Select a project or target.
  3. Abra a guia Build Settings do destino.
  4. Clique em All perto da parte superior da guia.
  5. Procure por "debug information format".
  6. Defina Debug information format como DWARF with dSYM File.

Depois de fazer isso, compile seu aplicativo novamente e verifique o Console do Firebase para ver se o Crashlytics consegue encontrar seus dSYMs.

Execute o script de upload de símbolos manualmente

Como backup, o Crashlytics também inclui upload-symbols, um script que você pode chamar de qualquer lugar no seu processo de criação para fazer upload dos seus dSYMs manualmente. Esse script fornece mais informações sobre o processo de upload e mensagens de erro mais detalhadas.

Importante: se estiver trabalhando com um aplicativo que você vinculou anteriormente do Fabric para o Firebase Crashlytics, transmita sua chave de API do Fabric para executar o script de upload symbols. Ou seja, nas opções a seguir use -a fabric-api-key em vez de -gsp path/to/GoogleService-Info.plist para executar o script.

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

  • Inclua a seguinte linha no seu processo de criação:

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

    /path/to/pods/directory/Fabric/upload-symbols -gsp /path/to/GoogleService-Info.plist -p ios /path/to/dSYMs
  • Execute o script de uma fase de criação de script de execução no Xcode:

    "${PODS_ROOT}/Fabric/upload-symbols" -gsp "${PROJECT_DIR}/GoogleService-Info.plist" -p ios "${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}"
Observação: se você tiver problemas, execute upload-symbols sem parâmetros para receber notas de uso e mais instruções.