Об этом проекте

Пакет aptabase-maui — это .NET SDK, добавляющий инструментарий аналитики Aptabase в приложения .NET Multi-platform App UI (MAUI). Aptabase позиционируется как open-source, privacy-first и простая платформа аналитики для мобильных, десктопных и веб-приложений. Установка выполняется через NuGet путём добавления PackageReference в файл проекта. После установки SDK инициализируется в MauiProgram.cs с помощью метода расширения UseAptabase, которому передаётся ключ приложения, а также необязательные конфигурации: режим отладки, сбор крэш-репортов и сохранение событий на диске. После регистрации SDK предоставляет сервис IAptabaseClient через внедрение зависимостей, который можно разрешить в любой странице или view model. Разработчики вручную вызывают TrackEvent для записи произвольных событий. События могут содержать пользовательские свойства, ограниченные типами string и number. SDK автоматически обогащает каждое событие полезным контекстом, таким как операционная система и версия приложения, но не отслеживает ничего автоматически — разработчик точно контролирует, что отправляется. TrackError поддерживает отправку как обрабатываемых, так и необрабатываемых исключений. Обрабатываемые исключения можно сообщать с уровнем серьёзности error или fatal. При включённом EnableCrashReporting SDK также автоматически перехватывает необрабатываемые исключения, необслуженные исключения задач и крахи. Каждый репорт об ошибке включает тип исключения, сообщение, трассировку стека, уровень серьёзности и классификацию источника. Включение EnablePersistence гарантирует сохранение событий на диске перед отправкой на сервер Aptabase, что помогает обеспечить доставку данных о критических крахах даже когда приложение не может перезапуститься немедленно. Все операции отслеживания выполняются асинхронно в фоновом режиме и не блокируют вызывающий поток.