トラブルシューティング
デバッグ接続、インストール、ランチャーの切り替えを確認するための実用的な手順です。
開発者向けオプションが見つからない
「設定」→「システム」または「デバイス設定」→「デバイス情報」を確認します。Build の項目を7回押してください。名前はメーカーによって異なります。管理対象の端末や ISP が提供する端末でデバッグ設定がロックされている場合、このファームウェアでは手順を利用できない可能性があります。ファームウェアの制限を解決するために、ルーター設定を変更し続けないでください。
パソコンからテレビが見つからない
- テレビの電源が入り、両方の端末が同じローカルネットワークにあることを確認します。ゲスト Wi-Fi や分離された IoT ネットワークでは、端末同士が通信できないことがあります。
- テレビのネットワーク設定で現在の IP アドレスを確認し直します。再起動後にアドレスが変わることがあります。
- テレビにそのスイッチがある場合は、USB デバッグとネットワーク/ADB デバッグを有効にします。テレビに表示される認証ダイアログを確認し、信頼できる自分のパソコンだけを許可してください。
- 一部の Google TV モデルでは、ポート5555をすぐ開く代わりに、ワイヤレスデバッグのペアリングコードと一時ポートを使います。インストールプロンプトのペアリング手順に従ってください。
- ADB ポートをインターネットルーター経由で転送しないでください。
macOS では、「No route to host」というメッセージがローカルネットワークのプライバシー設定によって起きることがあります。ソースパッケージには代替手段として Python ADB クライアントが含まれています。ソースパッケージを展開した後、テレビがオフラインだと決めつける前に docs/TROUBLESHOOTING.md の Connecting を読んでください。
USB スピーカーまたはドライブが動かなくなった
一部の TV ボックスでは、USB デバッグが有効な間に USB ポートの動作が変わります。作業が終わったらデバッグを無効にし、デバイスをもう一度確認してください。日常利用でデバッグをオンにしておく必要はありません。
ランチャーのビルドまたは APK のインストールに失敗した
単独でダウンロードした APK やビルドファイルではなく、完全なソースパッケージを展開して使います。Python 3、JDK 17、Android SDK Platform 34、Android Build Tools 34.0.0 を準備します。検証を無効にしたり関係のない APK をインストールしたりせず、実際のエラーを確認してください。テレビのファームウェアによっては、インストール中に画面上の確認も求められます。
ソースパッケージから展開した README.md と docs/TROUBLESHOOTING.md が、ビルドの前提条件とモデル固有の問題を確認するための資料です。付属の Windows ビルドスクリプトと macOS/Linux ビルドスクリプトは、展開した launcher/ ディレクトリに置く必要があります。
Home ボタンを押しても古いランチャーが開く
アプリをインストールすることと、それを Home の所有者にすることは別の手順です。まず新しいランチャーを開けるか確認します。実際に Home を処理しているコンポーネントをアシスタントに調べさせ、正確なモデルのメモに従ってください。切り替え中は動作するランチャーを有効に保ちます。名前が関係ありそうだからという理由だけで推測したりシステムパッケージを無効にしたりしないでください。
リモコン、音声、HDMI、キャストが変わった
変更を止め、直近のパッケージ変更と元のバックアップを比較します。これらの機能はメーカーのサービスに依存していることがあります。対応する復元手順を使い、各機能を個別にテストしてください。
ストリーミングアプリに広告が残る
これは想定どおりです。プロジェクトが変更するのはシステムのホーム画面と、選択したメーカーサービスです。YouTube、Netflix、その他のストリーミングアプリ内の広告や、サブスクリプションの要件を削除するものではありません。
公開 issue に含める情報
モデル、地域、ファームウェアバージョン、失敗した手順、個人情報を伏せたエラーメッセージを共有してください。公開レポートには、個人アドレス、デバイス識別子、デバッグキー、認証情報、完全なバックアップを含めないでください。