でんげき☆ Network Service

Android と PC のための adb メモ

　
Android Debug Bridge（adb）なるものがあります　Debug Bridge なんて聞くと「なんか面倒くさそうだな…」って思いがちだけど…一般利用者的な使い方でも「知っておくと得をする」ような便利な機能があるっていうか忘れがちな使い方をまとめて忘れ物防止メモって感じで書き留めておきます

　　：

一般的には Android 端末と PC を USB ケーブルで繋ぎます　なんかここんとこ Wi-Fi を使ってケーブル無しで繋ぐ手法が確立されてきてるようだけど…その話は後述って感じで


まずはスマホ側の設定ってことで「設定」メニューから「システム」→「端末情報」と進みます　※機種により若干の操作法の違い有り


その中にある「ビルド番号」を連打する


既に有効にしてあったんでアレだけど…これで「開発者向けオプション」を有効にできます

※機種によっては「設定」メニューからいきなり「デバイス情報」って入る場合や「詳細設定」の中に入っている場合とかがあるようです　まぁその辺はそれっぽい項目を選びつつ「ビルド番号」を探し出してそれを連打してください（汗


次に「設定」メニューから「システム」→「詳細設定」と進むと「開発者向けオプション」が現れます　※これも機種によって進むべきメニュー項目が違う場合があるんで…あちこち探して辿り着いてください（汗


「開発者向けオプション」内にある「USBデバッグ」をオンにして許可する　これで端末側の設定は概ね完了です

　　：

お次は PC 側の設定ってことで…本来 adb ってやつは Android Studio って開発ツールに含まれているものなんでそれをセットアップする必要があるんだけど単に adb だけを使いたい人向けにシンプルなパッケージが用意されているんでそれを入れることにします


sudo apt install adb

なお動作検証っていうか…基本的に xubuntu 20.04 LTS を USB メモリに書き込んだものをお試しモードっていうかライブ起動して諸々を試しています　画像の撮り忘れなんかで…本番環境の Ubuntu MATE 20.04 LTS を使う場合もありますがその辺はご了笑ください汗


インストールが完了したら先ほどの「USBデバッグ」をオンにした Android と PC を USB ケーブルで繋ぎ adb start-server してみましょう　daemon started successfully と出れば成功です
この操作は省略してもいいのですが…接続した Android 機と PC とのやりとりを管理するデーモン（adbd）の起動を明確に確認できるので知っておいていいと思います
ちなみにデーモン（adbd）を終了する際には adb kill-server します　いろいろな端末を繋ぎつつ作業してると稀に動作が不安定になる場合とかあるようなので…いったんデーモンを終了させて再び起動させるとうまくいく時があります


そんな adb ですが 1 台の PC に複数台の Android を接続することができます　接続した Android(のシリアル) は adb devices で確認することができます


そのシリアルを adb の -s オプションを使って指定するとその Android 機を操作できます　画像はそれぞれの Android 内の proc フォルダ内にある cpuinfo ファイルの末尾 10 行くらいを表示させた一例です
なお PC に 1 台だけ Android 機を接続して使用する際にはこの -s オプションは不要です　今後は説明の簡略化っていうか 1 台だけの接続にして -s オプションは省略した感じでいきます

　　：

それでは adb のよく使うコマンドの説明をちょびっとだけ…


adb shell で接続した Android 機にログイン(？)できます　コマンドライン上の操作で Linux 系のコマンドが使えます


adb shell コマンド名 だと PC 側の端末上で接続した Android 機のコマンドを実行できます　実行結果を PC 側のファイルにリダイレクトしたりパイプに送り込んだりできます
ちなみにここで試している pm コマンドはパッケージ・マネージャ系のコマンドですね　これに list package なる引数を与えて起動するとその端末にインストールされているアプリの一覧を確認できます　ここではその結果から grep を用いて必要な行だけ抽出して表示させています


パッケージの一覧を確認できたってことで…それじゃ Android 機からファイルを取ってくる adb pull を使って apk(アプリ) を抜いてみましょう
目的とするアプリの ID(？) を指定することで apk ファイルを取得できます　これはブラウザを使い Google Play で目的のアプリを表示させたアドレス欄にも表示されているんでその辺を参考にして grep で絞り込むといいでしょう
そうして出てきた中から /data/app/〜/base.apk を選択してコピーして adb pull /data/app/〜/base.apk として実行すると PC 側に base.apk として持ってこれます

この apk ファイルはそのまま Android 機にインストールすることができます　インストールする場合は目的の Android 機に繋ぎ替えた後に adb install base.apk とすれば ok です


モノは試しに Fire HD 10 タブレット (10インチHDディスプレイ) 32GB - Alexa搭載 にインストールしてみました　もともと Amazon apps 版の フェアリードール が入ってたんだけど…それとは別にインストールすることができました
Amazon Fire には Google Play が入ってないんだけどこの手法を使えばアプリのインストールが可能です…が多くの場合ハードやセキュリティの制約などで入れられないことが多いです　まぁどうしてもの非常時に入ったらイイナ！って感じで覚えておくといいかもです（汗

　　：

アプリのバックアップの別の手法として adb backup アプリID ってのもあるようですね　ただこれは機種ごとのセキュリティ設定が強く影響するのか…同じアプリでも G 社の Android だとうまくいくけど S 社のそれだとうまくいかないなんてことがあるようです
まぁもしうまくバックアップすることができたとして…出来上がった *.ab ファイルを展開するツールが存在するっぽい？
android-backup-extractor ってものらしく abe.jar ってのがそれらしいです　Java 環境が必要で java -jar abe.jar unpack 解凍元.ab 解凍先.tar で展開できるようです

　　：

Android 機のスクリーンショットを PC で撮ってそのファイルを PC に保存するなんてこともできるようです


例えば adb exec-out screencap -p > ss$(date +%Y%m%d%H%M%S).png なんてすると実行した日時を付加した ss が PNG で PC に直接保存できます　スマホの「電源 + 音量ダウン」のボタン同時押しがそれなりに使いにくいんで…微妙なタイミングを要するスクリーンショットを撮りたい時などに重宝すると思います

　　：

Android 機の画面を PC 上で表示させられる scrcpy ってのがあるらしいです　これは sudo apt install scrcpy で入れることができるようだけど…


我が家の環境ではエラーが出て動きませんでした


それじゃ別の手法で！ってことで snap 版の scrcpy を sudo snap install scrcpy で入れてみました　ちなみに apt で入れる scrcpy の方が PATH の優先順位が高いんで /snap/bin/scrcpy って感じのフルパス指定で起動してみます


snap 版の scrcpy だとうまく動きました！　思ってたより動きもスムーズでいい感じです！(>_<)ｗ
そんな snap 版の scrcpy を毎回毎回フルパス指定で起動するのも面倒だな…って事なんで snap の別名設定を使ってみることにします


設定は sudo snap alias 元のコマンド名 新しいコマンド名 でできるようなんで sudo snap alias scrcpy Scrcpy って感じで頭文字を大文字にしてみました　エイリアスを確認する際には snap aliases とするようです

　　：

同様に Android 機の音声を PC 上で再生させられる sndcpy ってのがあるらしいです　これは rom1v / sndcpy の Get the app から sndcpy-v1.1.zip (※20220321現在) を落としてきて展開して…その中の sndcpy (シェルスクリプト) を実行すればいいようです


先ほどの Scrcpy と sndcpy を同時に使ってみた例　音声は 0.5 秒くらい(？)遅れてきてるみたいですね　あーあと sndcpy を使用する場合には PC に vlc (メディアプレイヤ) を入れておく必要があるようです
スマホとかの小さい画面とショボいスピーカーの音声を PC 側に出すと見やすくて音もよくてとてもゴキゲンです！　追加投資は USB ケーブルだけ！って手軽さがいいですね！

　　：

そんな USB ケーブルで PC と Android 機を繋ぎっぱなしってのもなんか邪魔くさいんで…その辺をネットワーク (Wi-Fi等) でどうにかする手法があるようです　※使用するにあたり…最初の設定段階では USB ケーブルで繋いでおく必要があります


まず adb tcpip 5555 で listen するポートを 5555 に設定します　ポート番号は 5555～5585 の範囲で奇数番号のポートが使用できるらしい？
次に adb connect 192.16x.x.x32 で Android 機の IP アドレスを指定して接続します　Android 機の IP アドレスは「設定」→「ネットワークとインターネット」→「Wi-Fi」→「接続済みのAP」→「詳細設定」等で確認できます　※使用機種によりメニュー構成が若干違います

connected to 192.16x.x.x32:5555 などと表示され接続したら…この時点で USB ケーブルを抜いても ok です
あとは adb shell なりの adb コマンドをネットワーク経由で使用できます

　　：

さらに最近では最初からネットワークで全てが完了する「ワイヤレス デバッグ」も使用できるようになりつつあります　※ Android OS 11 以降で adb も新しいものが必要になります


sudo apt install adb で入れたものは Ver. 1.0.39 で…これは古いので使えません　じゃぁどうしよう？ってことで…それじゃ Android Studio を入れてみましょう


Android Studio のダウンロードページ のダウンロードボタンを押下して…お決まりの了解したぜ！チェックした後にダウンロードします　ダウンロードしたファイルを解凍して android-studio/bin/studio.sh を実行するとインストールが開始します　本気で使う気がないのなら…まぁこの辺は適当でいいと思います（汗


標準的なインストールを行うと ~/Android/Sdk/platform-tools/ の中に adb が用意されるのでこれを使ってみます　Ver. 1.0.41 でした


お次は Android OS 11 以降の設定を行います　「設定」→「システム」→「開発者向けオプション」→「ワイヤレス デバッグ」をオンにして…その項目をタップする


タップしたらワイヤレス デバッグの設定に入れるので…「ペア設定コードによるデバイスのペア設定」をタップする


すると必要な情報が表示されるので…これをもとに adb で接続設定していきます　なお古い adb と混同するをアレなんで ~/Android/Sdk/platform-tools/adb って感じのフルパスでコマンドを起動しています


先ほど表示されてた IP アドレスとポート番号で ~/Android/Sdk/platform-tools/adb pair 192.16x.x.x31:43015 って感じで実行します　するとペアリング・コードを聞かれるのでそれを入力します　※ここでは 226441 でした　これでペアリング設定は完了です


お次は実際に接続します　これは ~/Android/Sdk/platform-tools/adb connect 192.16x.x.x31:40643 って感じで実行します　先ほどのペアリング設定のポート番号とは別のポート番号になるので注意してください


成功すればこれでワイヤレス接続が完了しています　後は ~/Android/Sdk/platform-tools/adb shell するなり色々をネットワーク経由で行えます　少々手順が多くて面倒かなーって思いつつ…まぁ慣れてしまえば USB ケーブルを接続するより楽ちんかなーってイメージです
ただし先述の scrcpy や sndcpy は(20220321現在)対応していない感じでした　この辺が早く対応してくれればなーって思います

※ 追記 ※
テストした環境の PATH 設定の都合で Ver. 1.0.39 の adb が参照されていたので…その辺をどうにかしたら sndcpy は動きました　Android Studio で入れた Ver. 1.0.41 を優先的に使えるよう PATH を以下のように設定しました
export PATH="/home/$USER/Android/Sdk/platform-tools:$PATH"　※ 標準的(？)な Android Studio のインストールを行った場合
一時的な設定ならコマンドラインで上記のように実行するもよし…再起動後とかも永続的に使いたいのであれば ~/.profile を編集して…最終行辺りに上記のパス設定を追加しておくといいでしょう

ちなみに scrcpy は apt 版(Ver. 1.12.1)と snap 版(Ver. 1.23)のどちらもワイヤレス環境では動作しませんでした(-_-；)

　　：

そんなこんなな adb の使い方いろいろでした　他にも音量の操作やら特定のイベントシグナルの送信などなどアプリ開発のデバッグに有用な機能が用意されているのですが…まぁ末端ユーザでは概ね必要のない機能なのでその辺はもっとプロの方が発する情報をご参照くださいってことで #Android #Ubuntu #コマンドヘルプ