Solución de problemas

Comprobaciones prácticas para las conexiones de depuración, la instalación y el cambio de launcher.

No encuentro las Opciones de desarrollador

Busca en Ajustes → Sistema o Preferencias del dispositivo → Información. Pulsa siete veces la entrada Build. Los nombres varían según el fabricante. Si un dispositivo gestionado o proporcionado por un ISP bloquea los controles de depuración, este flujo de trabajo puede no estar disponible en ese firmware. No sigas cambiando los ajustes del router para resolver una restricción del firmware.

Mi ordenador no encuentra el televisor

  • Confirma que el televisor está encendido y que ambos dispositivos están en la misma red local. Una red Wi-Fi de invitados o una red IoT aislada puede impedir que los dispositivos se comuniquen.
  • Vuelve a comprobar la dirección IP actual del televisor en sus ajustes de red. La dirección puede cambiar después de reiniciar.
  • Activa la depuración USB y la depuración de red/ADB si el televisor ofrece esos interruptores. Mira el televisor para ver el diálogo de autorización y aprueba únicamente tu ordenador de confianza.
  • Algunos modelos Google TV utilizan un código de emparejamiento de depuración inalámbrica y un puerto temporal en lugar de abrir de inmediato el puerto 5555. Sigue los pasos de emparejamiento del prompt de instalación.
  • Nunca redirijas el puerto ADB a través del router de Internet.

En macOS, el mensaje «No route to host» puede deberse a la privacidad de la red local. El paquete de código fuente incluye un cliente ADB de Python como alternativa; después de extraer el paquete de código fuente, lee docs/TROUBLESHOOTING.md en la sección Connecting antes de suponer que el televisor está desconectado.

Un altavoz o una unidad USB dejó de funcionar

Algunas cajas de TV cambian el comportamiento de sus puertos USB mientras la depuración USB está activada. Desactiva la depuración cuando termines y vuelve a comprobar el dispositivo. El launcher no necesita que la depuración permanezca activada para el uso diario.

Falló la compilación del launcher o la instalación del APK

Usa el paquete de código fuente completo extraído, no un APK o un archivo de compilación descargado por separado. Prepara Python 3, JDK 17, Android SDK Platform 34 y Android Build Tools 34.0.0. Revisa el error real en lugar de desactivar la verificación o instalar un APK no relacionado. Algunos firmwares de TV también piden confirmación en pantalla durante la instalación.

El README.md y docs/TROUBLESHOOTING.md extraídos del paquete de código fuente son los materiales de referencia para los requisitos de compilación y los problemas específicos del modelo. Los scripts de compilación para Windows y macOS/Linux deben colocarse en el directorio launcher/ extraído.

El botón Home todavía abre el launcher antiguo

Instalar la aplicación y convertirla en el propietario de Home son pasos diferentes. Primero comprueba que el nuevo launcher pueda abrirse. Pide al asistente que inspeccione qué componente gestiona realmente Home y que siga las notas de tu modelo exacto. Mantén un launcher funcional activado durante el cambio. No adivines ni desactives un paquete del sistema solo porque su nombre parezca relacionado.

Cambiaron el mando, el audio, HDMI o la transmisión

Deja de hacer cambios y compara los cambios de paquetes más recientes con la copia de seguridad original. Estas funciones pueden depender de servicios del fabricante. Usa el proceso de restauración correspondiente y prueba cada función por separado.

Las aplicaciones de streaming siguen mostrando anuncios

Es lo esperado. El proyecto cambia la pantalla de inicio del sistema y determinados servicios del fabricante. No elimina la publicidad ni los requisitos de suscripción dentro de YouTube, Netflix u otras aplicaciones de streaming.

Qué incluir en un issue público

Comparte el modelo, la región, la versión del firmware, el paso que falla y un mensaje de error redactado. Mantén fuera de los informes públicos las direcciones privadas, los identificadores del dispositivo, las claves de depuración, las credenciales y las copias de seguridad completas.

Descarga los materiales de solución de problemas · Vuelve a la configuración