Suporte do Windows

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Atualmente, o App Center dá suporte a diagnóstico 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 diagnóstico recursos e SDK do WPF/WinForms.

Plataforma Universal do Windows

O App Center dá suporte ao conjunto completo de recursos diagnóstico para aplicativos UWP da Windows Store e sideload usando o SDK 2.5.0 ou versões posteriores. Para habilitar a 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 diagnóstico recursos.

Nova experiência de diagnóstico

Com a versão 2.5.0 do SDK em outubro de 2019, o App Center lançou uma nova experiência diagnóstico. Esta seção detalha os aprimoramentos 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. Consulte a seção de simbólica 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 erros e falhas
• Capacidade de anexar, exibir e baixar um binário e um anexo de texto para 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 diagnóstico do App Center.

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

Depois de atualizar para o SDK do App Center UWP 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 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 está usando .NET Native (normalmente em builds de versão), o rastreamento de pilha pode 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 as falhas.

Falhas não esmbolicadas

Falhas não síndlicas são exibidas na seção Diagnóstico do App Center para que você possa exibir 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 gerado será substituído por um grupo de falhas simbólico.

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 simbólica.

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 carregar no serviço de Diagnóstico. Se você usar o App Center para compilar e distribuir automaticamente seu aplicativo para os usuários finais, não será necessário 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 .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 no painel esquerdo.
3. Clique em Gerenciar pacotes.
4. Clique em Mostrar pacotes no canto superior direito para o Envio (versão) para o qual você deseja 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 Windows 10 arquivo de símbolo (x64).

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 simbólicas 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 symbol_uploads. Essa chamada aloca espaço em nosso back-end para seu arquivo e retorna uma symbol_upload_id propriedade e 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 e "x-ms-blob-type: BlockBlob" forneça o local do arquivo no disco. Essa chamada carrega o arquivo em nossas contas de armazenamento de back-end. Saiba mais sobre 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 primeira etapa. No corpo da solicitação, especifique se deseja definir o status do upload como committed (concluído com êxito) o processo de carregamento 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" }'

Observação

A API de uploads de símbolo não funciona para arquivos maiores que 256 MB. Use a CLI do App Center para carregar esses arquivos. Você pode instalar a CLI do App Center seguindo as instruções em nosso repositório da CLI do App Center.

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 tem todos os arquivos de símbolo para simbolizar totalmente os relatórios de falha, as falhas são listadas na guia Não sincronizado . Os símbolos necessários serão carregados desta página se você tiver acesso a eles.

Se você não conseguir carregar os símbolos, poderá marcá-los como Ignorados selecionando linhas na tabela e clicando no botão Ignorar versões . Esse botão informa ao App Center para processar as falhas e simbolizá-las o máximo possível com os símbolos no arquivo. Depois de terminar o processamento, eles aparecerão na guia Falhas parcialmente simbólica. Novas falhas que também dependem dessas mesmas IDs de símbolo marcadas como ignoradas ignorarão a guia Não modificado à medida que entram e fluem pelo sistema.

WinRT, Silverlight e outras plataformas

O App Center não dá suporte a nenhuma outra plataforma 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.