Share via

Windows-Unterstützung

  • Artikel

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

App Center unterstützt derzeit Diagnose für UWP-, WPF- und WinForms-Anwendungen. In diesem Abschnitt wird die neue Benutzeroberfläche für UWP-Apps im Rahmen der SDK-Version 2.5.0 erläutert. Weitere Informationen zu WPF- und WinForms-Anwendungen finden Sie unter Diagnose Features und WPF/WinForms SDK.

Universelle Windows-Plattform

App Center unterstützt den vollständigen featuresatz Diagnose sowohl für quergeladene Apps als auch für Windows Store-UWP-Apps, die das SDK 2.5.0 oder höhere Versionen verwenden. Informationen zum Aktivieren der app Center-Diagnose für Ihre UWP-App finden Sie in der UWP SDK-Dokumentation von App Center, um das App Center SDK zu integrieren. Weitere Informationen zum vollständigen Featuresatz finden Sie in der Dokumentation zu Diagnose Features.

Neue benutzeroberfläche für Diagnose

Mit dem Release 2.5.0 SDK im Oktober 2019 hat App Center eine neue Diagnose-Oberfläche veröffentlicht. In diesem Abschnitt werden die Verbesserungen und die Übergangserfahrung mit dem neuen Release beschrieben.

Welche Verbesserungen wurden vorgenommen?

Die neue und verbesserte Diagnose-Benutzeroberfläche umfasst die folgenden Ergänzungen:

  • Eine vollständige Symbolik, mit der Sie Symbole in App Center hochladen können. Weitere Informationen finden Sie weiter unten im Abschnitt symbolisch.
  • Unterstützung für behandelte Ausnahmen
  • Anzahl der betroffenen Benutzer pro Absturz oder Fehlergruppe
  • Möglichkeit zum Hinzufügen von Anmerkungen pro Absturz oder Fehlergruppe
  • Möglichkeit, Absturz- und Fehlergruppen als geöffnet, geschlossen oder ignoriert zu markieren
  • Möglichkeit zum Herunterladen von Absturz- und Fehlerberichten
  • Möglichkeit zum Anfügen, Anzeigen und Herunterladen einer Binärdatei und einer Textanlage an Ihre Absturzberichte
  • Details zu Absturz- und Fehlerberichten pro Absturz instance, einschließlich wann die App gestartet wurde, wann sie abstürzt, welches Land/welche Region und welche Sprache das Gerät verwendet hat

Weitere Informationen zu den einzelnen Features finden Sie in der Dokumentation zu App Center Diagnose.

Wie sieht die Übergangserfahrung aus?

Nach dem Update auf app Center UWP SDK Version 2.5.0 werden Absturz- und Fehlerdaten im App Center-Diagnoseportal in einer neuen und verbesserten Benutzeroberfläche angezeigt. Für Absturz- und Fehlerdaten, die auf der neuen Diagnose-Benutzeroberfläche angezeigt werden, müssen Sie die apIs verwenden, die im Abschnitt "Fehler" aufgeführt sind. Weitere Informationen dazu, wie die alten Absturz-APIs den neuen Fehler-APIs zugeordnet werden, finden Sie in der API-Übergangsdokumentation.

Symbolik

UWP-Absturzberichte zeigen die Stapelüberwachung für den Thread an, der den Absturz verursacht hat. Wenn die Anwendung .NET Native (in der Regel in Releasebuilds) verwendet, kann die Stapelüberwachung Speicheradressen anstelle von Klassennamen, Methoden, Dateinamen und Zeilennummern enthalten, die zum Lesen und Verstehen der Abstürze erforderlich sind.

Nicht symbolische Abstürze

Nichtsymbolische Abstürze werden im Abschnitt App Center-Diagnose angezeigt, sodass Sie einige Details anzeigen können, bevor Sie Symbole hochladen. Die fehlenden Symbole aus diesen Abstürze werden auf der Registerkarte "unsymbolicated" angezeigt. Wenn die fehlenden Symbole hochgeladen werden, wird die nichtsymbolische Absturzgruppe durch eine symbolische Absturzgruppe ersetzt.

Hochladen von Symbolen

Um die Speicheradressen zu übersetzen, müssen Sie eine .appxsym Datei in App Center hochladen, die alle informationen enthält, die für die Symbolik erforderlich sind.

Lokales Generieren der Symbole

Um eine .appxsym Datei zu erhalten, müssen Sie wie hier beschrieben ein App-Paket erstellen. Nachdem Sie das Bundle erstellt haben, finden Sie die Symboldatei als .appxsym Datei im Ordner "App-Bündel".

Symbole für anwendungen, die in App Center Build erstellt wurden

Die App Center-Build- und -Verteilungsdienste können automatisch eine gültige Symboldatei generieren und in den Diagnosedienst hochladen. Wenn Sie App Center verwenden, um Ihre App zu erstellen und automatisch an Ihre Endbenutzer zu verteilen, müssen Sie die Symboldateien nicht manuell abrufen und in App Center hochladen.

Symbole für Anwendungen, die im Microsoft Store veröffentlicht werden

Wenn Sie Ihre Anwendung im Speicher veröffentlichen, erfolgt die .NET Native Kompilierung auf serverseitiger Seite. Daher müssen Sie die Symbole aus dem Partner Center herunterladen.

  1. Suchen Sie Ihre Anwendung in der Liste, und klicken Sie darauf.
  2. Erweitern Sie im linken Bereich das Menü Produktverwaltung .
  3. Klicken Sie auf Pakete verwalten.
  4. Klicken Sie in der oberen rechten Ecke auf Pakete anzeigen , um die Übermittlung (Version) anzuzeigen, für die Symbole angezeigt werden sollen.
  5. Suchen Sie das Paket für die Version, für die Sie Symbole benötigen, und klicken Sie auf Links für alle unterstützten Architekturen, um alle Symbole herunterzuladen (z. B. den Link Windows 10 Symboldatei herunterladen (x64) herunterladen).

App Center-Portal

  1. Melden Sie sich App Center an, und wählen Sie Ihre App aus.
  2. Navigieren Sie im linken Menü zum Abschnitt Diagnose , und wählen Sie Symbole aus.
  3. Klicken Sie in der oberen rechten Ecke auf Symbole hochladen , und laden Sie die Datei hoch.
  4. Nachdem die Symbole von App Center indiziert wurden, werden Abstürze für Sie symbolisch dargestellt.

App Center-API

Der Prozess zum Hochladen von Symbolen über die API umfasst eine Reihe von drei API-Aufrufen: einer zum Zuweisen von Speicherplatz auf unserem Back-End, einer zum Hochladen der Datei und einer zum Aktualisieren der status des Uploads. Der Text des ersten API-Aufrufs sollte auf festgelegt symbol_type werden UWP.

  1. Lösen Sie eine POST Anforderung an die symbol_uploads-API aus. Dieser Aufruf ordnet Speicherplatz auf unserem Back-End für Ihre Datei zu und gibt eine symbol_upload_id - und eine -Eigenschaft zurück 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. Erstellen Sie mithilfe der upload_url eigenschaft, die aus dem ersten Schritt zurückgegeben wurde, eine PUT Anforderung mit dem Header: "x-ms-blob-type: BlockBlob" und geben Sie den Speicherort Ihrer Datei auf dem Datenträger an. Dieser Aufruf lädt die Datei in unsere Back-End-Speicherkonten hoch. Erfahren Sie mehr über PUT-Blob-Anforderungsheader .
curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'
  1. Senden Sie eine PATCH Anforderung an die symbol_uploads-API , indem Sie die symbol_upload_id Eigenschaft verwenden, die aus dem ersten Schritt zurückgegeben wurde. Geben Sie im Text der Anforderung an, ob Sie die status des Uploads auf committed den Uploadvorgang (erfolgreich abgeschlossen) oder aborted (nicht erfolgreich abgeschlossen) festlegen möchten.
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" }'

Hinweis

Die Symbolupload-API funktioniert nicht für Dateien, die größer als 256 MB sind. Verwenden Sie die App Center-Befehlszeilenschnittstelle, um diese Dateien hochzuladen. Sie können die App Center-CLI installieren, indem Sie die Anweisungen in unserem App Center-CLI-Repository befolgen.

App Center-CLI

Sie können auch die CLI verwenden, um Symboldateien hochzuladen:

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

Ignorieren von Symbolen

Wenn App Center nicht über alle Symboldateien verfügt, um Absturzberichte vollständig zu symbolieren, werden die Abstürze auf der Registerkarte Unsymbolicated aufgeführt. Die erforderlichen Symbole werden von dieser Seite hochgeladen, wenn Sie Zugriff darauf haben.

Wenn Sie die Symbole nicht hochladen können, können Sie sie als Ignoriert markieren, indem Sie Zeilen in der Tabelle auswählen und auf die Schaltfläche Versionen ignorieren klicken. Diese Schaltfläche weist App Center an, die Abstürze zu verarbeiten und sie so vollständig wie möglich mit den in der Datei gespeicherten Symbolen zu symbolisieren. Nachdem sie die Verarbeitung abgeschlossen haben, werden sie auf der Registerkarte Abstürze teilweise symbolisch dargestellt angezeigt. Neue Abstürze, die auch von den gleichen Symbol-IDs abhängen, die als ignoriert markiert sind, umgehen die Registerkarte Unsymbolicated , wenn sie eintreffen und durch das System fließen.

WinRT, Silverlight und andere Plattformen

App Center unterstützt keine anderen Windows-Plattformen außer UWP, WPF und WinForms. Wenn Sie eine Windows-App mit nativen C++-Abstürze haben, können Sie diese Abstürze über die Uploadabstürze-API in App Center hochladen.