Condividi tramite

Supporto di Windows

  • Articolo

Importante

Visual Studio App Center è pianificato per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate a cui è possibile considerare la migrazione.

Altre informazioni sulle sequenze temporali e sulle alternative di supporto.

App Center supporta attualmente la diagnostica per le applicazioni UWP, WPF e WinForms. Questa sezione illustra la nuova esperienza per le app UWP come parte della versione 2.5.0 SDK. Per altre informazioni sulle applicazioni WPF e WinForms, vedere Funzionalità di diagnostica e WPF/WinForms SDK.

Piattaforma UWP (Universal Windows Platform)

App Center supporta il set completo di funzionalità di diagnostica sia per le app UWP di Windows Store che per le app UWP di Windows Store che usano l'SDK 2.5.0 o versioni successive. Per abilitare la diagnostica di App Center per la tua app UWP, segui la documentazione dell'SDK UWP di App Center per integrare App Center SDK. Per altre informazioni sul set di funzionalità completo, vedere la documentazione sulle funzionalità di diagnostica.

Nuova esperienza di diagnostica

Con la versione 2.5.0 SDK di ottobre 2019, App Center ha rilasciato una nuova esperienza di diagnostica. Questa sezione illustra in dettaglio i miglioramenti e l'esperienza di transizione con la nuova versione.

Quali miglioramenti sono stati apportati?

L'esperienza di diagnostica nuova e migliorata include le aggiunte seguenti:

  • Un'esperienza simbolica completa che consente di caricare simboli in App Center. Per altri dettagli, vedere la sezione simbolica di seguito.
  • Supporto per le eccezioni gestite
  • Numero di utenti interessati per arresto anomalo o gruppo di errori
  • Possibilità di aggiungere annotazioni per arresto anomalo o gruppo di errori
  • Possibilità di contrassegnare i gruppi di errori e di arresto anomalo del sistema come aperti, chiusi o ignorati
  • Possibilità di scaricare segnalazioni di errori e arresti anomali
  • Possibilità di allegare, visualizzare e scaricare un file binario e un allegato di testo ai report di arresto anomalo del sistema
  • Dettagli del report sugli arresti anomali e sugli errori per ogni istanza di arresto anomalo, inclusi l'avvio dell'app, l'arresto anomalo e il paese/area geografica e la lingua usati dal dispositivo

Per altre informazioni su ogni funzionalità, vedere la documentazione di diagnostica di App Center.

Qual è l'esperienza di transizione?

Dopo l'aggiornamento all'SDK UWP di App Center versione 2.5.0, verranno visualizzati i dati relativi all'arresto anomalo e agli errori che arrivano nel portale di diagnostica di App Center in un'interfaccia utente nuova e migliorata. Per i dati relativi all'arresto anomalo e agli errori visualizzati nella nuova interfaccia utente di diagnostica, è necessario usare le API elencate nella sezione errori. Altre informazioni su come le API di arresto anomalo precedenti eseguono il mapping alle nuove API di errore nella documentazione sulla transizione api.

Simbolica

I report di arresto anomalo della piattaforma UWP mostrano l'analisi dello stack per il thread che ha causato l'arresto anomalo. Quando l'applicazione usa .NET Native (in genere nelle build di versione) l'analisi dello stack può contenere indirizzi di memoria anziché nomi di classe, metodi, nomi di file e numeri di riga necessari per leggere e comprendere gli arresti anomali.

Arresti anomali nonmbolicati

Gli arresti anomali non ridimensionati vengono visualizzati nella sezione Diagnostica di App Center, in modo da poter visualizzare alcuni dettagli anche prima di caricare i simboli. I simboli mancanti di questi arresti anomali verranno visualizzati nella scheda "nonmbolicata". Se vengono caricati i simboli mancanti, il gruppo di arresti anomali non associati verrà sostituito da un gruppo di arresti anomali simbolici.

Caricamento di simboli

Per ottenere gli indirizzi di memoria tradotti, è necessario caricare un .appxsym file in App Center, che contiene tutte le informazioni necessarie per la simbolicazione.

Generare i simboli in locale

Per ottenere un .appxsym file, è necessario creare un bundle di app come descritto qui. Dopo aver creato il bundle, troverai il file dei simboli come .appxsym file all'interno della cartella bundle dell'app.

Simboli per le applicazioni compilate in App Center Build

I servizi di compilazione e distribuzione di App Center possono generare automaticamente un file di simboli valido e caricarlo nel servizio Diagnostica. Se si usa App Center per compilare e distribuire automaticamente l'app agli utenti finali, non è necessario ottenere e caricare manualmente i file di simboli in App Center.

Simboli per le applicazioni pubblicate in Microsoft Store

Quando si pubblica l'applicazione nell'archivio, la compilazione .NET Native viene eseguita sul lato server. È quindi necessario scaricare i simboli dal Centro per i partner.

  1. Individuare l'applicazione nell'elenco e fare clic su di essa.
  2. Espandere Il menu Gestione prodotti nel pannello a sinistra.
  3. Fare clic su Gestisci pacchetti.
  4. Fare clic su Mostra pacchetti nell'angolo in alto a destra per l'invio (versione) per cui si desiderano i simboli.
  5. Individuare il pacchetto per la versione per cui sono necessari i simboli e fare clic sui collegamenti per tutte le architetture supportate per scaricare tutti i simboli ,ad esempio il collegamento Scarica file di simboli di Windows 10 (x64).

Nota

L'applicazione deve dichiarare una dipendenza da qualsiasi versione di .NET Native per generare simboli di debug. Questa dichiarazione deve essere inclusa nella <Dependencies> sezione di AppxManifest.xml. Esempio:

<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"/>

Portale di App Center

  1. Accedere ad App Center e selezionare l'app.
  2. Nel menu a sinistra passare alla sezione Diagnostica e selezionare Simboli.
  3. Nell'angolo superiore destro fare clic su Carica simboli e caricare il file.
  4. Dopo che i simboli vengono indicizzati da App Center, gli arresti anomali verranno simbolici automaticamente.

App Center API

Il processo di caricamento dei simboli tramite l'API prevede una serie di tre chiamate API: una per allocare spazio nel back-end, una per caricare il file e una per aggiornare lo stato del caricamento. Il corpo della prima chiamata API deve essere impostato su symbol_typeUWP.

  1. Attivare una POST richiesta all'API symbol_uploads. Questa chiamata alloca spazio nel back-end per il file e restituisce upload_url una symbol_upload_id proprietà e .
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 la upload_url proprietà restituita dal primo passaggio, effettuare una PUT richiesta con l'intestazione e "x-ms-blob-type: BlockBlob" specificare il percorso del file su disco. Questa chiamata carica il file negli account di archiviazione back-end. Altre informazioni sulle intestazioni della richiesta BLOB PUT.
curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'
  1. Effettuare una PATCH richiesta all'API symbol_uploads usando la symbol_upload_id proprietà restituita dal primo passaggio. Nel corpo della richiesta specificare se si desidera impostare lo stato del caricamento committed su (completato correttamente) il processo di caricamento o aborted (completato senza esito positivo).
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" }'

Nota

L'API di caricamento dei simboli non funziona per i file di dimensioni superiori a 256 MB. Usare l'interfaccia della riga di comando di App Center per caricare questi file. È possibile installare l'interfaccia della riga di comando di App Center seguendo le istruzioni nel repository dell'interfaccia della riga di comando di App Center.

Interfaccia della riga di comando di App Center

È anche possibile usare l'interfaccia della riga di comando per caricare i file di simboli:

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

Ignorare i simboli

Quando App Center non dispone di tutti i file di simboli per generare report di arresto anomalo completamente simbolici, gli arresti anomali vengono elencati nella scheda Non allineata . I simboli obbligatori vengono caricati da questa pagina se è possibile accedervi.

Se non è possibile caricare i simboli, è possibile contrassegnarli come Ignorati selezionando le righe nella tabella e facendo clic sul pulsante Ignora versioni . Questo pulsante indica ad App Center di elaborare gli arresti anomali e di simbolicarli il più possibile con i simboli nel file. Al termine dell'elaborazione, verranno visualizzati nella scheda Arresti anomali parzialmente simbolici. I nuovi arresti anomali che dipendono anche da quegli stessi ID simbolo contrassegnati come ignorati ignorano la scheda Non in rilievo mentre arrivano e passano attraverso il sistema.

WinRT, Silverlight e altre piattaforme

App Center non supporta altre piattaforme Windows oltre a UWP, WPF e WinForms. Se si dispone di un'app di Windows con arresti anomali C++ nativi, è possibile caricare questi arresti anomali in App Center tramite l'API di caricamento arresti anomali.