Diagnóstico de Superaquecimento do Android

Visão Geral

Encontre a fonte mais provável do calor em dispositivos Android correlacionando o estado térmico, condições da bateria, atividade da CPU, "wakeups", rádios, sensores, carregamento e a linha do tempo do usuário. Mantenha o diagnóstico em modo somente leitura por padrão, distinga evidências de inferências e proponha apenas a menor intervenção reversível após a aprovação do usuário.

Quando Usar Esta Habilidade

• Use quando um telefone Android estiver quente, morno em repouso, com "thermal throttling" (redução de desempenho devido ao calor), desligando por causa do calor ou drenando a bateria incomumente rápido.
• Use quando o calor aparecer durante o carregamento, sinal celular fraco, uso de 5G, navegação, uso da câmera, jogos, reprodução de mídia, "tethering" (compartilhamento de internet) ou atividade em segundo plano.
• Use quando o usuário quiser identificar um aplicativo, serviço, "wakelock", sensor, condição do modem ou condição de carregamento causador do problema através do ADB.
• Use quando uma tentativa anterior de otimização ou "debloat" (remoção de aplicativos pré-instalados) do Android possa ter deixado configurações que alteraram o comportamento de energia ou térmico.
• Use para telefones e tablets físicos. Para perfilar o uso de energia de um aplicativo em desenvolvimento, use uma habilidade de desempenho de aplicativo em vez disso.

Parada de Segurança

Interrompa o diagnóstico de software quando o dispositivo apresentar inchaço da bateria, fumaça, chiado, vazamento, odor químico forte, desligamentos térmicos repetidos ou calor tão severo que não possa ser manuseado com segurança. Informe o usuário para desconectar a energia, se isso puder ser feito com segurança, desligar o dispositivo, mantê-lo longe de materiais inflamáveis e procurar suporte do fabricante ou de reparo qualificado. Não sugira resfriar o dispositivo em uma geladeira ou freezer, perfurá-lo, continuar carregando-o ou executar testes de estresse.

Contrato de Diagnóstico

Antes de coletar dados:

1. Confirme se o usuário é proprietário ou está autorizado a inspecionar o dispositivo.
2. Pergunte o que "quente" significa: localização no aparelho, atividade, estado de carregamento, tipo de rede, início, duração e se o calor também ocorre em repouso.
3. Registre o modelo do dispositivo, versão do Android, alterações recentes no SO/aplicativos, carregador e cabo, condições ambientais e avisos térmicos visíveis.
4. Explique que um cabo USB conectado pode carregar e aquecer o dispositivo. Use ADB sem fio ou janelas de captura curtas quando possível e compare com o cabo desconectado.
5. Selecione um número de série de dispositivo específico quando houver mais de um alvo ADB presente. Nunca assuma que o primeiro dispositivo listado é o telefone pretendido.

Fluxo de Trabalho

1. Capturar uma Linha de Base Intocada

Não reinicie o Batterystats, force o fechamento de aplicativos, limpe caches, altere modos de rede, modifique o AppOps, ative o economizador de bateria ou altere as configurações do desenvolvedor antes de preservar o estado inicial.

Comece com comandos somente leitura:

adb devices -l
adb -s <serial> shell getprop ro.product.manufacturer
adb -s <serial> shell getprop ro.product.model
adb -s <serial> shell getprop ro.build.version.release
adb -s <serial> shell getprop ro.build.version.sdk
adb -s <serial> shell uptime
adb -s <serial> shell dumpsys battery
adb -s <serial> shell dumpsys thermalservice
adb -s <serial> shell dumpsys cpuinfo
adb -s <serial> shell top -n 1

Se um serviço ou opção não estiver disponível, registre essa limitação. Não transforme saídas ausentes em um veredito saudável. Compilações do Android e OEM expõem diferentes serviços, campos, permissões e sintaxe top.

2. Escolher o Ramo de Evidências

Leia evidence-and-interpretation.md e, em seguida, colete apenas os ramos que correspondem ao sintoma:

• calor em repouso: histórico da bateria, estado de energia, alarmes, tarefas, sensores, localização e rádios;
• calor durante o carregamento: estado da bateria/USB e uma comparação controlada com o dispositivo desconectado;
• calor sob um aplicativo: CPU do processo, memória do pacote, tarefas, "wakelocks", rede, câmera e localização;
• calor em sinal fraco ou dados móveis: telefonia, conectividade, alterações de sinal e atividade do rádio móvel;
• calor durante câmera, navegação, jogos ou reprodução: estado adjacente à CPU/GPU, tela, câmera/mídia, sensores, localização e atividade de rede;
• calor após uma alteração de configuração: capture os valores atuais e compare-os com o estado anterior conhecido antes de propor o "rollback" (reversão).

Não colete um "bugreport" completo, a menos que evidências limitadas sejam insuficientes. "Bugreports" podem conter identificadores de conta, atividade de aplicativos, detalhes de rede, notificações e outros dados sensíveis.

3. Reproduzir com uma Comparação Controlada

Defina uma comparação de sucesso/falha antes de alterar qualquer coisa. Exemplos:

• repouso com modo avião versus repouso em sinal celular fraco;
• mesma carga de trabalho em Wi-Fi versus dados móveis;

…