Suporte do Windows

Atualmente, o App Center dá suporte a diagnósticos para aplicativos UWP, WPF e WinForms. Esta seção explica a nova experiência para aplicativos UWP como parte da versão do SDK 2.5.0. Para obter mais informações sobre aplicativos WPF e WinForms, consulte os recursos de diagnóstico e o SDK do WPF/WinForms.

Plataforma Universal do Windows

O App Center dá suporte ao conjunto completo de recursos de diagnóstico para aplicativos UWP carregados localmente e da Windows Store usando o SDK 2.5.0 ou versões posteriores. Para habilitar o diagnóstico do App Center para seu aplicativo UWP, siga a documentação do SDK UWP do App Center para integrar o SDK do App Center. Você pode saber mais sobre o conjunto de recursos completo na documentação de recursos de diagnóstico.

Nova experiência de diagnóstico

Com a versão do SDK 2.5.0 em outubro de 2019, o App Center lançou uma nova experiência de diagnóstico. Esta seção detalha as melhorias e a experiência de transição com a nova versão.

Quais melhorias foram feitas?

A nova e aprimorada experiência de diagnóstico inclui as seguintes adições:

• Uma experiência de simbolização completa que permite carregar símbolos no App Center. Confira a seção de simbolização abaixo para obter mais detalhes.
• Suporte para exceções tratadas
• Número de usuários afetados por falha ou grupo de erros
• Capacidade de adicionar anotações por grupo de erros ou falha
• Capacidade de marcar grupos de erros e falhas como abertos, fechados ou ignorados
• Capacidade de baixar relatórios de falha e erro
• Capacidade de anexar, exibir e baixar um anexo binário e um texto em seus relatórios de falha
• Detalhes do relatório de falha e erro por instância de falha, incluindo quando o aplicativo foi iniciado, quando ele falhou e qual país/região e idioma o dispositivo usou

Você pode saber mais sobre cada recurso na documentação de diagnóstico do App Center.

Qual é a experiência de transição?

Depois de atualizar para o SDK UWP do App Center versão 2.5.0, você verá dados de falha e erro entrando no portal de Diagnóstico do App Center em uma interface do usuário nova e aprimorada. Para dados de falha e erro exibidos na nova interface do usuário de diagnóstico, você precisa usar as APIs listadas na seção de erros. Saiba mais sobre como as APIs de falhas antigas são mapeadas para as novas APIs de erros na documentação de transição da API.

Simbolização

Os relatórios de falha da UWP mostram o rastreamento de pilha do thread que causou a falha. Quando o aplicativo estiver usando o .NET Native (normalmente em compilações de liberação), o rastreamento de pilha poderá conter endereços de memória em vez de nomes de classe, métodos, nomes de arquivo e números de linha necessários para ler e entender os erros.

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.

Carregando símbolos

Para traduzir os endereços de memória, você precisa carregar um .appxsym arquivo no App Center, que contém todas as informações necessárias para a simbolização.

Gerar os símbolos localmente

Para obter um .appxsym arquivo, você deve criar um pacote de aplicativos, conforme descrito aqui. Depois de criar o pacote, você encontrará o arquivo de símbolos como um .appxsym arquivo dentro da pasta do pacote do aplicativo.

Símbolos para aplicativos criados no Build do App Center

Os serviços de Build e Distribuição do App Center podem gerar automaticamente um arquivo de símbolo válido e fazer upload para o 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 no App Center.

Símbolos para aplicativos publicados na Microsoft Store

Quando você publica seu aplicativo no repositório, a compilação do .NET Native ocorre no lado do servidor. Portanto, você precisa baixar os símbolos do Partner Center.

1. Localize seu aplicativo na lista e clique nele.
2. Expanda o menu Gerenciamento de produtos do painel esquerdo.
3. Clique em Gerenciar pacotes.
4. Clique em Mostrar pacotes no canto superior direito do Envio (versão) para o qual você deseja os símbolos.
5. Localize o pacote para a versão para a qual você precisa de símbolos e clique em links para todas as arquiteturas com suporte para baixar todos os símbolos (como o link Baixar arquivo de símbolo do Windows 10 (x64 ).

<PackageDependency Name="Microsoft.NET.Native.Framework.2.2" MinVersion="2.2.29512.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>
<PackageDependency Name="Microsoft.NET.Native.Runtime.2.2" MinVersion="2 2.28604.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>

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ê.

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 UWP.

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 --appxsym {symbol file}

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.

WinRT, Silverlight e outras plataformas

O App Center não dá suporte a outras plataformas windows além de UWP, WPF e WinForms. Se você tiver um aplicativo do Windows com falhas nativas do C++, poderá carregar essas falhas no App Center por meio da API de falhas de upload.