aptabase-maui

O pacote aptabase-maui é um SDK .NET que adiciona instrumentação de analytics do Aptabase a aplicativos .NET Multi-platform App UI (MAUI). O Aptabase se posiciona como uma plataforma de analytics open-source, com foco na privacidade e simples, para apps móveis, desktop e web. A instalação é feita via NuGet, adicionando um PackageReference ao arquivo do projeto. Uma vez instalado, o SDK é inicializado no MauiProgram.cs usando o método de extensão UseAptabase, passando sua chave de aplicativo junto com configuração opcional, incluindo modo de depuração, relatórios de crashes e persistência de eventos em disco. Após o registro, o SDK fornece um serviço IAptabaseClient por meio de injeção de dependência, que pode ser resolvido em qualquer página ou view model. Os desenvolvedores chamam manualmente TrackEvent para registrar eventos personalizados. Os eventos podem conter propriedades customizadas limitadas a valores do tipo string e number. O SDK automaticamente enriquece cada evento com informações contextuais úteis, como sistema operacional e versão do app, mas não rastreia nada automaticamente — o desenvolvedor controla exatamente o que é enviado. TrackError suporta o reporte de exceções tratadas e não tratadas. Exceções tratadas podem ser reportadas com severidade error ou fatal. Com EnableCrashReporting habilitado, o SDK também captura automaticamente exceções não tratadas, exceções de tarefas não observadas e crashes. Cada relatório de erro inclui tipo de exceção, mensagem, stack trace, severidade e classificação de origem. Definir EnablePersistence garante que os eventos sejam armazenados em disco antes de serem enviados ao servidor do Aptabase, o que ajuda a garantir a entrega de dados de crash fatal mesmo quando o app não pode reiniciar imediatamente. Todas as operações de tracking são executadas de forma assíncrona em segundo plano e não bloqueiam a thread de chamada.