Simbolização do iOS

Os relatórios de erro do macOS, tvOS e iOS mostram os rastreamentos de pilha para todos os threads em execução no aplicativo no momento em que ocorreu a falha. Os rastreamentos de pilha contêm apenas endereços de memória; não nomes de classe, métodos, nomes de arquivo ou números de linha necessários para entender as falhas.

Para obter os endereços de memória traduzidos, você precisa carregar um pacote dSYM no App Center, que contém todas as informações necessárias para a simbologia. Você pode saber mais sobre a simbolização na documentação oficial do desenvolvedor da Apple.

O serviço de Build e Distribuição do App Center pode gerar automaticamente um arquivo válido de dSYM e mapa de origem .zip e carregar o arquivo no serviço de Diagnóstico. Se você usar o App Center para criar e distribuir automaticamente seu aplicativo para os usuários finais, não precisará obter e carregar manualmente os arquivos de símbolo.

Falhas não simbolicadas

Falhas não simbolizadas são exibidas na seção Diagnósticos do App Center para que você possa ver alguns detalhes antes mesmo de carregar símbolos. Os símbolos ausentes dessas falhas serão mostrados na guia "unsymbolicated". Se os símbolos ausentes forem carregados, o grupo de falhas não simbolizado será substituído por um grupo de falhas simbolizado.

Localizando o .dSYM pacote

1. No Xcode, abra o menu Janela e então selecione Organizador.
2. Selecione a guia Arquivos .
3. Selecione seu aplicativo na barra lateral esquerda.
4. Clique com o botão direito do mouse no arquivo mais recente e selecione Mostrar no Localizador.
5. Clique com o botão direito do mouse no .xcarchive arquivo no Localizador e selecione Mostrar Conteúdo do Pacote.
6. Você deve ver uma pasta nomeada dSYMs que contém seu pacote dSYM.
7. Crie um arquivo zip do pacote dSYM.

Se você estiver usando o Visual Studio em vez de Xcode, veja Onde posso encontrar o arquivo dSYM para simbolizar logs de falha do iOS? para encontrar o arquivo dSYM.

Carregando símbolos

App Center Portal

1. Faça logon no App Center e selecione seu aplicativo.
2. No menu à esquerda, navegue até a seção Diagnóstico e selecione Símbolos.
3. No canto superior direito, clique em Carregar símbolos e carregue o arquivo.
4. Depois que os símbolos forem indexados pelo App Center, as falhas serão simbolizadas para você.

Aplicativos do React Native iOS

Para obter arquivos de símbolo para arquivos iOS do React Native, crie um arquivo ZIP com o pacote dSYM no seu Mac e o mapa de origem JavaScript do seu aplicativo. O mapa de origem deve ser nomeado index.ios.map. Os comandos abaixo gerarão o mapa de origem para compilações de lançamento:

react-native bundle --entry-file index.ios.js --platform ios --dev false --reset-cache --bundle-output unused.jsbundle --sourcemap-output index.ios.map

App Center API

O processo de carregamento de símbolos por meio da API envolve uma série de três chamadas à API: uma para alocar espaço em nosso back-end, uma para carregar o arquivo e outra para atualizar o status do upload. O corpo da primeira chamada à API deve ser definido symbol_type como Apple.

1. Dispare uma POST solicitação para a API de envio_de_símbolos. Essa chamada aloca espaço em nosso back-end para seu arquivo e retorna uma propriedade symbol_upload_id e uma upload_url.

curl -X POST 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{JSON BODY}'

2. Usando a upload_url propriedade retornada da primeira etapa, faça uma PUT solicitação com o cabeçalho: "x-ms-blob-type: BlockBlob" e forneça o local do arquivo no disco. Essa chamada carrega o arquivo em nossas contas de armazenamento de back-end. Saiba mais sobre os cabeçalhos de solicitação PUT Blob.

curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'

3. Faça uma PATCH solicitação para a API symbol_uploads usando a symbol_upload_id propriedade retornada da etapa inicial. No corpo da solicitação, especifique se deseja definir o status do upload para committed (concluído com êxito) o processo de upload ou aborted (concluído sem êxito).

curl -X PATCH 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads/{symbol_upload_id}' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{ "status": "committed" }'

App Center CLI

Você também pode usar a CLI para carregar arquivos de símbolo:

appcenter crashes upload-symbols --symbol {symbol file}

Bitcode

O Bitcode foi introduzido pela Apple para permitir que os aplicativos enviados à App Store sejam recompilados pela própria Apple e apliquem a otimização mais recente. Se o Bitcode estiver habilitado, os símbolos gerados para seu aplicativo na loja serão diferentes dos do seu próprio sistema de build.

Os relatórios de falhas do App Center ainda não dão suporte completo à simbolicação de falhas de aplicativos habilitados para bitcode. Enquanto isso, aconselhamos que você desabilite o bitcode. Desabilitar o bitcode simplifica significativamente o gerenciamento de símbolos e atualmente não tem nenhuma desvantagem conhecida para aplicativos iOS.

Desabilitar o bitcode para seu aplicativo

1. No Xcode, abra as configurações do projeto clicando no elemento de nível superior no Project Navigator
2. Ir para a página Configurações de Build
3. Pesquise por bitcode
4. No resultado, altere o valor de Sim para Não
5. Reconstruir o seu aplicativo

Com essas etapas simples, os relatórios de falha do App Center se comportarão como de costume.

Recuperar símbolos para aplicativos habilitados para bitcode

Se você quiser manter o bitcode habilitado, baixe os arquivos dSYM adequados seguindo estas etapas:

1. Abrir o Organizador do Xcode
2. Selecione o arquivo específico do seu aplicativo que você enviou para o iTunes Connect
3. Clique no botão "Baixar dSYMs". Esta etapa inserirá os arquivos dSYM compilados do Bitcode no arquivo original.
4. Carregar os símbolos para o aplicativo e a versão correspondentes no App Center

Se o organizador do Xcode não fornecer novos símbolos, você deverá baixar os arquivos dSYM no portal do iTunes Connect seguindo estas etapas:

1. Selecione seu aplicativo no portal do iTunes Connect
2. Selecione a guia Atividade na parte superior
3. Selecione a versão de build do seu aplicativo que tem os símbolos ausentes
4. Clique no link Baixar dSYM
5. Carregue o arquivo baixado no App Center. Esse arquivo contém os símbolos necessários para que o App Center simbolize suas falhas.

Solução de problemas de símbolo

Se suas falhas ainda aparecerem sem símbolos depois de carregar os símbolos e desabilitar o bitcode, pode ser porque os arquivos dSYM carregados não correspondem aos exigidos pelo App Center. Quando você carrega arquivos dSYM, o App Center os corresponde à versão certa do aplicativo com base em suas UUIDs.

Você pode verificar se os arquivos dSYM têm os UUIDs certos usando uma ferramenta da CLI chamada dwarfdump.

1. Localize a UUID no arquivo dSYM:

dwarfdump --u CrashProbeiOS.app.dSYM

2. O resultado deve ser semelhante a este:

UUID:ADF53C85-4638-3EFF-A33C-42C13A18E915 (armv7)CrashProbeiOS.app.dSYM/Contents/Resources/DWARF/CrashProbeiOS
UUID:D449E33D-7E74-379D-8B79-15EE104ED1DF (arm64)CrashProbeiOS.app.dSYM/Contents/Resources/DWARF/CrashProbeiOS

3. Verifique se a UUID retornada corresponde aos UUIDs mostrados na caixa de diálogo símbolos de depuração:

Ignorando símbolos

Quando o App Center não possui todos os arquivos de símbolo para simbolizar completamente os relatórios de falha, as falhas são listadas na guia Não simbolicada. Os símbolos necessários são carregados nesta página se você tiver acesso a eles.

Se você não puder carregar os símbolos, poderá marcá-los como Ignorados selecionando linhas na tabela e clicando no botão Ignorar versões . Este botão informa ao App Center para processar as falhas e simbolicá-las da forma mais completa possível com os símbolos em arquivo. Depois de terminarem o processamento, eles aparecerão na guia Falhas parcialmente simbolizados. Novas falhas que também dependem dessas mesmas IDs de símbolo marcadas como ignoradas serão ignoradas ao entrarem e circularem pelo sistema e não aparecerão na guia Não Simbolizado.