Solução de problemas

Não consigo encontrar as Opções do desenvolvedor

Procure em Configurações → Sistema ou Preferências do dispositivo → Sobre. Pressione a entrada Build sete vezes. Os nomes variam conforme o fabricante. Se um dispositivo gerenciado ou fornecido por um provedor de internet bloquear os controles de depuração, este fluxo de trabalho pode não estar disponível nesse firmware. Não continue alterando as configurações do roteador para resolver uma restrição do firmware.

Meu computador não encontra o televisor

• Confirme que o televisor está ligado e que os dois dispositivos estão na mesma rede local. Uma rede Wi-Fi de convidado ou uma rede IoT isolada pode impedir a comunicação entre eles.
• Confira novamente o endereço IP atual do televisor nas configurações de rede. O endereço pode mudar depois de uma reinicialização.
• Ative a depuração USB e a depuração de rede/ADB se o televisor oferecer essas opções. Observe a caixa de diálogo de autorização na TV e aprove somente o seu computador confiável.
• Alguns modelos Google TV usam um código de pareamento de depuração sem fio e uma porta temporária, em vez de abrir imediatamente a porta 5555. Siga as etapas de pareamento no prompt de instalação.
• Nunca encaminhe a porta ADB pelo roteador da internet.

No macOS, a mensagem “No route to host” pode ser causada pela privacidade da rede local. O pacote de código-fonte inclui um cliente ADB em Python como alternativa; depois de extrair o pacote de código-fonte, leia docs/TROUBLESHOOTING.md na seção Connecting antes de concluir que o televisor está offline.

Um alto-falante ou unidade USB parou de funcionar

Alguns aparelhos de TV mudam o comportamento da porta USB enquanto a depuração USB está ativada. Desative a depuração quando terminar o trabalho e verifique o dispositivo novamente. O launcher não precisa manter a depuração ativada para o uso diário.

A compilação do launcher ou a instalação do APK falhou

Use o pacote de código-fonte completo extraído, não um APK ou arquivo de compilação baixado separadamente. Prepare Python 3, JDK 17, Android SDK Platform 34 e Android Build Tools 34.0.0. Analise o erro real em vez de desativar a verificação ou instalar um APK sem relação. Alguns firmwares de TV também pedem confirmação na tela durante a instalação.

O README.md e docs/TROUBLESHOOTING.md extraídos do pacote de código-fonte são os materiais de referência para pré-requisitos de compilação e problemas específicos do modelo. O script de compilação para Windows e o script para macOS/Linux devem ser colocados no diretório launcher/ extraído.

O botão Home ainda abre o launcher antigo

Instalar o aplicativo e torná-lo o proprietário do Home são etapas diferentes. Primeiro, verifique se o novo launcher consegue abrir. Peça ao assistente para verificar qual componente realmente controla o Home e seguir as notas do seu modelo exato. Mantenha um launcher funcional ativado durante a transferência. Não adivinhe nem desative um pacote do sistema apenas porque o nome parece relacionado.

O controle remoto, o áudio, o HDMI ou a transmissão mudaram

Pare de fazer alterações e compare as mudanças de pacotes mais recentes com o backup original. Esses recursos podem depender de serviços do fabricante. Use o processo de restauração correspondente e teste cada recurso separadamente.

Os aplicativos de streaming ainda exibem anúncios

Isso é esperado. O projeto altera a tela inicial do sistema e alguns serviços do fabricante. Ele não remove anúncios nem requisitos de assinatura dentro do YouTube, Netflix ou outros aplicativos de streaming.

O que incluir em um issue público

Compartilhe o modelo, a região, a versão do firmware, a etapa que falhou e uma mensagem de erro com dados sensíveis removidos. Não inclua em relatórios públicos endereços privados, identificadores do dispositivo, chaves de depuração, credenciais ou backups completos.

Baixar os materiais de solução de problemas · Voltar à configuração