インストール済みパッケージを一覧表示します。APK パス、uid、バージョンコード、インストーラも同時に取得できます。
pm list packages [-f] [-U] [--show-versioncode] [-i] [-s | -3 | -e | -d | -u] [--user <id>] [<name filter>]| トークン | 意味 |
|---|---|
| -f | インストール元の APK パスも表示します。 |
| -UAndroid 8.0 以降 | uid も表示します。 |
| --show-versioncodeAndroid 8.0 以降 | バージョンコードも表示します。 |
| -i | インストーラのパッケージも表示します。パッケージごとに binder 呼び出しが 1 回増えます。 |
| -s | システムパッケージのみ。 |
| -3 | サードパーティのパッケージのみ。 |
| -e | 対象ユーザーで現在有効なパッケージ。 |
| -d | 対象ユーザーで現在無効なパッケージ。 |
| -u | データを残して削除したパッケージも含みます。既定の一覧の上位集合になります。 |
| --user <id> | Android ユーザーを 1 人に限定します。指定しないと全ユーザーを対象にするため、user 0 で無効・仕事用プロファイルで有効なパッケージが -e と -d の両方に現れます。 |
pm list packages -3自分で入れたアプリだけ。
pm list packages -f -U --show-versioncodeパス・uid・バージョンコードを 1 回で取得する完全な棚卸し。
pm list packages -d --user 0プライマリユーザーで現在無効になっているもの。
pm list packages -u`pm uninstall -k` で消したパッケージも含むので、復元できるものを探すのに使います。
出力例
package:/data/app/~~kO7bJ9w==/com.example-Ay8s2Q==/base.apk=com.example versionCode:4711 installer=com.android.vending uid:102341 行 1 パッケージ。プラットフォームが左から順に組み立てるので、読むときは右から剥がすのが正解です。`uid:`、`installer=`、`stopped=`、`versionCode:` を順に外し、残ったものがパッケージ名です。最近の APK パスには `=` が複数含まれるため、単純な分割では名前を取り違えます。
| フィールド | 意味 |
|---|---|
| package: | すべての行に付く固定の接頭辞。 |
| <path>= | APK パス。-f を付けたときだけ現れ、最後の `=` で終わります。 |
| versionCode:<n> | long 型のバージョンコード。--show-versioncode 指定時。 |
| stopped=<bool> | パッケージが stopped 状態かどうか。 |
| installer=<pkg> | -i 指定時のインストーラ。前に空白が 2 つ入り、プリインストールアプリでは `null` という 4 文字が出ます。 |
| uid:<n>[,<n>] | -U 指定時の uid。複数の Android ユーザーに存在する場合はカンマ区切りになります。 |
Android Debloat Tool はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。
pm list packages と同じ作業で出てくるコマンド。
| コマンド | 何をするか |
|---|---|
| pm path | インストール済みパッケージを構成する APK ファイルの絶対パスを表示します。 |
| pm uninstall | パッケージを削除します。ユーザー単位の削除なら、root なしでプリインストールアプリを片付けられます。 |
| pm disable-user | パッケージを削除せずに、指定した Android ユーザーで無効にします。アンインストールより安全で、確実に戻せます。 |
| dumpsys package | パッケージマネージャが知っているすべて:バージョン、パス、flags、インストール元、ユーザーごとの状態。 |
| コマンド | 何をするか |
|---|---|
| pm clear | アプリのデータを消去します。Android 13 以降ならキャッシュだけを消すこともできます。 |
| pm trim-caches | 指定した空き容量に達するまで、システムにキャッシュファイルを捨てさせます。 |
| pm install | すでに端末上にある APK を 1 つインストールします。`adb install` が内部でやっていることです。 |
| pm install-create | インストールセッションを開き、base とその split をまとめて 1 つの操作としてインストールします。 |
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 経由で実行します。あるいは全コマンドを見る。