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 はブラウザでは一切動きません。

find

読み取りのみ

ディレクトリツリーを歩いて一致したものを印字します。大きなファイル、空のフォルダ、残骸を探すのに使います。

コマンド: adb shell find
コマンド: ファイルとストレージ
リスク: 読み取りのみ

構文

find <path> [-type f|d] [-size +<N><suffix>] [-empty] [-maxdepth <n>] [-iname <pattern>] [-printf <format> | -exec stat -c <format> {} +]

フラグと引数

トークン	意味
-type f \| d	通常ファイル、またはディレクトリ。
-size +<N><suffix>	N 単位より大きいもの。接尾辞は必ず書いてください（`c` バイト、`k` KiB、`m` MiB、`g` GiB）。数値だけだと 512 バイトブロックの意味になり、新しいビルドではもっと悪いことになります。
-empty	中身が何もないディレクトリ、または空のファイル。
-maxdepth <n>	どこまで降りるか。
-iname <pattern>	大文字小文字を無視する名前の一致。パターンは引用して、端末のシェルが手を出さないようにします。
-printf <format>Android 11 以降	一致ごとに選んだフィールドを印字します：`%s` バイト単位のサイズ、`%p` パス、`%T@` 更新時刻。
-name <pattern>	`-iname` の大文字小文字を区別する版。最近のビルドの共有ストレージは名前を大文字小文字を区別せずに比較するので、デスクトップよりも 2 つが一致することが多く、だからこそ `-name` は持ち込むべきでない癖です。
-print0	一致を改行ではなく NUL バイトで区切ります。共有ストレージではこれは細かすぎる話ではありません。ファイル名は規格上、改行を含み得て、改行区切りの一覧はそういうファイル 1 つを、存在しない 2 つのパスに変えてしまいます。
-exec <cmd> {} +	1 行に収まるだけの一致をまとめて 1 つのコマンドに渡します。`+` の形なら走査全体がプロセス数個で済み、`;` の形は一致ごとに 1 つ起こすので、ケーブル越しには目に見えて遅く、競合するには十分な粗さです。

使用例

```
find /sdcard -type f -size +100M
```
共有ストレージ内の 100 MiB 超のファイルすべて。
```
find /sdcard -type d -empty
```
空のディレクトリ。アンインストールされたアプリが残していった残骸です。

find /sdcard/Download -maxdepth 1 -type f -iname '*.apk'

ダウンロードして忘れたインストーラ。

```
find /sdcard -type f -size +100M -print0
```
同じ探索を NUL 区切りで。改行を抱えたファイル名が、どこにも行き着かない 2 つのパスに割られなくなります。
```
find /sdcard -type f -size +100M 2>&1
```
一致と拒否を 1 本の stream に。空の答えを信じてよい唯一の形です。

出力の読み方

既定では一致したパスを 1 行ずつ。同じパスでサイズも得るには、Android 11 以降なら `-printf`、どこでも使えるのは `-exec stat -c … {} +` です。ファイルごとに `stat` を別途走らせるのは、ケーブル越しでは遅く、しかも競合します。

出力フィールド

フィールド	意味
<path>	一致 1 つにつき 1 行。
%s	バイト単位のファイルサイズ。
%p	パス。
%T@	更新時刻。秒のあとは小数ではなく「ナノ秒の数」なので、`…0.5` は 5 ナノ秒です。
find: bad arg '-printf'	Android 10 以前です。`-exec stat` にフォールバックしてください。
find: '<path>': Permission denied	飛ばされたディレクトリで、標準エラーに告げられます。シングルクォートで囲まれていて、一致したパスが囲まれることは決してありません。

必要な権限

権限は要りませんが、権限そのものより効く注意点が 1 つあります。`find` は降りていくディレクトリを 1 つずつ開かなければならず、shell の手が届く範囲は `adbd` が権限を落とす前に与える補助グループの一覧（`sdcard_r`、`sdcard_rw`、`ext_data_rw`、`ext_obb_rw`）そのものです。だから共有ストレージは歩けて `/data/data` は歩けません。罠は拒否そのものではなく、拒否の行き先です。開けなかったディレクトリは「標準エラー」に告げられ、一致は標準出力に届き続けるので、`find /sdcard … 2>/dev/null` は部分的な走査を完全なものに読める何かへ変えてしまいます。エラーの行が 1 つもなくて 100 MiB 超が見つからなかったという主張と、40 件の拒否を捨てながら見つからなかったという主張はまるで別物で、それを区別するのは 2 本目の stream だけです。両方の stream を残すか、意図して混ぜるかしてください。次に何を消すかを決める答えを出すコマンドで、エラーを捨てるのはやめましょう。ここには書き込みがありません。`find` はパスを印字するだけで、その後の破壊的な一歩は、あなたが目で読める別の `rm` です。Android Storage Analyzer はその分離の上に建っています。問いごとに `find` を 1 回、サイズは同じ走査で集めて `stat` をやり直さず、削除の一覧は画面で誰も展開していないワイルドカードではなく実際に返ってきたものから組み立てます。

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

メッセージ	意味
find: bad arg '-printf'	Android 10 以前です。そのビルドの `find` には `-printf` が存在せず、苦情は 1 つもパスを印字する前に届くので、結果はサイズの列が欠けているのではなく空になります。`-exec stat -c … {} +` の形に落としてください。この一族が対象とするどのリリースでも同じ 3 つのフィールドが得られます。
find: '/sdcard/Android/data/com.example': Permission denied	ディレクトリ 1 つが開けませんでした。残りの走査には影響せず、印字は続きます。パスはシングルクォートで囲まれていて、それが一致と見分ける頼れる手段です。一致したパスは常に裸で印字されるからです。stream を混ぜているなら、その引用符だけが目印になります。
find: bad -type 'x'	`-type` は 1 文字だけを取ります（通常ファイルは `f`、ディレクトリは `d`）。それ以外は、どこも歩く前にコマンドを止めます。何も検索されていないので、ここでの空の結果は「問いが一度も発されなかった」という意味です。
find: '-size' needs 1 arg	値を必要とする述語が値なしで書かれました。たいていは周りのシェルが何かを展開する途中で値を飲み込んだせいです。引数を引用してください。`-type` と同じく構文の段階で起きるので、ディレクトリは 1 つも開かれていません。
find: big not [+-]N	数値を取る述語に渡された値が、任意の符号を伴う数値になっていません。`-size` は `+100M`、`-100M`、あるいは裸の数値を求めていて、引用して返される語はあなたのシェルが実際に渡したものです。閾値のあるべき場所に、ファイル名に一致した glob が立ってしまう経路がこれです。

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

Android の `find` は GNU ではなく toybox で、`-size` の挙動が違います。単位の掛け算は引数が数字で終わるときだけ適用されます。接尾辞を明示すればバイトと直接比較され、単位への切り上げもありません。
素の `-size +100` は事故の待ち合わせです。Android 10 から 14 では 100 × 512 バイトを意味し、より新しい上流のコードでは内部の単位が負になるため `+N` が端末上の全ファイルに一致します。
`m` は 100 万ではなく 1024 の 2 乗です。1000 のべき乗に切り替わるのは末尾に `d` を付けたときだけです。
`-type f` は明示してください。`-size` が通常ファイルを含意するのは、この一族が対象とするどの出荷済み Android よりも新しい変更です。
拒否は標準エラーに、一致は標準出力に出るので、標準エラーを黙らせることは「そこを見る権利がなかった」を「そこには何もない」に書き換えることになります。このページで最も高くつく間違いです。走査の次の一歩は、たいていその結果から選ぶ削除だからです。
`-printf` は Android 11 の toybox で入り、`android14-release` と `android15-release` のソースにもあります。Android 10 以前は `find: bad arg '-printf'` と答えて何一つ印字しないので、古い端末での空の走査は、エラーの stream がそうでないと言うまで失敗したコマンドとして扱ってください。

これには UI があります

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

Android Storage Analyzer を開く

コマンド	何をするか
du	ディレクトリツリーが占めているディスク容量を報告します。
df	マウントされているファイルシステムごとの空きと使用量を報告します。
rm	端末上のファイル、またはディレクトリツリーを削除します。
dumpsys diskstats	パーティションごとの空き容量、ディスク書き込み遅延の実測、そしてキャッシュされたアプリ別の使用量内訳。