Freigeben über

Windows-Unterstützung

Von Bedeutung

Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen

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

Universelle Windows-Plattform

App Center bietet Unterstützung für den vollständigen Diagnosesatz von Funktionen sowohl für seitlich installierte als auch für UWP-Apps aus dem Windows Store, die mit dem 2.5.0 SDK oder späteren Versionen laufen. Zum Aktivieren der App Center-Diagnose für Ihre UWP-App folgen Sie der UWP SDK-Dokumentation des App Center , um das App Center SDK zu integrieren. Weitere Informationen zum vollständigen Featuresatz finden Sie in der Dokumentation zu Diagnosefeatures.

Neue Diagnoseerfahrung

Mit der Version 2.5.0 SDK im Oktober 2019 hat App Center eine neue Diagnoseumgebung veröffentlicht. In diesem Abschnitt werden die Verbesserungen und die Übergangserfahrung mit der neuen Version beschrieben.

Welche Verbesserungen wurden vorgenommen?

Die neue und verbesserte Diagnoseerfahrung umfasst die folgenden Ergänzungen:

  • Eine vollständige Symboldarstellung, mit der Sie Symbole im App Center hochladen können. Weitere Informationen finden Sie im Abschnitt "Symbolik" weiter unten.
  • 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, Systemabsturz- und Fehlergruppen als geöffnet, geschlossen oder ignoriert zu kennzeichnen
  • Möglichkeit zum Herunterladen von Absturz- und Fehlerberichten
  • Möglichkeit zum Anfügen, Anzeigen und Herunterladen einer Binärdatei und einer Textdatei für Ihre Absturzberichte
  • Details zu Absturz- und Fehlerberichten pro Absturzinstanz, einschließlich wann die App gestartet wurde, wann sie abgestürzt ist und welches Land/welche Region und welche Sprache das Gerät verwendet hat.

Weitere Informationen zu den einzelnen Features finden Sie in der App Center-Diagnosedokumentation.

Was ist die Übergangserfahrung?

Nach dem Update auf die App Center UWP SDK Version 2.5.0 werden Absturz- und Fehlerdaten in einer neuen und verbesserten Benutzeroberfläche im App Center Diagnostics-Portal angezeigt. Für Absturz- und Fehlerdaten, die in der neuen Diagnose-Benutzeroberfläche angezeigt werden, müssen Sie die im Abschnitt "Fehler" aufgeführten APIs verwenden. Erfahren Sie mehr darüber, wie die alten Abstürze-APIs den neuen Fehler-APIs in der API-Übergangsdokumentation zugeordnet werden.

Symbolik

UWP-Absturzberichte enthalten den Stack-Trace des Threads, der den Absturz verursacht hat. Wenn die Anwendung .NET Native (in der Regel in Releasebuilds) verwendet, enthält die Stapelablaufverfolgung möglicherweise Speicheradressen anstelle von Klassennamen, Methoden, Dateinamen und Zeilennummern, die zum Lesen und Verstehen der Abstürze erforderlich sind.

Unsymbolische Abstürze

Unsymbolische Abstürze werden im Abschnitt "App Center Diagnostics" angezeigt, sodass Sie einige Details auch vor dem Hochladen von Symbolen anzeigen können. Die fehlenden Symbole dieser Abstürze werden auf der Registerkarte "Nichtsymboliert" angezeigt. Wenn die fehlenden Symbole hochgeladen werden, wird die nichtsymbolierte Absturzgruppe durch eine symbolische Absturzgruppe ersetzt.

Hochladen von Symbolen

Um die übersetzten Speicheradressen abzurufen, müssen Sie eine .appxsym Datei in das 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-Bündel erstellen. Nachdem Sie das Bündel erstellt haben, finden Sie die Symboldatei als .appxsym Datei im App-Bündelordner.

Symbole für Anwendungen, die in App Center-Build integriert sind

Die App Center Build- und Distribution-Dienste können automatisch eine gültige Symboldatei erstellen und in den Diagnosedienst hochladen. Wenn Sie App Center zum Erstellen und automatischen Verteilen Ihrer App an Ihre Endbenutzer verwenden, müssen Sie die Symboldateien nicht manuell abrufen und in App Center hochladen.

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

Wenn Sie Ihre Anwendung in den Store veröffentlichen, erfolgt die .NET Native-Kompilierung auf der Serverseite. 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 das Menü "Produktverwaltung " im linken Bereich.
  3. Klicken Sie auf "Pakete verwalten".
  4. Klicken Sie auf "Pakete anzeigen" in der oberen rechten Ecke für die Übermittlung (Version), 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).

Hinweis

Ihre Anwendung muss eine Abhängigkeit von einer beliebigen Version von .NET Native deklarieren, um Debugsymbole zu generieren. Diese Erklärung sollte im <Dependencies>-Abschnitt Ihrer AppxManifest.xml enthalten sein. Beispiel:

<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. Melden Sie sich beim 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 vom 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: eines zum Zuweisen von Speicherplatz auf unserem Back-End, eines zum Hochladen der Datei und eines zum Aktualisieren des Status des Uploads. Der Text des ersten API-Aufrufs sollte symbol_type auf UWP setzen.

  1. Auslösen einer POST Anforderung an die symbol_uploads-API. Mit diesem Aufruf wird Speicherplatz auf unserem Back-End für Ihre Datei zugewiesen und eine symbol_upload_id- und upload_url-Eigenschaft geliefert.
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 eigenschaft, die upload_url aus dem ersten Schritt zurückgegeben wird, eine PUT Anforderung mit dem Header: "x-ms-blob-type: BlockBlob" und geben Sie den Speicherort der 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. Stellen Sie eine PATCH Anforderung an die symbol_uploads-API mithilfe der Eigenschaft, die im ersten Schritt zurückgegeben wurde. Geben Sie im Textkörper der Anforderung an, ob Sie den Status des Uploads auf committed den (erfolgreich abgeschlossenen) Uploadvorgang oder aborted (erfolglos 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 Symboluploads-API funktioniert nicht für Dateien, die größer als 256 MB sind. Verwenden Sie die App Center CLI, 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 vollständig symbolische Absturzberichte zu erstellen, werden die Abstürze auf der Registerkarte " Nicht symboliert " 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 Symbolen in der Datei zu symbolisieren. Nachdem sie die Verarbeitung abgeschlossen haben, werden sie auf der Registerkarte „Abstürze“ teilweise symbolisiert angezeigt. Neue Abstürze, die auch von den gleichen Symbol-IDs abhängen, die als ignoriert gekennzeichnet sind, umgehen die Registerkarte Unsymbolisiert, sobald 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 eine Windows-App mit systemeigenen C++-Abstürzen auftritt, können Sie diese Abstürze über die Uploadabsturz-API in App Center hochladen.