11. Depuração com logs do AKS (PTB_LOG)

Cada linha de log gerada pelo AKS — seja por chamadas a AKSLogManager/AppsKitSDKLogManager, eventos de carregamento/exibição de anúncios ou atividades internas do SDK — é enviada para dois destinos ao mesmo tempo: o Logcat, com tags por categoria, e o acumulador de logs em memória que alimenta a tela AKS Logs descrita na §10.

Filtrando o Logcat

Filtre por tag no Logcat do Android Studio (tag:PTB_LOG) ou via adb:

adb logcat -s PTB_LOG:* PTB_LOG_ADS:* PTB_LOG_ANALYTICS:*

• PTB_LOG — logs gerais do SDK (sequência de inicialização, avisos de modo, ciclo de vida, erros)
• PTB_LOG_ADS — ciclo de vida de carregamento/exibição de anúncios em todos os formatos
• PTB_LOG_ANALYTICS — eventos enviados ao Firebase/MMPs, incluindo todas as chamadas a sendAKSEvent/AKSLogManager.log descritas na §7

Lendo logs sem o Logcat

Se você estiver depurando uma build de release, um dispositivo de um testador ou um chamado de suporte em que não seja possível conectar via adb, abra a tela AKS Logs da suíte de testes (§10) — ela exibe exatamente as mesmas linhas de log no dispositivo, com busca na própria tela. Assim, o testador pode rolar pelos logs, pesquisar diretamente ou enviar uma captura de tela para você.

AppsKitSDKLogManager.logAarVersion() (veja a §7.3) é a maneira mais rápida de confirmar qual versão do AAR do AKS está realmente integrada quando houver suspeita de divergência de versões — o método imprime o aviso de versão em PTB_LOG.