パッケージを削除します。ユーザー単位の削除なら、root なしでプリインストールアプリを片付けられます。
pm uninstall [-k] [--user <id>] <package>| トークン | 意味 |
|---|---|
| -k | アプリのデータとキャッシュのディレクトリを残します。削除を取り消せるのはこのおかげです。 |
| --user <id> | 指定した Android ユーザーからだけ取り除きます。プリインストールアプリでは root なしで通る唯一の形です。APK はシステムイメージに残ったまま、そのユーザーにとってだけアプリが存在しなくなります。 |
pm uninstall com.exampleサイドロードしたアプリをデータごと完全に削除。
pm uninstall -k --user 0 com.manufacturer.bloatプリインストールアプリをプライマリユーザーから取り除きます。データを残すので復元できます。
cmd package install-existing --user 0 com.manufacturer.bloat前の行の解毒剤。そのユーザーにアプリを復帰させます。
出力例
Success一言だけです。成功メッセージは `Success` のみ、失敗は `Failure [<理由>]` で、括弧の中身が本題です(`DELETE_FAILED_INTERNAL_ERROR`、そのユーザーに元々なかった場合は `Failure [not installed for 0]`)。この行だけを信じず、後で `pm list packages -u` で状態を読み直してください。
| フィールド | 意味 |
|---|---|
| Success | 指定したユーザーからパッケージが取り除かれました。 |
| Failure [<reason>] | 何も削除されていません。括弧内はプラットフォーム自身のコードです。 |
| Failure [not installed for 0] | そのユーザーには元々存在しませんでした。エラーではなく答えであることが多いです。 |
`pm uninstall --user 0 <pkg>` はそのユーザーからアプリを取り除きます。`-k` を付ければデータが残り、`cmd package install-existing --user 0 <pkg>` で元に戻せます。`-k` なしならデータは消え、APK からの再インストールしか手がありません。システム構成要素を消すと初期設定画面から先に進めなくなり、その場合は工場出荷状態に戻すしかありません。だから一括ではなく 1 つずつ判断してください。
Android Debloat Tool はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。
pm uninstall と同じ作業で出てくるコマンド。
| コマンド | 何をするか |
|---|---|
| pm list packages | インストール済みパッケージを一覧表示します。APK パス、uid、バージョンコード、インストーラも同時に取得できます。 |
| pm disable-user | パッケージを削除せずに、指定した Android ユーザーで無効にします。アンインストールより安全で、確実に戻せます。 |
| pm clear | アプリのデータを消去します。Android 13 以降ならキャッシュだけを消すこともできます。 |
| dumpsys package | パッケージマネージャが知っているすべて:バージョン、パス、flags、インストール元、ユーザーごとの状態。 |
| コマンド | 何をするか |
|---|---|
| pm path | インストール済みパッケージを構成する APK ファイルの絶対パスを表示します。 |
| 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 経由で実行します。あるいは全コマンドを見る。