Irrtümer

Mit App Center-Fehlern können Sie die Fehler in Ihrer App behandeln und potenzielle Probleme in Ihrer App vermeiden. In diesem Abschnitt wird beschrieben, wie Sie die Fehler in Ihrer App erfassen und melden. Erfahren Sie mehr über bewährte Methoden, wann und wie Fehler verwendet werden in der offiziellen Dokumentation für Ausnahmen.

Allgemeine Informationen

Beim Ausführen von App Center in einer Anwendung meldet der Dienst alle Fehler während der Lebensdauer der Anwendung. Diese Fehler werden an den Server gesendet, wenn sie auftreten (vorausgesetzt, es gibt eine Netzwerkverbindung) oder das nächste Mal, wenn die Anwendung gestartet wird.

Erfahren Sie mehr über unseren Featuresatz in unserer Fehlerdokumentation.

Integrieren Sie das Crashes-SDK, um zu beginnen

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

Nicht abgefangene Fehler (Abstürze)

Ein nicht abgefangener Fehler (Absturz) ist ein Fehler, der außerhalb eines Try/Catch-Blocks auftritt. App Center meldet diese Abstürze automatisch standardmäßig, wenn das Absturzmodul des App Center SDK integriert wird.

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

Durch Aufrufen der TrackError Methode innerhalb des Try/Catch-Gehäuses können Sie steuern, welche Informationen beim Auftreten eines Fehlers an den App Center-Dienst gesendet werden, und ein klareres Bild des Fehlers und des Zustands des Geräts erhalten.

Es gibt eine Reihe von Vorteilen mit der TrackError Methode:

• Senden Sie Berichte mit größerer Genauigkeit an den Dienst.
• Senden Sie Berichte mit zusätzlichen Informationen an den Dienst.

Nachverfolgen von behandelten Fehlern im App Center

Schließen Sie das Crashes SDK ein, um Fehler zu behandeln und sie im 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);
}

Erfahren Sie mehr über die Verwendung des Crashes SDK zum Nachverfolgen von Fehlern in Xamarin in unserer Crashes SDK-Dokumentation.

Hinzufügen zusätzlicher Informationen zur Fehlererfassung

Es ist möglich, den an Das App Center gesendeten Fehlerbericht anzupassen, um zusätzliche Informationen für den weiteren Kontext zum Fehler bereitzustellen. Dies erreichen Sie, indem Sie ein Wörterbuch mit Zeichenfolgenschlüssel-Wert-Paaren 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 (ex) weiterhin an den App Center-Dienst zurückgesendet, aber zusätzlich dazu wird ein Wörterbuch mit zusätzlichen Debuginformationen auch erstellt und gesendet.

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.