błędy

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

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, jak przechwytywać i zgłaszać błędy w aplikacji. Dowiedz się więcej o najlepszych rozwiązaniach dotyczących tego, kiedy i jak używać błędów w oficjalnej dokumentacji wyjątków.

Uwaga

Obsługiwane błędy są obecnie obsługiwane tylko na platformie Xamarin.

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.

Integrowanie zestawu SDK awarii, aby rozpocząć pracę

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)

Niezachwycony 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 w przypadku wystąpienia 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ą.
• Wysyłanie raportów do usługi z dodatkowymi informacjami.

Śledzenie obsługiwanych błędów w usłudze App Center

Uwzględnij zestaw SDK awarii, aby obsłużyć błędy i zgłosić je do Centrum aplikacji. W ramach tego modułu możesz ś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 na temat używania zestawu SDK awarii do śledzenia błędów na platformie Xamarin w naszej dokumentacji zestawu SDK awarii.

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 dalszego kontekstu błędu. W tym celu należy przekazać TrackError do metody słownik par klucz/wartość ciągów. Te właściwości są opcjonalne. Na 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 (np.) jest nadal wysyłany z powrotem do usługi App Center, ale oprócz tego słownik zawierający dodatkowe informacje debugowania jest również tworzony i wysyłany.

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.