Partilhar via

Suporte do Windows

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

Atualmente, o App Center oferece 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 2.5.0 do SDK. Para obter mais informações sobre aplicativos WPF e WinForms, consulte recursos de diagnóstico e WPF/WinForms SDK.

Plataforma Universal do Windows

O App Center oferece suporte ao conjunto completo de recursos de diagnóstico para aplicativos UWP de sideloaded 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 completo de recursos na documentação de recursos de diagnóstico.

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 de diagnóstico. Esta seção detalha as melhorias e a experiência de transição com a nova versão.

Que melhorias foram introduzidas?

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

  • Uma experiência de simbologia completa que lhe permite carregar símbolos no App Center. Consulte a seção de simbologia 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 falha ou grupo de erros
  • Capacidade de marcar grupos de falhas e erros como abertos, fechados ou ignorados
  • Capacidade de baixar relatórios de falhas e erros
  • Capacidade de anexar, visualizar e baixar um binário e um anexo de texto aos seus relatórios de falhas
  • Detalhes do relatório de falhas e erros por instância de falha, incluindo quando o aplicativo foi iniciado, quando travou 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 falhas e erros entrando no portal de Diagnóstico do App Center em uma interface do usuário nova e aprimorada. Para dados de falhas e erros 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 de API.

Simbologia

Os relatórios de falha da UWP mostram o rastreamento de pilha para o thread que causou a falha. Quando o aplicativo está usando o .NET Native (normalmente em compilações 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 simbólicas

As falhas não simbólicas são exibidas na seção Diagnóstico do App Center para que você possa visualizar alguns detalhes antes mesmo de carregar símbolos. Os símbolos ausentes dessas falhas serão mostrados no separador "não simbolizado". 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 obter os endereços de memória traduzidos, você precisa carregar um .appxsym arquivo para o App Center, que contém todas as informações necessárias para a simbologia.

Gere 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 de aplicativos.

Símbolos para aplicativos criados no App Center Build

Os serviços de compilação 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 seus 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 se publica uma aplicação na loja, a compilação .NET Native ocorre no servidor. Então, você precisa baixar os símbolos do Partner Center.

  1. Localize o 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 da Submissão (versão) para a qual 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 suportadas para baixar todos os símbolos (como o link Baixar arquivo de símbolos do Windows 10 (x64 )).

Observação

A sua aplicação deve declarar uma dependência de qualquer versão do .NET Native para gerar símbolos de debug. Esta declaração deve ser incluída na <Dependencies> seção do seu AppxManifest.xml. Exemplo:

<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. Inicie sessão no App Center e selecione a sua aplicação.
  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 ficheiro.
  4. Depois que os símbolos forem indexados pelo App Center, as falhas serão simbolizadas para você.

App Center API

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

  1. Inicie uma POST solicitação para a API symbol_uploads. Esta chamada aloca espaço no nosso backend para o seu ficheiro e retorna uma propriedade symbol_upload_id e uma propriedade 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}'
  1. 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. Esta chamada carrega o arquivo para nossas contas de armazenamento de back-end. Saiba mais sobre cabeçalhos de solicitação de Blob PUT .
curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'
  1. Faça uma PATCH solicitação à 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 carregamento 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

O carregamento de símbolos na API não funciona para ficheiros 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ímbolos para simbolizar totalmente os relatórios de falhas, as falhas são listadas na guia Não simbolizado . Os símbolos necessários são carregados a partir desta página se você tiver acesso a eles.

Se não conseguir carregar os símbolos, pode marcá-los como Ignorados selecionando linhas na tabela e clicando no botão Ignorar versões . Este botão instrui o App Center para processar os crashes e simbolizá-los da forma mais exaustiva possível com os símbolos nos arquivos. Quando terminarem o processamento, eles aparecerão na guia Falhas parcialmente simbolizados. Novas falhas que também dependem desses mesmos IDs de símbolo marcados como ignorados ignorarão a guia Não simbólica à medida que entram e fluem pelo sistema.

WinRT, Silverlight e outras plataformas

O App Center não suporta nenhuma outra plataforma Windows além de UWP, WPF e WinForms. Se tiver uma aplicação do Windows com falhas C++ nativas, pode carregar essas falhas para o App Center através da API de falhas de carregamento.

  • Last updated on