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 です。

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

アプリは実行されず、ブロードキャストも受け取らず、そのユーザーのランチャーから消えます。何も削除されません。`pm enable --user <id> <pkg>` で元に戻ります。他のアプリが依存しているシステムサービスを無効にすると、あとになってから壊れていることに気づく形の故障が起きるので、1 つずつ変えて何が止まるかを見てください。

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

`disable-user` はこのコマンドが読み返す状態を設定するので、他の経路ですでに無効化されていたパッケージは `disabled` や `disabled-until-used` と答えます。3 つとも「動いていない」という意味です。
頼んだのと違う状態を名乗る成功行は、落ち着いた声の失敗です。この行を読むかどうかが、正直な復元ボタンと壊れた復元ボタンの差になります。

これには UI があります

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

Android Debloat Tool を開く

コマンド	何をするか
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・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。

よくある質問

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

打つより押したい場合は、Web ADB Toolkit がこの種のコマンドをブラウザから USB 経由で実行します。あるいは全コマンドを見る。

構文