Android 版 Firefox で動かす拡張機能を Wireless debug する

adb の接続は以下の通り。

• Android の開発者オプション表示を有効にする

  • Android の設定 → バージョン表示画面 → アイコンを複数回タッチ

• Android の開発者オプションを設定

  • USB デバッグ機能を有効化

    • USB デバッグを有効化しないと、Wireless デバッグが有効化できない

  • ワイヤレスデバッグ機能を有効化

    • ワイヤレスデバッグ機能の IP:ポート が表示 されているので、これをメモる。(memo_A)

  • ワイヤレスデバッグ機能内のペア設定コードでペア設定を選択

    • → 表示された IPアドレス、ポートと設定コードをメモる (memo_B)
  • 上記でメモった port は、 memo_A, memo_B で異なるので注意
  • また、有効化実行毎に port が変わる
• PC の adb で以下を実行 ( memo_B )

adb pair ip:port    ※ ip, port には上記でメモった値(memo_B)を指定

• 上記コマンドを実行すると設定コード入力を求められるので、メモった値( memo_B )を入力
• PC の adb で以下を実行 ( memo_A )

adb connect ip:port    ※ ip, port には上記でメモった値(memo_A)を指定

• PC の adb で以下を実行

adb devices

• 正常に接続されていれば、以下のような出力になる。

  • "device" と表示されていることが重要。
  • 不正な状態だと "offline" と出力される。 あるいは、何も出力されない。

List of devices attached
ip:port     device

adb の接続を確立した後、以下の手順で PC 内の拡張機能を Android Firefox にロードする

• Android 版 Firefox のメニューから、「リモート経由で USB デバッグをする」を有効化

  • Firefox としては adb の機能を利用しているだけであり、 adb が USB で接続されているか、あるいは WiFi で接続されているかは Firefox としては関係ない。
  • 当初 adb は USB 接続が前提だったため、 「USB デバッグ」というメッセージになっている。
• PC 側の拡張機能を開発している(manifest.json がある)ディレクトリに移動
• 次を実行

1
2
3
4
5

$ adb shell pm grant ${FIREFOX_PACK}				\
		android.permission.READ_EXTERNAL_STORAGE
$ web-ext run -t Firefox-android --adb-device ${IP}:${PORT}	\
			--adb-bin "${ADB_PATH}"			\
			--Firefox-apk ${FIREFOX_PACK}

• 上記の IP, PORT は memo_A を指定
• 上記の ADB_PATH は、 adb のフルパスを指定

• 上記の FIREFOX_PACK は、以下のどちらか

  • org.mozilla.Firefox (通常アプリ)
  • org.mozilla.fenix (Nightly)

上記で PC 内の拡張機能が Android 内の Firefox にロードされる。

ロードには署名も不要で、 PC 内の拡張機能のソースを修正すると自動で Android 側にロードされる。

最後にFirefox デバッガを接続する。

• PC 側の Firefox のアドレスバーに about:debugging を入力する
• about:debugging 画面左側に、接続されている Android 端末を示す情報と「接続」ボタンを押下
• about:debugging 画面左側に、接続されている Android 端末を示す情報をクリック
• about:debugging 画面に表示された Android 端末内のデバッグしたい拡張機能をクリック

以上で、Firefox デバッガの接続が完了する。