ブロードキャスト intent を送ります。SystemUI の demo mode などプラットフォームのレシーバをシェルから動かす方法です。
am broadcast -a <action> [-e <key> <value>] […]| トークン | 意味 |
|---|---|
| -a <action> | ブロードキャストの action。 |
| -e <key> <value> | 文字列の extra を 1 つ。繰り返せます。 |
settings put global sysui_demo_allowed 1まずゲートを開けます。この設定が off の間、SystemUI は demo のブロードキャストを全部無視します。買ったばかりの端末では off です。
am broadcast -a com.android.systemui.demo -e command enterdemo mode に入ります。他の demo コマンドより先に実行する必要があります。
am broadcast -a com.android.systemui.demo -e command notifications -e visible false自分の通知アイコンを隠します。スクリーンショットで実際に効くのはここです。
am broadcast -a com.android.systemui.demo -e command exitステータスバーを現実に返します。
出力例
Broadcasting: Intent { act=com.android.systemui.demo (has extras) }
Broadcast completed: result=0`Broadcast completed: result=0` は intent が配送されたという意味です。誰かがそれに反応したという意味では **ありません**。レシーバは無視して構わないし、demo mode のゲートが閉じているとき、あるいはメーカーがレシーバを削除しているときの SystemUI はまさにそうします。確かめるのはこの行ではなく端末の画面です。
| フィールド | 意味 |
|---|---|
| Broadcasting: Intent { … } | プラットフォームが解釈した intent。 |
| Broadcast completed: result=0 | 配送されました。何かが応答した証拠ではありません。 |
| Permission Denial | このビルドでは shell ユーザーがそのブロードキャストを送れません。 |
ブロードキャスト自体は何も永続的に変えませんが、受け取った側は変えられます。名前を挙げるべき例が SystemUI の demo mode です。ステータスバーを偽の時刻と偽のバッテリーで固定し、`exit` コマンドを誰かが送るまで端末はその状態のままなので、使う人は「端末が壊れた」と思い込みます。exit コマンドは常に手元に置いてください。
Android ADB Toolbox はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。
am broadcast と同じ作業で出てくるコマンド。
| コマンド | 何をするか |
|---|---|
| am start | コンポーネント指定または intent 指定でアクティビティを起動します。ディープリンクの解決を確かめる最短経路です。 |
| settings put | 設定プロバイダに値を書きます。開発者向けオプションのほとんどの裏にある仕組みです。 |
| screencap | スクリーンショットを撮ります。端末上のファイルに書くか、PNG として標準出力に流します。 |
| コマンド | 何をするか |
|---|---|
| am force-stop | あるアプリのプロセスとサービスをすべて終了させます。 |
Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。
端末で開発者向けオプションと USB デバッグを有効にし、ケーブルを繋いだうえで、platform-tools を入れた機械から `adb shell <コマンド>` を実行します。`adb shell` だけを実行すれば対話プロンプトが出て、接頭辞なしで打てます。スクリーンショットのようにバイナリを出力するコマンドでは `adb shell` ではなく `adb exec-out` を使ってください。素のシェルサービスは端末を割り当て、それが改行のバイトを書き換えてデータを壊します。
このリファレンスにあるものには不要です。すべて `shell` ユーザーとして動き、自分の Android ユーザー向けのパッケージ管理、ほとんどの `dumpsys` サービスの読み取り、設定プロバイダへの書き込み、入力の注入、共有ストレージの読み取りができます。root が必要なのはこのリファレンスがあえて避けていること、つまり他のアプリのプライベートデータの読み取り（debuggable なビルドに対する `run-as` を除く）、システムパーティションへの書き込み、`/data/anr` の直接読み取りです。
Android のバージョンか、メーカーのどちらかです。一部のフラグやフィールドは特定のリリースから入ったもので、それはコマンドごとに注記しています。残りはメーカーによる改変で、いちばん影響が大きいのは `dumpsys` です。ダンプはデバッグ出力で、そのテキストはサービスの作者が最後に印字した内容そのもの、しかもメーカーはそれを変えて自分の変更をバックポートします。フィールドは位置ではなく名前で読み、見慣れない形は失敗ではなく差分として扱ってください。
多くのコマンドは可能です。このサイトの Web ADB ツール群は、Chromium 系のデスクトップブラウザから WebUSB で端末と話し、SDK のインストールも不要、どこにもアップロードしません。各ページは、該当するツールがあればそこへリンクしています。知っておく価値のある制限が 2 つあります。ADB インターフェイスを保持できるプログラムは同時に 1 つだけなので、デスクトップの `adb server` は先に止める必要があります。そして `adb forward` と `adb reverse` はブラウザでは一切動きません。
打つより押したい場合は、Web ADB Toolkit がこの種のコマンドをブラウザから USB 経由で実行します。あるいは全コマンドを見る。