Dépannage

Vérifications pratiques pour les connexions de débogage, l'installation et le transfert du launcher.

Je ne trouve pas les Options pour les développeurs

Regardez dans Paramètres → Système ou Préférences de l'appareil → À propos. Appuyez sept fois sur l'entrée Build. Les noms varient selon le fabricant. Si un appareil géré ou fourni par un FAI verrouille les commandes de débogage, ce flux de travail peut ne pas être disponible sur ce firmware. Ne continuez pas à modifier les paramètres du routeur pour résoudre une restriction du firmware.

Mon ordinateur ne trouve pas le téléviseur

  • Confirmez que le téléviseur est allumé et que les deux appareils sont sur le même réseau local. Un réseau Wi-Fi invité ou un réseau IoT isolé peut empêcher les appareils de communiquer.
  • Vérifiez à nouveau l'adresse IP actuelle du téléviseur dans ses paramètres réseau. Elle peut changer après un redémarrage.
  • Activez le débogage USB et le débogage réseau/ADB si le téléviseur propose ces options. Surveillez la boîte de dialogue d'autorisation sur le téléviseur et n'autorisez que votre ordinateur de confiance.
  • Certains modèles Google TV utilisent un code d'association de débogage sans fil et un port temporaire au lieu d'ouvrir immédiatement le port 5555. Suivez les étapes d'association du prompt d'installation.
  • Ne redirigez jamais le port ADB via votre routeur Internet.

Sur macOS, le message « No route to host » peut être causé par la confidentialité du réseau local. Le paquet de code source inclut un client ADB Python comme solution de repli ; après avoir extrait le paquet de code source, lisez docs/TROUBLESHOOTING.md sous Connecting avant de conclure que le téléviseur est hors ligne.

Un haut-parleur ou un lecteur USB ne fonctionne plus

Certains boîtiers TV modifient le comportement de leur port USB lorsque le débogage USB est activé. Désactivez le débogage une fois le travail terminé et vérifiez à nouveau l'appareil. Le launcher n'a pas besoin que le débogage reste activé pour un usage quotidien.

La compilation du launcher ou l'installation de l'APK a échoué

Utilisez le paquet de code source complet extrait, pas un APK ou un fichier de compilation téléchargé seul. Préparez Python 3, JDK 17, Android SDK Platform 34 et Android Build Tools 34.0.0. Examinez l'erreur réelle au lieu de désactiver la vérification ou d'installer un APK sans rapport. Certains firmwares de téléviseur demandent également une confirmation à l'écran pendant l'installation.

Le README.md et docs/TROUBLESHOOTING.md extraits du paquet de code source sont les références pour les prérequis de compilation et les problèmes spécifiques au modèle. Le script de compilation Windows et le script macOS/Linux doivent être placés dans le répertoire launcher/ extrait.

Le bouton Home ouvre toujours l'ancien launcher

Installer l'application et en faire le propriétaire de Home sont deux étapes différentes. Vérifiez d'abord que le nouveau launcher peut s'ouvrir. Demandez à l'assistant d'inspecter le composant qui gère réellement Home et de suivre les notes de votre modèle exact. Gardez un launcher fonctionnel activé pendant le transfert. Ne devinez pas et ne désactivez pas un paquet système simplement parce que son nom semble lié.

La télécommande, l'audio, le HDMI ou la diffusion ont changé

Arrêtez les modifications et comparez les derniers changements de paquets avec la sauvegarde d'origine. Ces fonctions peuvent dépendre de services du fabricant. Utilisez le processus de restauration correspondant, puis testez chaque fonction séparément.

Les applications de streaming affichent toujours des publicités

C'est prévu. Le projet modifie l'écran d'accueil du système et certains services du fabricant. Il ne supprime ni la publicité ni les exigences d'abonnement à l'intérieur de YouTube, Netflix ou d'autres applications de streaming.

Que mettre dans un issue public

Partagez votre modèle, votre région, la version du firmware, l'étape qui échoue et un message d'erreur expurgé. Ne publiez pas les adresses privées, identifiants d'appareil, clés de débogage, identifiants de connexion ni sauvegardes complètes.

Télécharger les documents de dépannage · Retourner à la configuration