WebIDE のトラブルシューティング

USB 経由で Android 版 Firefox に接続する

Android OS で実行している Firefox のインスタンスに接続できない場合は、以下の項目を確認してください:

  • Firefox のバージョンを確認する: デバイスで Android 版 Firefox 36 以降を実行していることを確認してください。WebIDE はこれより古いバージョンを自動的に検出できず、ポートフォワーディングを有効化してデバイスのポートに接続しなければなりません。こちらの手順に従ってください。
  • Firefox でリモートデバッグを有効化しているか確認する: Android 版 Firefox を起動してメニューを開き、設定を選択します。そして、高度な設定 > USB 経由でリモートデバッグするにチェックを入れてください。
  • デバイスの開発者向けオプションで、USB デバッグを有効にしてください。
  • まだ WebIDE のウィンドウにデバイスが表示されない場合は、電話機でリモートデバッグの有効化を再度行ってください。
    • デバイスをコンピューターから切り離して、デバイス側でリモートデバッグを無効にします。
    • デバイスをコンピューターに接続して、リモートデバッグを有効化します。ここで、デバイス側のデバッガのインスタンスが再起動します。
    • WebIDE から再び接続してみてください。
  • 使用している USB ケーブルの確認:
    • USB ケーブルをいったん外し、再び接続してください。
    • USB ケーブルを、コンピューターの別の USB ポートに接続してください。つなぎ替えが必要であるかもしれません。
    • 別の USB ケーブルで試してください。電話機に同梱されるケーブルは低品質で、接続が失敗することがあります。
    • 短い USB ケーブルを使用してください。長い USB ケーブルではうまく動作しないことがあります。
  • Linux を使用している場合の確認事項:
    • 開発用に端末をセットアップする のステップ 3 に記載されているとおりに、udev のルールファイルにルールを追加してください。Android の idVendor 値のリストが役に立つでしょう。そして、デバイスを表示させるために adb devices を実行してください。デバイスが "no permission" と表示される場合は、adb サーバーの再起動が必要です (例: adb kill-server;adb start-server)。
    • Debian が提供する android-tools-adb パッケージを使用する場合は、ADB Helper を使用するために既存の ADB サーバーをすべて終了しなければならないでしょう。このパッケージは ADB Helper が依存している、サーバーへの TCP 接続を無効化します。
  • Windows を使用している場合の確認事項:
    • Android デバイスが正常に認識されていて、Android SDK に含まれている Google USB Driver を使用していることを確認してください。
  • Mac OS X を使用している場合の確認事項:
    • EasyTether を使用している場合は、EasyTether のアンインストールまたは無効化が必要です: sudo kextunload /System/Library/Extensions/EasyTetherUSBEthernet.kext

Wi-Fi 経由で Android 版 Firefox に接続する

  • Firefox のバージョンを確認する: Wi-Fi デバッグを使用するには Firefox 42 以降と、Android 版 Firefox 42 以降を実行している Android デバイスが必要です。
  • デスクトップ版 Firefox を実行するコンピューターと Android デバイスの両方を、同じ Wi-Fi ネットワークに接続しなければなりません。
    • 詳しくいうとデスクトップ側で、Wi-Fi ネットワークへのルートがある有線ネットワークを使用することはできません。代わりに、両方を Wi-Fi に直接接続してください。
  • バーコードスキャンアプリをインストール済みなのを確認してください。これを推奨します。
  • Wi-Fi ネットワークによっては Wi-Fi 端末検索に使うパケットをブロックすることがあります。ネットワーク管理者にこうした行為が許可されているかを確認してください:
    • コンピューターと Android デバイスは UDP マルチキャストパケットをポート 50624-50625 からマルチキャストアドレス 224.0.0.115 に送受信できなければなりません。
    • ネットワークルーターが UDP マルチキャストパケットをサポートしていなければなりません。
    • ルーターはこの UDP マルチキャストパケットをフォワードせず、実効的にはつまり、両方の端末は他のホップを経由せずに直接同じルーターと通信する必要があります。

プロジェクトの一覧を読み込みできない

あるバージョンの Firefox で WebIDE を開いた後に、同じプロファイルを使用したまま Firefox をダウングレードすると、ダウングレード後の Firefox で WebIDE を開いた際に "Unable to load project list" というエラーが表示されることがあります。

これは WebIDE が使用するストレージシステム (IndexedDB) で、新しいバージョンの Firefox 向けに内部ファイルの移動や再構築が必要になったときに発生します。古いバージョンの Firefox では、プロジェクトの一覧にアクセスできなくなります。

データは失われていませんがプロジェクトの一覧にアクセスするには、プロファイルを使用していた新しいバージョンの Firefox を使用し続けなければなりません。

やむを得ず古いバージョンの Firefox を使用する場合は以下の手順でプロジェクト一覧のみ削除できますが、サポート外の手順ですのでさらなるトラブルやデータの喪失を招く可能性があります:

  1. Firefox を閉じます。
  2. Firefox のプロファイルのディレクトリーを開きます。
  3. プロファイルのディレクトリー内で storage フォルダを探します。
  4. このフォルダ配下のファイルツリー内に、4268914080AsptpcPerjo (データベース名のハッシュ) で始まる名前のファイルやフォルダが見つかるでしょう。
    • 例えば、<profile>/storage/permanent/indexeddb+++fx-devtools/idb に存在します。
  5. 該当するファイルやフォルダを削除します。
  6. 再び Firefox と WebIDE を開きます。

ログ取得を有効化する

診断情報を収集するために、詳細なログを取得できます:

  1. about:config を開き、新しい設定項目 extensions.adbhelper@mozilla.org.sdk.console.logLevel を作成して、文字列値 all を設定します。また、extensions.adbhelper@mozilla.org.debug を true に設定します。
  2. アドオンマネージャで ADB Helper アドオンを無効化して、再び有効化します。
  3. ブラウザーコンソールを開くと、接頭辞 adb が付加されたメッセージが表示されます。メッセージが表示されない場合は、支援を求めてください。

支援を求める

IRC の #devtools ルームを訪れて、支援を求めてください。