Errors

Importante

Visual Studio App Center está programado para la retirada el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.

Obtenga más información sobre las escalas de tiempo de soporte técnico y las alternativas.

Los errores de App Center permiten controlar los errores de la aplicación y evitar posibles problemas en la aplicación. En esta sección se examina cómo detectar y notificar los errores en la aplicación. Obtenga más información sobre los procedimientos recomendados sobre cuándo y cómo usar errores en la documentación oficial de excepciones.

Nota

Actualmente, los errores controlados solo se admiten en la plataforma de Xamarin.

Información general

Al ejecutar App Center en una aplicación, el servicio notifica todos los errores durante la vigencia de la aplicación. Estos errores se envían al servidor cuando se producen (siempre que haya una conexión de red) o la próxima vez que se inicie la aplicación.

Obtenga más información sobre nuestro conjunto de características en nuestra documentación sobre errores.

Integración del SDK de Bloqueos para empezar

Para realizar un seguimiento de los errores en la aplicación de Xamarin, integre el módulo Bloqueos en el SDK de App Center. Consulte nuestra documentación del SDK de bloqueos para obtener información sobre cómo hacerlo.

Errores no detectados (bloqueos)

Un error no detectado (bloqueo) es un error que se produce fuera de un bloque try/catch. App Center notifica automáticamente estos bloqueos de forma predeterminada, al integrar el módulo de bloqueos del SDK de App Center.

Dentro de un contenedor Try/Catch (errores)

Al llamar al TrackError método dentro del contenedor try/catch, puede controlar qué información se envía al servicio App Center cuando se produce un error y obtener una imagen más clara del error y el estado del dispositivo.

Hay varias ventajas mediante el TrackError método :

• Envíe informes al servicio con mayor precisión.
• Envíe informes al servicio con información adicional.

Seguimiento de errores controlado en App Center

Incluya el SDK de bloqueos para controlar los errores y notificarlos a App Center. Como parte de este módulo, puede realizar un seguimiento de los errores mediante el TrackError método :

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

Obtenga más información sobre cómo usar el SDK de bloqueos para realizar un seguimiento de los errores en Xamarin en nuestra documentación del SDK de bloqueos.

Adición de información adicional a la detección de errores

Es posible adaptar el informe de errores enviado a App Center para proporcionar información adicional sobre el error. Para ello, pase un diccionario de pares clave-valor de cadenas al TrackError método . Estas propiedades son opcionales. Por ejemplo:

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

Aquí se sigue enviando la excepción completa (ex) al servicio App Center, pero además de esto, también se crea y envía un diccionario que contiene información adicional de depuración.

Limitaciones

• Puede definir un máximo de 20 propiedades por error, cualquier cosa más allá de ese límite se rechazará.
• El número máximo de caracteres por clave de propiedad de error y valor de propiedad de error es de 125 caracteres.