pm disable-user
端末を変えるパッケージを削除せずに、指定した Android ユーザーで無効にします。アンインストールより安全で、確実に戻せます。
- コマンド
- adb shell pm disable-user
- コマンド
- パッケージ（pm）
- リスク
- 端末を変える
構文
pm disable-user [--user <id>] <package>
pm enable [--user <id>] <package>フラグと引数
| トークン | 意味 |
|---|---|
| --user <id> | どの Android ユーザーを変えるか。状態はユーザーごとで、取り消すコマンドも同じくユーザー単位なので、明示する価値があります。 |
使用例
pm disable-user --user 0 com.manufacturer.bloatプリインストールアプリをプライマリユーザーで無効にします。
pm enable --user 0 com.manufacturer.bloat元に戻します。
pm list packages -d --user 0記憶ではなくプラットフォームに、いま何が無効なのかを確認します。
出力の読み方
出力例
Package com.manufacturer.bloat new state: disabled-userこのコマンドは「読み直した状態」を表示します。それは頼んだ状態とは限りません。ここが、エラーという単語の有無を見るのでは不十分な理由です。プラットフォームが再有効化を拒むパッケージに `pm enable` を投げると `new state: disabled-user` と表示して終了コード 0 で返ります。単語の有無ではなく、状態そのものを目的と比べてください。
出力フィールド
| フィールド | 意味 |
|---|---|
| disabled-user | ユーザー（またはこのコマンド）が無効にしたため off。 |
| disabled | アプリ自身またはフレームワークが無効にしたため off。 |
| disabled-until-used | 必要になるまで off。 |
| enabled | 明示的に on。 |
| default | 上書きなし。マニフェストの宣言どおりで、通常は on です。 |
必要な権限
認可済みの `adb` 接続だけで、root も `su` も要りません。削除できないプリインストールアプリへの定番の答えがこのコマンドなのは、まさにそのためです。有効／無効の状態はユーザーごとの上書きで、shell はそれを書き換えることを許されているので、読み取り専用のシステムパーティションには何も書かれず、事前に解錠しておくものもありません。返事の読み方を左右するアクセスの細部が 2 つあります。まず `--user <id>` は「誰の上書きを変えるか」の指定で、他ユーザーの状態に shell を触らせないビルドは、黙って自分の側を書き換えるのではなく拒否します。そしてプラットフォームには再有効化を断る権利があります。`pm enable` を戻せないパッケージに投げると、状態の行を出して終了コード 0 で返るので、ここでは終了コードは合図になりません。合図になるのは行が名乗る状態のほうです。`parseEnabledStateLine` は、答えのパッケージが問いのパッケージと同じかどうかも確認します。別のものについて答えた端末は、別の問いに答えたということだからです。
エラーメッセージの読み解き
| メッセージ | 意味 |
|---|---|
| Package com.example new state: disabled-user | これは `pm enable` が出す行で、成功行の服を着た拒否です。コマンドは走り、終了コードは 0、そしてアプリは無効のまま残りました。`classifyPmEnabledChange` がエラーという単語を探さずに、返ってきた状態と頼んだ状態を突き合わせるのはこのためです。ここが、本当に効く復元ボタンと、効いたと言い張るだけの復元ボタンの分かれ目になります。 |
| Warning: Unknown option | オプションの解析ループがフラグを認識しませんでした。実際に多いのは、`--user` に対応していない古いビルドです。`isFailureLine` は warning という穏やかな語にもかかわらず、これを失敗として数えます。フラグを理解できなかった実行は、代わりに何をしたにせよ、頼んだことをしていないからです。 |
| Exception occurred while executing 'disable-user': | ラッパーが `Throwable` を捕まえ、続く行がその名前を告げます。`IllegalArgumentException` も `NameNotFoundException` もこの形で届き、どちらもパッケージ名の綴り間違いか、存在しないパッケージを指しています。状態の行はまったく印字されないので、分類器はそこで「望まない状態が返ってきた場合」と切り分けます。 |
何が変わるか、そして戻る道
アプリは実行されず、ブロードキャストも受け取らず、そのユーザーのランチャーから消えます。何も削除されません。`pm enable --user <id> <pkg>` で元に戻ります。他のアプリが依存しているシステムサービスを無効にすると、あとになってから壊れていることに気づく形の故障が起きるので、1 つずつ変えて何が止まるかを見てください。
バージョンとメーカーに関する注意
- `disable-user` はこのコマンドが読み返す状態を設定するので、他の経路ですでに無効化されていたパッケージは `disabled` や `disabled-until-used` と答えます。3 つとも「動いていない」という意味です。
- 頼んだのと違う状態を名乗る成功行は、落ち着いた声の失敗です。この行を読むかどうかが、正直な復元ボタンと壊れた復元ボタンの差になります。
これには UI があります
Android Debloat Tool はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。
関連コマンド
pm disable-user と同じ作業で出てくるコマンド。
| コマンド | 何をするか |
|---|---|
| pm uninstall | パッケージを削除します。ユーザー単位の削除なら、root なしでプリインストールアプリを片付けられます。 |
| pm list packages | インストール済みパッケージを一覧表示します。APK パス、uid、バージョンコード、インストーラも同時に取得できます。 |
| dumpsys package | パッケージマネージャが知っているすべて：バージョン、パス、flags、インストール元、ユーザーごとの状態。 |
他のパッケージ（pm）コマンド
| コマンド | 何をするか |
|---|---|
| pm path | インストール済みパッケージを構成する APK ファイルの絶対パスを表示します。 |
| pm clear | アプリのデータを消去します。Android 13 以降ならキャッシュだけを消すこともできます。 |
| pm trim-caches | 指定した空き容量に達するまで、システムにキャッシュファイルを捨てさせます。 |
| pm install | すでに端末上にある APK を 1 つインストールします。`adb install` が内部でやっていることです。 |
| pm install-create | インストールセッションを開き、base とその split をまとめて 1 つの操作としてインストールします。 |
Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。