Lire en anglais

Partager via


Erreurs

Important

Visual Studio App Center doit être mis hors service le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à ce qu’il soit entièrement mis hors service, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager de migrer.

En savoir plus sur les chronologies et les alternatives de support.

Les erreurs du Centre d’applications vous permettent de gérer les erreurs dans votre application et d’éviter les problèmes potentiels dans votre application. Cette section explique comment intercepter et signaler les erreurs dans votre application. En savoir plus sur les bonnes pratiques sur le moment et la façon d’utiliser les erreurs dans la documentation officielle pour les exceptions.

Notes

Les erreurs gérées sont actuellement uniquement prises en charge sur la plateforme Xamarin.

Informations générales

Lors de l’exécution d’App Center dans une application, le service signale toutes les erreurs pendant la durée de vie de l’application. Ces erreurs sont envoyées au serveur lorsqu’elles se produisent (à condition qu’il existe une connexion réseau) ou lors du prochain démarrage de l’application.

Pour en savoir plus sur notre ensemble de fonctionnalités, consultez notre documentation erreurs.

Intégrer le Kit de développement logiciel (SDK) Crash pour commencer

Pour effectuer le suivi des erreurs dans votre application Xamarin, intégrez le module Crashs dans le Kit de développement logiciel (SDK) App Center. Consultez notre documentation sur le Kit de développement logiciel (SDK) crash pour savoir comment procéder.

Erreurs non interceptables (plantages)

Une erreur non interceptée (plantage) est une erreur qui se produit en dehors d’un bloc try/catch. App Center signale automatiquement ces incidents par défaut, lors de l’intégration du module de blocages du Kit de développement logiciel (SDK) App Center.

À l’intérieur d’un boîtier Try/Catch (erreurs)

En appelant TrackError la méthode à l’intérieur du boîtier try/catch, vous pouvez contrôler les informations envoyées au service App Center lorsqu’une erreur se produit et obtenir une image plus claire de l’erreur et de l’état de l’appareil.

La méthode présente un certain nombre d’avantages TrackError :

  • Envoyez des rapports au service avec une plus grande précision.
  • Envoyez des rapports au service avec des informations supplémentaires.

Suivre les erreurs gérées dans App Center

Incluez le Kit de développement logiciel (SDK) crash pour gérer les erreurs et les signaler à App Center. Dans le cadre de ce module, vous pouvez suivre les erreurs à l’aide de la TrackError méthode :

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

Pour plus d’informations sur l’utilisation du Kit de développement logiciel (SDK) Crashs pour suivre les erreurs dans Xamarin, consultez notre documentation sur le Kit de développement logiciel (SDK) crash.

Ajout d’informations supplémentaires à la capture d’erreurs

Il est possible d’adapter le rapport d’erreurs envoyé à App Center pour fournir des informations supplémentaires pour plus de contexte sur l’erreur. Pour ce faire, transmettez un dictionnaire de paires clé/valeur de chaînes à la TrackError méthode . Ces propriétés sont facultatives. Par exemple :

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

Ici, l’exception complète (par exemple) est toujours renvoyée au service App Center, mais en plus de cela, un dictionnaire contenant des informations de débogage supplémentaires est également créé et envoyé.

Limites

  • Vous pouvez définir un maximum de 20 propriétés par erreur. Tout ce qui dépasse cette limite sera rejeté.
  • Le nombre maximal de caractères par clé de propriété d’erreur et la valeur de propriété d’erreur est de 125 caractères.