aptabase-maui

El paquete aptabase-maui es un SDK para .NET que agrega instrumentación de análisis de Aptabase a las aplicaciones .NET Multi-platform App UI (MAUI). Aptabase se posiciona como una plataforma de análisis de código abierto, centrada en la privacidad y sencilla para aplicaciones móviles, de escritorio y web. La instalación se realiza a través de NuGet añadiendo un PackageReference al archivo del proyecto. Una vez instalado, el SDK se inicializa en MauiProgram.cs utilizando el método de extensión UseAptabase, pasando tu clave de aplicación junto con configuración opcional que incluye el modo depuración, reporte de crashes y persistencia de eventos en disco. Tras el registro, el SDK proporciona un servicio IAptabaseClient a través de inyección de dependencias que puede resolverse en cualquier página o vista modelo. Los desarrolladores llaman manualmente a TrackEvent para registrar eventos personalizados. Los eventos pueden incluir propiedades personalizadas limitadas a valores de tipo string y number. El SDK enriquece automáticamente cada evento con contexto útil como el sistema operativo y la versión de la aplicación, pero no rastrea nada de forma automática: el desarrollador controla exactamente qué se envía. TrackError soporta el reporte de excepciones controladas y no controladas. Las excepciones controladas pueden reportarse como error o fatal. Con EnableCrashReporting habilitado, el SDK también captura excepciones no controladas, excepciones de tareas no observadas y crashes automáticamente. Cada reporte de error incluye el tipo de excepción, mensaje, trazado de pila, severidad y clasificación de fuente. Configurar EnablePersistence garantiza que los eventos se almacenen en disco antes de enviarse al servidor de Aptabase, lo que ayuda a garantizar la entrega de datos de crash fatal incluso cuando la aplicación no pueda reiniciarse inmediatamente. Todas las operaciones de rastreo se ejecutan de forma asíncrona en segundo plano y no bloquean el hilo que las invoca.