pm trim-caches
端末を変える指定した空き容量に達するまで、システムにキャッシュファイルを捨てさせます。
- コマンド
- adb shell pm trim-caches
- コマンド
- パッケージ（pm）
- リスク
- 端末を変える
構文
pm trim-caches <free space target>[K|M|G]フラグと引数
| トークン | 意味 |
|---|---|
| <target> | 目標とする空き容量。サフィックスは 1024 のべき乗なので `512G` は 512 GiB、つまりどの端末にもあり得ない量です。「捨てられるものは全部捨てろ」という書き方です。 |
使用例
pm trim-caches 512Gシステムが捨てて良いと判断するキャッシュを全部解放します。
pm trim-caches 2G空きが 2 GiB になったら止めます。
出力の読み方
何も出ません。成功は無言です。プラットフォームの処理を待って、何も表示せずに返ります。しかも「どれだけ解放したか」も、そもそも「解放したかどうか」さえ報告しません。正直な「N MB 空きました」を出す唯一の方法は、`df` か `dumpsys diskstats` で前後の空き容量を測ることです。何かが表示されたらそれは拒否で、サフィックス不正、数値がない、あるいはこの操作に必要な権限がビルドで shell に付与されていない場合の例外です。
出力フィールド
| フィールド | 意味 |
|---|---|
| (no output) | trim が実行されました。解放量は報告されません。 |
| Invalid suffix: … | サイズ引数が理解されませんでした。 |
| Error: expected number at: … | サイズ引数が数値ではありませんでした。 |
必要な権限
認可済みの `adb` 接続だけで、それ以外は何も要りません。`android16-release` ブランチの `packages/Shell/AndroidManifest.xml` は `CLEAR_APP_CACHE` を宣言していて、これは `freeStorageAndNotify` が要求する権限です。root も `adb root` も、開発者向けオプションのスイッチも、アプリごとの付与も不要です。面白いのは、その権限で買えないもののほうです。`runTrimCaches` は `StorageManager.FLAG_ALLOCATE_DEFY_ALL_RESERVED` を付けて `freeStorageAndNotify` を呼び、オブザーバの完了を待ってから、`obs.result` を一度も見ずに 0 を返します。shell ユーザーは頼むことは許されていて、結果は決して教えてもらえないのです。呼び出しそのものを拒否したビルドなら分かります。ラッパーが出す例外が、成功を意味するはずの無言を破るからです。しかし、権限を持っていて何も解放しなかったビルドと、1 GB 解放したビルドは見分けがつきません。Android Storage Analyzer がやっているように前後の空き容量を測るのが、正直な数字にたどり着く唯一の道です。
エラーメッセージの読み解き
| メッセージ | 意味 |
|---|---|
| Invalid suffix: | `runTrimCaches` はサイズ引数を自前で解析していて、知らないサフィックスが来るとこの行と入力した文字列を出します。何も trim されていません。掛け算をしているのも同じ解析器で、単位は 1024 のべき乗です。受け付けてもらえたサフィックスでも、ディスクメーカーが言うところの意味とは限りません。 |
| Error: expected number at: | 引数がそもそも数値ではありませんでした。多いのは引数の順序の取り違えと、`pm clear` の癖でコマンドの後にパッケージ名を書いてしまう場合です。何も実行されていません。ここでの拒否はどれも同じで、見分けの手がかりは「何かが表示された」という事実そのものです。 |
| Exception occurred while executing 'trim-caches': | ラッパーが `freeStorageAndNotify` から飛んできた `Throwable` を捕まえ、スタックトレースを吐きました。shell ユーザーに `CLEAR_APP_CACHE` を与えていないビルドがこれに当たります。`classifyTrimCaches` は空でない出力をすべて拒否として扱います。成功が肯定的な合図をまったく持たない以上、それが唯一安全な読み方だからです。 |
何が変わるか、そして戻る道
消えるのはキャッシュファイルだけで、ユーザーのデータには触れません。アカウント、セーブデータ、ダウンロードはそのままで、各アプリは次に起動したときに必要なものを自分で作り直します。元に戻す必要のあるものはなく、戻すコマンドもありません。アプリをまた使えばキャッシュは自然に貯まります。代わりに、キャッシュが貯まり直すまではアプリの起動や再読み込みが少し遅くなります。また、このコマンドはどれだけ空いたかを報告しないので、実際の量は前後で `df` か `dumpsys diskstats` を使って空き容量を測ってください。
バージョンとメーカーに関する注意
- 何を捨てて良いかを決めるのはあなたではなくシステムです。どのアプリのキャッシュがどの順で落ちるかは、このコマンドから制御できないプラットフォームの方針です。
- サフィックスは 1024 のべき乗として解釈されるので、`1G` は 1 GiB であって 1 000 000 000 バイトではありません。
これには UI があります
Android Storage Analyzer はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。
関連コマンド
pm trim-caches と同じ作業で出てくるコマンド。
| コマンド | 何をするか |
|---|---|
| pm clear | アプリのデータを消去します。Android 13 以降ならキャッシュだけを消すこともできます。 |
| dumpsys diskstats | パーティションごとの空き容量、ディスク書き込み遅延の実測、そしてキャッシュされたアプリ別の使用量内訳。 |
| df | マウントされているファイルシステムごとの空きと使用量を報告します。 |
| du | ディレクトリツリーが占めているディスク容量を報告します。 |
他のパッケージ（pm）コマンド
| コマンド | 何をするか |
|---|---|
| pm list packages | インストール済みパッケージを一覧表示します。APK パス、uid、バージョンコード、インストーラも同時に取得できます。 |
| pm path | インストール済みパッケージを構成する APK ファイルの絶対パスを表示します。 |
| pm uninstall | パッケージを削除します。ユーザー単位の削除なら、root なしでプリインストールアプリを片付けられます。 |
| pm disable-user | パッケージを削除せずに、指定した Android ユーザーで無効にします。アンインストールより安全で、確実に戻せます。 |
| pm install | すでに端末上にある APK を 1 つインストールします。`adb install` が内部でやっていることです。 |
| pm install-create | インストールセッションを開き、base とその split をまとめて 1 つの操作としてインストールします。 |
Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。