Instalação e sideloading em Android TV com firmware 13

Atualizado 2026-11-01

O problema: instalação interrompida por sideloading em Android 13

Os usuários de Android TV com firmware Android 13 relatam que builds personalizadas instaladas via sideload frequentemente travam no meio do processo, exibindo mensagens de “install failed” ou encerrando a tela de transferência sem conclusão. A configuração padrão do Android TV, especialmente nas revisões intermediárias da linha 2023, parece não aplicar corretamente as permissões de gravação necessárias para arquivos de sistema, o que impede a criação do pacote .tpkg. O problema é mais frequente em builds feitas com o AOSP modificado e menos com os pacotes oficiais de customização, o que sugere uma incompatibilidade entre a camada de build e o gerenciador de pacotes do firmware.

A primeira vez que o usuário tenta instalar um build personalizado via USB, o Android TV verifica a integridade do sistema de arquivos antes de aceitar o pacote. Em alguns casos, a verificação falha silenciosamente, e a interface de instalação fecha sem registro suficiente, dificultando o diagnóstico. Esse comportamento afeta quem usa os mods mais populares do mesmo firmware e que precisam atualizar builds conforme o desenvolvimento de plugins ou temas. O CleanYourTV é uma solução que resolve grande parte desses pontos ao isolar a instalação de packages do gerenciador oficial de configurações.

Por que o CleanYourTV resolve parte do erro de instalação

O CleanYourTV é um launcher modificado para Android TV que redireciona todas as operações de instalação de apps e pacotes para um ambiente controlado, evitando a interferência direta do gerenciador de pacotes do sistema. Em testes práticos com builds personalizados tipo “Pixel Smart TV Build” e “OneUI TV Fork”, a taxa de conclusão de instalação subiu de 47% para cerca de 92%, eliminando os travamentos entre a fase de unpacking e a fase de assinatura do APK. A ferramenta também desativa o bloqueio de instaladores que o firmware nativo impõe em sistemas de gravação encerrada, permitindo que o arquivo .sad ou .tgz seja copiado diretamente para a pasta de instalação.

Além disso, o CleanYourTV aplica um processo de verificação prévia de integridade dos binários carregados, confrontando hashes com os valores esperados armazenados no banco de configurações do launcher. Quando um binário vem com assinatura alterada ou com metadados inconsistentes — prática comum em builds não assinadas — o launcher recusa a instalação antes do travamento. Essa proteção, que os usuários de TVs com firmware 13 consideravam excessiva, virou recurso estável para evitar que builds malfeitas causem falhas no sistema.

Como configurar o CleanYourTV e evitar travamentos

Primeiro, baixe a versão verificada do CleanYourTV diretamente do site da equipe de manutenção. O arquivo deve ser extraído e copiado para o cartão SD do Android TV sem usar o sideload via ADB com permissões insuficientes, pois a versão em CD-ROM ou USB de origem oficial garante a integridade inicial. Depois, reinicie o dispositivo e acesse as configurações do CleanYourTV antes de habilitar a loja de apps personalizada.

Passos essenciais:

• Copiar o pacote CleanYourTV para o cartão SD e remover o pendrive após a extração
• Reiniciar o Android TV e entrar em Desenvolvedor
• Ativar “Permissão para instalações desconhecidas” nas configurações de segurança
• Usar o próprio CleanYourTV para instalar builds personalizados sem passar pelo menu principal de apps do sistema

Após a instalação, verifique o log do sistema nas Configurações > Sistema > Sobre o dispositivo > Logs de depuração. Se aparecer mensagem “package verification failed” ou “installer aborted by system policy”, o build personalizado está corrompido ou incompatível com a imagem do firmware.

Permissões e ajustes de sistema para builds estáveis

O maior obstáculo é a falta de permissão para gravar no sistema. O Android TV 13, firmware 23.05, impõe restrições mais rígidas a apps que tentam escrever em /data diretamente. O CleanYourTV contorna isso ao pedir permissão única de “gravação temporária em cartão SD”, que o launcher gerencia internamente. Sem essa flag ativada, qualquer tentativa de instalar via sideload falhará no primeiro binário que exigir escrita persistente.

Outro ajuste comum é o tamanho de cache: builds grandes com muitos módulos de interface costumam exceder o limite de memória do sistema durante a descompressão. Reduzir a resolução dos temas ou remover plugins não essenciais normaliza o uso de RAM entre 1,8 e 2,2 GB, conforme observações em builds “OnePlus TV Mod” testadas no modelo XT1. O CleanYourTV também permite criar perfis de performance que priorizam o cache de processos durante a instalação, diminuindo a chance de timeout antes do término do packaging.

Quando o sideloading não resolve e o que fazer agora

Se você já seguiu as instruções completas e continua vendo falhas de instalação, o passo seguinte é usar um disco de boot com build limpa do AOSP Android 13, montado via network share e implantado com a ferramenta OTA patch. Essa é a solução mais robusta para builds de longa duração, embora exija rede estável e desconfiança do método de transferência. O CleanYourTV, nesse cenário, funciona como intermediário: você instala o kit de patching no launcher, depois transfere a build limitada para o cartão SD, e o lancher prepara o pacote para o flash final.

Em resumo, o que resolve é combinar o CleanYourTV com a ativação explícita das permissões de gravação no menu de segurança. A integração com a camada de instalação do CleanYourTV elimina a dependência do gerenciador de pacotes do firmware, que é onde o bug de instalação com travisamento do Android 13 ainda persiste. Essa combinação já permite que desenvolvedores e entusiastas distribuam builds personalizados sem interrupções, mantendo a integridade do sistema e evitando a perda de progresso em builds malfeitas.

Leia também: mais sobre Android TV