ошибки

Статья
03/17/2024

Важно!

Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio, пока он не будет полностью выведен из эксплуатации, существует несколько рекомендуемых вариантов, на которые вы можете рассмотреть возможность миграции.

Узнайте больше о сроках поддержки и альтернативных вариантах.

Ошибки Центра приложений позволяют обрабатывать ошибки в приложении и избежать потенциальных проблем в приложении. В этом разделе рассматривается, как перехватывать ошибки в приложении и сообщать об этих ошибках. Дополнительные сведения о рекомендациях по использованию ошибок см. в официальной документации по исключениям.

Примечание

В настоящее время обработка ошибок поддерживается только на платформе Xamarin.

Общие сведения

При запуске Центра приложений в приложении служба сообщает обо всех ошибках в течение времени существования приложения. Эти ошибки отправляются на сервер при их возникновении (при наличии сетевого подключения) или при следующем запуске приложения.

Дополнительные сведения о наборе функций см. в документации по ошибкам.

Интеграция пакета SDK для аварийного завершения работы

Чтобы отслеживать ошибки в приложении Xamarin, интегрируйте модуль Аварийное завершение в пакет SDK центра приложений. Ознакомьтесь с документацией по пакету SDK для аварийного завершения , чтобы узнать, как это сделать.

Неуловимые ошибки (сбои)

Неуловимая ошибка (сбой) — это ошибка, возникающая за пределами блока try/catch. Центр приложений автоматически сообщает об этих сбоях по умолчанию при интеграции модуля аварийного завершения пакета SDK центра приложений.

Внутри корпуса Try/Catch (ошибки)

TrackError Вызывая метод внутри корпуса try/catch, вы можете контролировать, какие сведения отправляются в службу Центра приложений при возникновении ошибки, и получить более четкое представление об ошибке и состоянии устройства.

Этот метод имеет TrackError ряд преимуществ:

Отправлять отчеты в службу с большей точностью.
Отправка отчетов в службу с дополнительными сведениями.

Отслеживание обрабатываемых ошибок в Центре приложений

Включите пакет SDK для аварийного завершения работы, чтобы обрабатывать ошибки и сообщать о них в Центр приложений. В рамках этого модуля вы можете отслеживать ошибки с помощью TrackError метода :

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

Дополнительные сведения об использовании пакета SDK для аварийного завершения работы для отслеживания ошибок в Xamarin см. в документации по пакету SDK для аварийного завершения.

Добавление дополнительных сведений в перехват ошибок

Можно настроить отчет об ошибках, отправляемый в Центр приложений, чтобы предоставить дополнительные сведения для дальнейшего контекста об ошибке. Для этого передайте словарь пар "ключ-значение" строки в TrackError метод . Эти свойства являются необязательными. Пример:

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

Здесь полное исключение (например,) по-прежнему отправляется обратно в службу Центра приложений, но в дополнение к этому также создается и отправляется словарь, содержащий дополнительные сведения об отладке.

Ограничения

Вы можете определить не более 20 свойств для каждой ошибки. Все, что превышает это ограничение, будет отклонено.
Максимальное число символов на ключ свойства ошибки и значение свойства error составляет 125 символов.

Share via