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

pm clear

破壊的

アプリのデータを消去します。Android 13 以降ならキャッシュだけを消すこともできます。

コマンド: adb shell pm clear
コマンド: パッケージ（pm）
リスク: 破壊的

構文

pm clear [--user <id>] [--cache-only] <package>

フラグと引数

トークン	意味
--cache-onlyAndroid 13 以降	キャッシュディレクトリだけを削除し、アカウントとデータには触りません。
--user <id>	どの Android ユーザーがデータを失うか。実行したコマンドが「何を消したか」の全てになるよう、明示しておく価値があります。

使用例

```
pm clear --user 0 --cache-only com.example
```
Android 13 以降でアプリ 1 つのキャッシュを落とします。引数の順序に意味があります（注意を参照）。
```
pm clear --user 0 com.example
```
アプリを工場出荷状態に戻します。中身は全部消えます。
```
pm help
```
Android のバージョンから推測するのではなく、端末自身に `--cache-only` があるかを尋ねます。

出力の読み方

出力例

Success

標準出力に `Success`、標準エラーに `Failed`、オプション解析が拒否したときは `Error: Unknown option: …` です。`pm clear` は必ず何か言うので、無言はコマンドが実行されなかったという意味になります。

出力フィールド

フィールド	意味
Success	データ（またはキャッシュ）が削除されました。
Failed	何も削除されていません。パッケージを解決できなかったか、呼び出しが拒否されました。
Error: Unknown option:	このビルドはそのフラグを知りません。ここで未知のオプションを拒否するのは Android 13 以降だけです。

必要な権限

認可済みの `adb` 接続だけです。root も `su` も不要で、開発者向けオプションで有効にするものもありません。`android16-release` ブランチの `packages/Shell/AndroidManifest.xml` は `CLEAR_APP_USER_DATA` と `DELETE_CACHE_FILES` を宣言していて、これは `clearApplicationUserData` と `deleteApplicationCacheFilesAsUser` が要求する権限そのものです。つまり標準的なビルドなら、shell ユーザーはこのコマンドの両側を何の儀式もなく実行できます。だからこそ、肩をすくめて済ませるのではなく確認ダイアログに値します。アプリのアカウントと消滅のあいだに立っているのは権限チェックではなく、あなたのタイプする指だからです。どちらかの宣言を外したメーカーのビルドでは、コマンドは静かにではなく大きな音で失敗します。それは良い失敗の仕方で、Android Storage Analyzer はその行をそのまま素通しします。どんな権限でも守れないのは Android 13 より前の解析器です。そのリリースではアクセスチェックは通り、未知のフラグは捨てられ、頼んでいない消去だけが成功します。

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

メッセージ	意味
Failed	`runClear` は、オブザーバが失敗を報告したときにこの単語だけを標準エラーに書きます。パッケージを解決できなかったか、呼び出しが拒否されたかです。同時にこれは、Android 12 以前で `pm clear --user 0 --cache-only <pkg>` を実行したときの設計どおりの結末でもあります。古い解析器がこのフラグをパッケージ名として受け取り、消す相手が見つからないからです。その正確なコマンドラインを古い端末で打った場合、この単語は防御が効いたという意味になります。
Error: Unknown option: --cache-only	Android 13 の `runClear` はオプションを順に見て、知らないものを拒否します。直感に反しますが、この行はむしろ安心材料です。危険なほど古いビルドはこの行を出しません。黙ってフラグを受け入れて全部消します。この行が出ないことを、フラグ対応の証拠として読んではいけません。読むべきは `pm help` です。
Exception occurred while executing 'clear':	ラッパーが `Throwable` を捕まえ、その下の行が名前を告げます。shell から `CLEAR_APP_USER_DATA` を取り上げたビルドは、ここに `SecurityException` として現れます。`classifyPmClear` は `Success` と並んでいてもこの行があれば実行全体を却下するので、データが残ったままのアプリが「消去済み」としてログに載ることはありません。

何が変わるか、そして戻る道

`pm clear <pkg>` はそのアプリのデータベース、設定、アカウント、ファイルを削除します。Android に取り消しもゴミ箱もありません。アプリは入れ直した直後の状態になり、ログインもやり直しです。`--cache-only` が生き残る側の選択肢ですが、これがあるのは Android 13 以降だけで、古いリリースでは同じフラグが全部を消し得ます（下の注意を必ず読んでください）。

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

Android 12 以前のオプション解析は `--cache-only` を拒否せず「無視」します。つまり `pm clear --cache-only com.example` はそのアプリのデータを全部消して `Success` と表示します。バージョンから推測せず、端末自身の `pm help` にフラグがあるかを確認してください。
`--user 0` を `--cache-only` より前に置くのは整理のためではなく、実際の防御です。古い単一オプション解析は `--user 0` を消費してから `--cache-only` をパッケージ名として扱い、それは解決できないので、アプリを消す代わりに無害に失敗します。
標準的なビルドでは shell ユーザーにこの権限があります。メーカーが権限を外していれば、静かにではなく明確に失敗します。

これには UI があります

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

Android Storage Analyzer を開く

コマンド	何をするか
pm trim-caches	指定した空き容量に達するまで、システムにキャッシュファイルを捨てさせます。
pm uninstall	パッケージを削除します。ユーザー単位の削除なら、root なしでプリインストールアプリを片付けられます。
dumpsys diskstats	パーティションごとの空き容量、ディスク書き込み遅延の実測、そしてキャッシュされたアプリ別の使用量内訳。
du	ディレクトリツリーが占めているディスク容量を報告します。

他のパッケージ（pm）コマンド

コマンド	何をするか
pm list packages	インストール済みパッケージを一覧表示します。APK パス、uid、バージョンコード、インストーラも同時に取得できます。
pm path	インストール済みパッケージを構成する APK ファイルの絶対パスを表示します。
pm disable-user	パッケージを削除せずに、指定した Android ユーザーで無効にします。アンインストールより安全で、確実に戻せます。
pm install	すでに端末上にある APK を 1 つインストールします。`adb install` が内部でやっていることです。
pm install-create	インストールセッションを開き、base とその split をまとめて 1 つの操作としてインストールします。

Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。