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.
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.
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ć.
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.
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.
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.
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.
- 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.