pm list packages
唯讀列出已安裝的套件,也能一次帶出 APK 路徑、uid、版本碼與安裝來源。
- 指令
- adb shell pm list packages
- 指令
- 套件(pm)
- 風險
- 唯讀
語法
pm list packages [-f] [-U] [--show-versioncode] [-i] [-s | -3 | -e | -d | -u] [--user <id>] [<name filter>]旗標與參數
| token | 意義 |
|---|---|
| -f | 一併印出安裝來源的 APK 路徑。 |
| -UAndroid 8.0 起 | 一併印出 uid。 |
| --show-versioncodeAndroid 8.0 起 | 一併印出版本碼。 |
| -i | 一併印出安裝者套件。每個套件會多一次 binder 呼叫。 |
| -s | 只列系統套件。 |
| -3 | 只列第三方套件。 |
| -e | 在查詢的使用者下目前啟用的套件。 |
| -d | 在查詢的使用者下目前停用的套件。 |
| -u | 把「保留資料移除」的套件也算進來,因此這份清單是預設清單的超集。 |
| --user <id> | 只問一個 Android 使用者。不加的話會問全部使用者,於是在 user 0 停用、在工作設定檔啟用的套件會同時出現在 -e 與 -d 兩份清單裡。 |
範例
pm list packages -3只看你自己裝的 app。
pm list packages -f -U --show-versioncode一次拿到完整清冊:路徑、uid 與版本碼。
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:10234一行一個套件。平台是從左往右組出這一行的,所以讀的時候要從右邊往回剝:依序拿掉 `uid:`、`installer=`、`stopped=`、`versionCode:`,剩下的才是套件名稱。新版 APK 路徑本身就含好幾個 `=`,直接切會把名字切錯。
輸出欄位
| 欄位 | 意義 |
|---|---|
| package: | 每一行都有的固定前綴。 |
| <path>= | APK 路徑,只有加 -f 才有,結束在最後一個 `=`。 |
| versionCode:<n> | long 型別的版本碼,需要 --show-versioncode。 |
| stopped=<bool> | 套件是否處於 stopped 狀態。 |
| installer=<pkg> | 加 -i 時的安裝者。它前面是兩個空白而不是一個,預載 app 會印出 `null` 這四個字母。 |
| uid:<n>[,<n>] | 加 -U 時的 uid。套件存在於多個 Android 使用者時會是逗號分隔的清單。 |
需要什麼權限
只要一條授權過的 `adb` 連線就夠——不用 root、不用 `adb root`、也不用 `su`。`pm` 只是一行 shell script,內容是 `cmd package "$@"`(AOSP `cmds/pm/pm.sh`),所以這份清單是以纜線另一端 `shell` 使用者的身分回答的,而這一頁上的每個旗標都是唯讀:沒有任何一個會安裝、移除或停用東西。真正會咬人的存取問題是你留下了哪一條輸出串流。`BasicShellCommandHandler.exec` 把失敗橫幅與堆疊追蹤寫到標準錯誤,所以用 `2>/dev/null` 收集的結果,會把一次被拒絕的呼叫變成一份空清單,讀起來就跟一台什麼 app 都沒裝的手機一模一樣。請改用 `2>&1` 收,答案短得可疑時先讀第一行再下結論。
失敗訊息對照
| 訊息 | 意義 |
|---|---|
| Error: Unknown option: -U | Android 7.1 以前不認識 `-U` 與 `--show-versioncode`。`runListPackages` 印完這行就返回,一個套件都不會列,所以結果是空的而不是少一欄——把旗標拿掉重跑,不要當成這台手機沒裝 app。 |
| Exception occurred while executing 'list': | `BasicShellCommandHandler.exec` 抓到了 `Throwable`,把這一行加上堆疊追蹤寫到標準錯誤。下一行才是原因:出現 `java.lang.SecurityException` 代表呼叫被拒絕,不是沒有東西安裝。而且你得有留著標準錯誤才看得到這些。 |
| cmd: Can't find service: package | `cmd` 找不到 `package` 這個服務可以把子指令交出去。裝置還在開機、`system_server` 還沒把它註冊出來時本來就會這樣——等開機完成再問一次,不要當成裝置壞了。 |
版本與廠商注意事項
- `-U` 與 `--show-versioncode` 是 Android 8.0 才有的。更舊的版本遇到不認識的選項會印 `Error: Unknown option: -U`,然後一個套件都不列,所以空結果代表指令失敗,不代表手機上沒有 app。
- Android 10 之後的 APK 路徑含有多個 `=`(`/data/app/~~kO7bJ9w==/com.foo-Ay8s2Q==/base.apk`),路徑與名稱要用最後一個 `=` 來分。
- 同一個名稱同時出現在 -e 與 -d 並不矛盾:啟用狀態是每個 Android 使用者各自的,而這個指令預設會問全部使用者。加上 `--user 0` 就不會這樣。
這個我們有 UI
Android Debloat Tool 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器,不必安裝 SDK,也不會上傳任何東西。
相關指令
和 pm list packages 會在同一次作業裡出現的指令。
| 指令 | 做什麼 |
|---|---|
| pm path | 印出組成某個已安裝套件的 APK 檔絕對路徑。 |
| pm uninstall | 移除套件,或只針對一個 Android 使用者移除——這是不用 root 也能處理掉預載 app 的方法。 |
| pm disable-user | 在不移除的前提下,把套件對某個 Android 使用者關掉——比解除安裝安全,而且確定能還原。 |
| dumpsys package | 套件管理員知道的一切:版本、路徑、flags、安裝來源,以及每個使用者的狀態。 |
其他套件(pm)指令
| 指令 | 做什麼 |
|---|---|
| pm clear | 清除某個 app 的資料——在 Android 13 之後也可以只清快取。 |
| pm trim-caches | 要求系統一直丟掉快取檔案,直到剩下你指定的空間為止。 |
| pm install | 安裝一個已經在裝置上的 APK,也就是 `adb install` 底層在做的事。 |
| pm install-create | 開一個安裝工作階段,讓 base 與它的 split 作為一個不可分割的整體一起安裝。 |
這些行為是在撰寫 Web ADB 工具背後的解析程式時,對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方,這一頁會直接說明,而不是給你一個在半數手機上都是錯的數字。