Sobre o projeto
## SDK do Unity Engine para o Aptabase
Este pacote instrumenta projetos do Unity Engine com o Aptabase, uma plataforma de análise open-source e com foco na privacidade para aplicativos mobile, desktop e web.
### Instalação
Instale via Unity Package Manager adicionando a URL git https://github.com/aptabase/aptabase-unity.git através de Window > Package Manager > Add Package from git URL.
### Configuração
Após obter uma App Key no Aptabase, defina-a em `Aptabase/Resources/AptabaseSettings.Asset`. O host é selecionado automaticamente com base na chave; para implantações self-hosted, aparece um campo `SelfHostURL`. Chaves prefixadas com `A-DEV-*` direcionam-se a uma instância local do Aptabase em `https://localhost:3000`.
Configurações opcionais incluem substituir a versão do app (`AppVersion`), especificar um número de build específico por plataforma (`AppBuildNumber`), ajustar intervalos de envio de eventos (`FlushInterval`) e ativar o reporte automático de crashes (`EnableCrashReporting`).
### Rastreamento de Eventos
Eventos são registrados via `Aptabase.TrackEvent()` dentro do namespace `AptabaseSDK`. Propriedades personalizadas aceitam apenas strings e números. Os eventos são agrupados e enviados a cada 60 segundos em produção ou 2 segundos em desenvolvimento. É possível fazer flush manual via `Aptabase.Flush()`.
O SDK enriquece automaticamente os eventos com SO, versão do app e outros metadados. Nenhum evento é rastreado automaticamente — todo o registro deve ser feito manualmente.
### Rastreamento de Erros (Beta)
Use `Aptabase.TrackError(ex)` para exceções tratadas e `Aptabase.TrackError(ex, fatal: true)` para erros irreversíveis. Com `EnableCrashReporting`, o SDK reporta automaticamente:
- Exceções capturadas de callbacks MonoBehaviour, coroutines e `Debug.LogException` como `unhandled`
- Exceções que terminam o processo como `crash` com severidade `fatal`
- Exceções de Task não observadas como `taskException`
Cada relatório inclui tipo de exceção, mensagem, stack trace, severidade e método de captura. Até 100 erros únicos por sessão são reportados. Crashes nativos não são capturados.
### Recursos Adicionais
- Listener de resposta via `SetResponseListener()` para códigos de status HTTP
- Habilitar/desabilitar o SDK com `SetEnabled()`
- Diretrizes para formulário de privacidade da Apple App Store fornecidas
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.