adb shell のコマンドはどう実行しますか？

端末で開発者向けオプションと USB デバッグを有効にし、ケーブルを繋いだうえで、platform-tools を入れた機械から adb shell を実行します。adb shell だけを実行すれば対話プロンプトが出て、接頭辞なしで打てます。スクリーンショットのようにバイナリを出力するコマンドでは adb shell ではなく adb exec-out を使ってください。素のシェルサービスは端末を割り当て、それが改行のバイトを書き換えてデータを壊します。

adb shell のコマンドに root は必要ですか？

このリファレンスにあるものには不要です。すべて 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 はブラウザでは一切動きません。

settings get

読み取りのみ

端末の設定プロバイダから値を 1 つ読みます。

コマンド: adb shell settings get
コマンド: 設定プロバイダ
リスク: 読み取りのみ

構文

settings get <system|secure|global> <key>

フラグと引数

トークン	意味
system \| secure \| global	key がどの名前空間にあるか。3 つあって別の表なので、間違えるとエラーではなく「何もない」が返ります。

使用例

```
settings get global http_proxy
```
端末が検証用のプロキシに向いていないかを確認します。
```
settings get global window_animation_scale
```
変える前に読んでおき、戻せる値を手元に持ちます。
```
settings get system show_touches
```
名前空間が常に `global` ではないことを示す `system` の key。

出力の読み方

出力例

null

1 行だけ。値か、`null` という 4 文字です。`null` は失敗ではなく本当の答えです。開発者向けスイッチの多くは買ったばかりの端末では未設定で、その実効値は保存された何かではなくプラットフォームの既定値です。1 行を超えるものは値ではなく、シェルが出力に混ぜたエラーです。

出力フィールド

フィールド	意味
<value>	保存されている値、テキストとして。
null	key が未設定です。プラットフォームの既定値が効きます。
(a stack trace)	読み取りが拒否されました。値ではありません。

必要な権限

root も `adb root` も不要です。`settings` は `cmd settings "$@"` を実行するだけの 1 行のシェルスクリプト（AOSP の `cmds/settings/settings.sh`）なので、読み取りは認可済み `adb` 接続の向こう側にいる `shell` ユーザーの身元で答えられます。そして読み取りは、この一族の権限の話のうち圧倒的に安いほうの半分です。書き込み側は `android.permission.WRITE_SECURE_SETTINGS` に寄りかかりますが、`system` / `secure` / `global` の key をただ読むだけなら、shell に足りないものは何もありません。USB デバッグ自体を除けば、開発者向けオプションのトグルに隠れているものもありません。短い答えを信用してよいかを決めるのは 2 点です。値は out stream に `pout.println(...)` で印字される一方、引数パーサの苦情（名前空間の打ち間違い、余計な 1 語）はすべて err stream に印字され、コマンドは何も読まずに -1 を返します。標準エラーを捨てると、拒否されたコマンドが未設定の key と見分けのつかない空行になります。もう 1 点はユーザーで、これは読み取りの前に解決されます。`--user` を付けなければ activity manager に現在のユーザーを尋ねてそのユーザーの表を読むので、仕事用プロファイルのある端末では、前面にいるのが誰かによって同じ `secure` の key が 2 通りに答えられます。

エラーメッセージの読み解き

メッセージ	意味
Invalid namespace 'globl'	最初の位置引数が `system` / `secure` / `global` のどれでもありませんでした。比較は大文字小文字を区別しないので `Global` は通り、ここに来るのは本物の打ち間違いだけです。解析はそこで止まりコマンドは -1 を返すので、何も読まれていません。値が手に入らない点は同じでも、key が存在しない場合とは別物です。行は標準エラーに出ます。
Invalid command: gett	動詞が `get` / `put` / `delete` / `list` / `reset` のどれでもありませんでした。オプションを置く場所を間違えたときもここに来ます。パーサは `--user` を除いて動詞が先に来ることを期待するからです。何も読まれていません。
Bad arguments	パーサが完全な要求を組み立てないままコマンドラインの終わりに達しました。日常的な原因は key のない `settings get global` です。何も名指ししない受け皿なので、最後の 1 語ではなく行全体を読み直してください。
Too many arguments	`get` では key が最後に受け付けられるもので、その後ろにあるものは問答無用で拒否されます。引用していない、空白入りの key がこれを出します。そしてこれは親切です。代わりの挙動は、最初の 1 語だけを読んで答えだと言い張ることでした。
cmd: Can't find service: settings	`settings.sh` は `cmd settings` の薄い包みでしかないので、`cmd` がサブコマンドを渡す先の `settings` サービスを見つけられませんでした。起動途中、`system_server` がそれを公開する前なら想定内です。key がないと解釈せず、起動が終わるのを待ってください。

バージョンとメーカーに関する注意

名前空間を間違えても無言です。尋ねた表にその key がないだけで、気づけるエラーは出ません。
書く前に読んでください。プラットフォームは前の値を覚えてくれないので、何に戻すかを知る手段はこのコマンドだけです。

これには UI があります

Android ADB Toolbox はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。

Android ADB Toolbox を開く

コマンド	何をするか
settings put	設定プロバイダに値を書きます。開発者向けオプションのほとんどの裏にある仕組みです。
getprop	システムプロパティを表示します。端末自身が語る「これは何か」です。
am broadcast	ブロードキャスト intent を送ります。SystemUI の demo mode などプラットフォームのレシーバをシェルから動かす方法です。