Freigeben über

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 sie vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie die Migration in Betracht ziehen können.

Erfahren Sie mehr über die Fristen für den Support sowie über mögliche Alternativen.

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 unterstützt den vollständigen Diagnosefeaturesatz für quergeladene und Windows Store-UWP-Apps mit dem 2.5.0 SDK oder höher. 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 zum Markieren von Absturz- und Fehlergruppen als geöffnet, geschlossen oder ignoriert
  • 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 Absturzinstanz, z. B. beim Start der App, beim Absturz und in welchem Land/welcher Region und welcher 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 das App Center UWP SDK, Version 2.5.0, werden Absturz- und Fehlerdaten angezeigt, die in einem neuen und verbesserten Ui-Portal im App Center Diagnostics-Portal angezeigt werden. 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 zeigen die Stapelablaufverfolgung für den Thread an, 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 Verteilungsdienste können automatisch eine gültige Symboldatei generieren 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 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 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 Deklaration sollte im <Dependencies> Abschnitt Ihrer AppxManifest.xml. 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 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 auf symbol_typeUWP.

  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_idupload_url Eigenschaft zurückgegeben.
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 symbol_upload_id eigenschaft, die aus dem ersten Schritt zurückgegeben wird. 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 symbolisch angezeigt. Neue Abstürze, die auch von den gleichen Symbol-IDs abhängen, die als ignoriert gekennzeichnet sind, umgehen die Registerkarte "Nichtsymboliert ", sobald sie in das System gelangen und ablaufen.

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.