À propos du projet

Le package aptabase-maui est un SDK .NET qui ajoute l'instrumentation d'analyse Aptabase aux applications .NET Multi-platform App UI (MAUI). Aptabase se positionne comme une plateforme d'analyse open-source, privacy-first et simple pour les applications mobiles, de bureau et web. L'installation se fait via NuGet en ajoutant une référence de package au fichier de projet. Une fois installé, le SDK est initialisé dans MauiProgram.cs à l'aide de la méthode d'extension UseAptabase, en passant votre clé d'application ainsi qu'une configuration optionnelle incluant le mode débogage, le reporting de plantages et la persistance des événements sur disque. Après enregistrement, le SDK fournit un service IAptabaseClient via l'injection de dépendances, pouvant être résolu dans n'importe quelle page ou modèle de vue. Les développeurs appellent manuellement TrackEvent pour enregistrer des événements personnalisés. Les événements peuvent transporter des propriétés personnalisées limitées aux types chaîne et nombre. Le SDK enrichit automatiquement chaque événement avec un contexte utile tel que le système d'exploitation et la version de l'application, mais ne suit rien automatiquement—le développeur contrôle exactement ce qui est envoyé. TrackError prend en charge le signalement des exceptions gérées et non gérées. Les exceptions gérées peuvent être signalées avec une sévérité d'erreur ou fatale. Avec EnableCrashReporting activé, le SDK capture également les exceptions non gérées, les exceptions de tâche non observées et les plantages automatiquement. Chaque rapport d'erreur inclut le type d'exception, le message, la trace de pile, la sévérité et la classification de la source. L'activation de EnablePersistence garantit que les événements sont stockés sur disque avant d'être envoyés au serveur Aptabase, ce qui aide à garantir la livraison des données de plantage fatales même lorsque l'application ne peut pas redémarrer immédiatement. Toutes les opérations de suivi s'exécutent de manière asynchrone en arrière-plan et sont non bloquantes pour le thread appelant.