Błędy

Błędy usługi App Center umożliwiają obsługę błędów w aplikacji i unikanie potencjalnych problemów w aplikacji. W tej sekcji opisano sposób przechwytywania i zgłaszania błędów w aplikacji. Dowiedz się więcej o najlepszych praktykach dotyczących tego, kiedy i jak używać błędów w oficjalnej dokumentacji na temat wyjątków.

Informacje ogólne

Podczas uruchamiania centrum aplikacji w aplikacji usługa zgłasza wszystkie błędy w okresie istnienia aplikacji. Te błędy są wysyłane do serwera, gdy wystąpią (pod warunkiem, że istnieje połączenie sieciowe) lub przy następnym uruchomieniu aplikacji.

Dowiedz się więcej o naszym zestawie funkcji w naszej dokumentacji Błędów.

Zintegruj SDK Crashes, aby zacząć

Aby śledzić błędy w aplikacji platformy Xamarin, zintegruj moduł Awarie w zestawie SDK centrum aplikacji. Zapoznaj się z naszą dokumentacją zestawu SDK awarii , aby dowiedzieć się, jak to zrobić.

Błędy nieprzechwycone (awarie)

Nieprzechwycony błąd (awaria) to błąd, który występuje poza blokiem try/catch. Usługa App Center automatycznie zgłasza te awarie domyślnie podczas integrowania modułu awarii zestawu SDK centrum aplikacji.

Wewnątrz obudowy Try/Catch (błędy)

Wywołując TrackError metodę wewnątrz obudowy try/catch, można kontrolować, jakie informacje są wysyłane do usługi App Center po wystąpieniu błędu, i uzyskać jaśniejszy obraz błędu i stanu urządzenia.

Istnieje wiele korzyści przy użyciu TrackError metody :

• Wysyłaj raporty do usługi z większą dokładnością.
• Wyślij raporty do serwisu z dodatkowymi informacjami.

Monitorowanie obsługiwanych błędów w App Center

Dołącz SDK Crashes, aby obsłużyć błędy i zgłosić je do App Center. W ramach tego modułu można śledzić błędy przy użyciu TrackError metody :

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

Dowiedz się więcej o sposobie używania SDK Crashes do śledzenia błędów w Xamarin w dokumentacji SDK Crashes.

Dodawanie dodatkowych informacji do przechwytywania błędów

Istnieje możliwość dostosowania raportu o błędach wysyłanego do Centrum aplikacji w celu udostępnienia dodatkowych informacji na temat tego błędu. W tym celu należy przekazać do metody TrackError słownik par klucz/wartość ciągów. Te właściwości są opcjonalne. Przykład:

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" }
    });
}

Tutaj pełny wyjątek (ex) jest nadal wysyłany z powrotem do usługi App Center. Poza tym tworzony i wysyłany jest również słownik zawierający dodatkowe informacje ułatwiające debugowanie.

Ograniczenia

• Można zdefiniować maksymalnie 20 właściwości na błąd. Wszystkie elementy wykraczające poza ten limit zostaną odrzucone.
• Maksymalna liczba znaków na klucz właściwości błędu i wartość właściwości błędu to 125 znaków.