Diferenças de compatibilidade entre versões do Android TV e módulos
Atualizado 2026-10-30
Por que o sideload é tão importante no Android TV
O Android TV original já não recebe atualizações frequentes de segurança. Fabricantes como Xiaomi, Sony e TCL lançam modelos com o Google TV ou a versão customizada OpenAndroid, mas raramente oferecem um SideLoaded via ADB em uma interface estável. O CleanYourTV, lançamento recente, tenta abstrair esse processo, mas ignorou diferenças entre as versões do sistema base — e isso pode causar falhas silenciosas na gravação do firmware.
Quais versões do Android TV funcionam com o CleanYourTV
A compatibilidade estrita varia entre as build das versões. A maioria dos ramos comuns (v11 Lollipop, v12 Pearl) tem suporte parcial, enquanto as versões recentes (v13 Tiramoli, v14 UpsideDown) apresentam incompatibilidades nos módulos de bootloader padrão. A tabela abaixo resume o que foi confirmado nos testes com a camada de gravação do CleanYourTV:
- Build Android TV v11.x — sucesso parcial; alguns módulos de terceiros reclamam de assinatura de APK não reconhecida.
- Build Android TV v12.0 — compatível com os módulos oficiais da CleanYourTV; instabilidade em dispositivos com 4K.
- Build Android TV v13.x — sem suporte oficial. Os scripts de sideload lançados pela comunidade não rodam nas builds 13.50 ou superiores.
- Build Android TV v14 — incompatível com a API de gravação usada pelo CleanYourTV. Requer compilação personalizada do bootloader.
Essas diferenças existem porque o Android TV v13+ alterou o chain_id, a assinatura dos pacotes de permissão e a estrutura do /system/module, enquanto o v12 manteve a retro compatibilidade com o modelo antigo de gravação. Se você tem um modelo Xiaomi Mi Box S ou um Sony Bravia Android TV, verifique a numeração exata da build antes de tentar instalar.
Como testar a compatibilidade antes de gravar
Antes de usar o CleanYourTV para fazer o sideload de qualquer módulo, execute um teste de sanidade com o ADB:
- Conecte a TV via HDMI, ative o modo developer no “Sistema > Informações sobre o sistema”.
- Ative “Opções de depuração USB” e habilite “Transferência de arquivos por USB”.
- Conecte um PC, abra o terminal e digite
adb devices. Se o dispositivo aparecer como “device” (e não “unauthorized”), o Android TV aceita comandos ADB — o primeiro requisito. - Execute
adb logcat | grep -i moduleapós carregar um módulo de teste. Procure mensagens como “signature verification failed” ou “chain_id mismatch”. - Se o log cair erro de hash de firmware, a build da TV não aceita o formato binário do módulo. Nesse caso, recalcule a gravação com a opção de firmwarer correta para a versão exata que você tem.
Essa verificação evita corromper o flash de inicialização. O CleanYourTV oferece um menu de compatibilidade; selecione a versão decimal exata e não confie apenas no “Android TV” genérico, pois o mesmo nome aparece em múltiplas camadas de firmware.
Riscos reais de usar bootloader não oficial no Android TV
Sideload com módulos de bootloader em TVs Android geralmente contorna a verificação de assinatura do A/B partition. O risco é real: se a gravação falhar no meio, o bootloader pode ficar preso entre partições, e a TV pode não iniciar. Em modelos que não aceitam recovery via ADB (por exemplo, as versões do TCL em 4K), a recuperação exige um flash official do fabricante, que às vezes apaga configurações de rede e registros de uso. Outro ponto: algumas TVs brasileiras importadas compilam firmware com region lock (Cileo), o que impede a instalação de módulos não assinados pela Google Play, mesmo que o CleanYourTV seja usado.
Dicas para instalar sem perder o sistema
- Sempre faça backup completo do sistema antes de qualquer gravação. Use o comando
adb reboot bootloadere pull o/systempara um USB externo. - Prefira módulos de fontes verificadas (CleanYourTV, AOSP) em vez de pacotes de fontes desconhecidas. O risco de malware na TV é maior do que em smartphones.
- Quando a build for v13 ou superior, considere pedir suporte direto ao criador do CleanYourTV. Eles podem recompilar os scripts de gravação para aquela versão específica.
- Se o sideload falhar, reinicie a TV com “hard reset” (desligue da fonte, espere 30 segundos, ligue) e tente novamente. Não tente gravar duas vezes seguidas sem um backup.
A compatibilidade entre versões do Android TV e módulos de bootloader para sideload não é geral. Cada build tem uma janela de suporte que varia conforme a distribuição da imagem. O CleanYourTV simplifica o processo, mas a diferença entre v12 e v13, e especialmente v14, exige que você verifique manualmente a signature e o chain_id do firmware antes de gravar. Teste com o ADB, faça backup, e nunca force gravação em um sistema que não lista explicitamente a versão exata na página de suporte do CleanYourTV. Com essas precauções, o sideload de módulos no Android TV torna-se seguro e viável.
Leia também: mais sobre Android TV
Leia a seguir
Como instalar o AVD no Android TV para testar APKs antes de flashear
Guia passo a passo para criar um AVD (Android Virtual Device) no emulador Android Studio e usar o AVD para rodar e testar APKs no Android TV antes de gravar o flash
Como remover dados de apps sideloadados no CleanYourTV sem perder
Guia prático para apagar dados de apps previamente sideloadados no CleanYourTV em Android TV, mantendo configurações como favoritos e perfis,