Errors

Artikel
03/17/2024

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.

Mit App Center-Fehlern können Sie die Fehler in Ihrer App behandeln und potenzielle Probleme in Ihrer App vermeiden. In diesem Abschnitt wird erläutert, wie Sie die Fehler in Ihrer App abfangen und melden. Weitere Informationen zu bewährten Methoden zur Verwendung von Fehlern finden Sie in der offiziellen Dokumentation für Ausnahmen.

Hinweis

Behandelte Fehler werden derzeit nur auf der Xamarin-Plattform unterstützt.

Allgemeine Informationen

Wenn App Center in einer Anwendung ausgeführt wird, meldet der Dienst alle Fehler während der Lebensdauer der Anwendung. Diese Fehler werden an den Server gesendet, wenn sie auftreten (vorausgesetzt, es besteht eine Netzwerkverbindung) oder beim nächsten Start der Anwendung.

Weitere Informationen zu unserem Featuresatz finden Sie in der Dokumentation zu Fehlern.

Integrieren des Crashes SDK für die ersten Schritte

Um Fehler in Ihrer Xamarin-App nachzuverfolgen, integrieren Sie das Modul Crashes in das App Center SDK. Lesen Sie unsere Crashes SDK-Dokumentation , um zu erfahren, wie Sie dies tun.

Uncauaught Errors (Abstürze)

Ein uncaught Error (Absturz) ist ein Fehler, der außerhalb eines try/catch-Blocks auftritt. App Center meldet diese Abstürze standardmäßig automatisch, wenn das Modul "Abstürze" des App Center SDK integriert wird.

Innerhalb eines Try/Catch-Gehäuses (Fehler)

Durch Aufrufen TrackError der -Methode innerhalb des try/catch-Gehäuses können Sie steuern, welche Informationen an den App Center-Dienst gesendet werden, wenn ein Fehler auftritt, und ein klareres Bild des Fehlers und des Gerätestatus erhalten.

Die Verwendung der -Methode bietet eine Reihe von Vorteilen TrackError :

Senden sie Berichte mit höherer Genauigkeit an den Dienst.
Senden sie Berichte mit zusätzlichen Informationen an den Dienst.

Nachverfolgen von behandelten Fehlern in App Center

Schließen Sie das Absturz-SDK ein, um Fehler zu behandeln und an App Center zu melden. Im Rahmen dieses Moduls können Sie Fehler mithilfe der TrackError -Methode nachverfolgen:

try
{
    int divByZero = 42 / int.Parse("0");
} catch (DivideByZeroException ex){
    Crashes.TrackError(ex);
}

Weitere Informationen zur Verwendung des Absturz-SDK zum Nachverfolgen von Fehlern in Xamarin finden Sie in unserer Dokumentation zum Absturz-SDK.

Hinzufügen zusätzlicher Informationen zur Fehlerfangung

Es ist möglich, den an App Center gesendeten Fehlerbericht anzupassen, um zusätzliche Informationen für den weiteren Kontext des Fehlers bereitzustellen. Erreichen Sie dies, indem Sie ein Wörterbuch von Schlüssel-Wert-Paaren für Zeichenfolgen an die TrackError -Methode übergeben. Diese Eigenschaften sind optional. Beispiel:

try
{
    using (var text = File.OpenText("saved_game001.txt"))
    {
        Console.WriteLine("{0}", text.ReadLine());
        ...
    }
}
catch (FileNotFoundException ex)
{
    Crashes.TrackError(ex, new Dictionary<string,string>{
        { "Filename", "saved_game001.txt" },
        { "Where", "Reload game" },
        { "Issue", "Index of available games is corrupted" }
    });
}

Hier wird die vollständige Ausnahme (z. B.) noch an den App Center-Dienst zurückgesendet, aber darüber hinaus wird auch ein Wörterbuch erstellt und gesendet, das zusätzliche Debuginformationen enthält.

Einschränkungen

Sie können maximal 20 Eigenschaften pro Fehler definieren, alles, was über diesen Grenzwert hinausgeht, wird abgelehnt.
Die maximale Anzahl von Zeichen pro Fehlereigenschaftsschlüssel und Fehlereigenschaftswert beträgt 125 Zeichen.

Freigeben über