ByteScope

pm path

唯讀

印出組成某個已安裝套件的 APK 檔絕對路徑。

指令
adb shell pm path
指令
套件(pm)
風險
唯讀

語法

pm path [--user <id>] <package>

旗標與參數

token意義
--user <id>只問一個 Android 使用者。舊版會拒絕這個旗標,那就拿掉再跑一次。

範例

  • pm path com.example

    分割安裝時,除了 base APK 每個 split 也各一行。

  • pm path --user 0 com.example

    要的是主要使用者那份,而不是工作設定檔那份。

輸出怎麼讀

輸出範例

package:/data/app/~~kO7bJ9w==/com.example-Ay8s2Q==/base.apk
package:/data/app/~~kO7bJ9w==/com.example-Ay8s2Q==/split_config.arm64_v8a.apk

一個檔案一行 `package:`。只有一行代表單一 APK;好幾行代表分割安裝,這時只抓 base 那個檔,得到的是一個裝不進任何裝置的 app。而且不是每一行都是 APK:透過 Play 安裝還會寫入 `.dm` 這種 dex 中介資料,那是安裝器的東西,不屬於 app。

輸出欄位

欄位意義
package:<path>套件的每個檔案各一條絕對路徑。
base.apk主要的 APK。
split_*.apk一個組態 split:ABI、螢幕密度或語言。
*.dm安裝器寫下的 dex 中介資料,不屬於 app 本身。

需要什麼權限

只要一條授權過的 `adb` 連線:不用 root、不用 `adb root`、也不用 `su`。`pm` 就是那行 `cmd package "$@"` 的 shell script(AOSP `cmds/pm/pm.sh`),所以問題是以纜線另一端 `shell` 使用者的身分回答的,而 `path` 只讀套件資料庫——它不安裝、不搬移、也不刪任何東西。但後面有兩件事和存取權有關。第一,`--user <id>` 是在問別人的 Android 使用者,不願意讓 shell 跨過那條界線的版本會丟一個 `SecurityException` 回來,而不是路徑。第二,「被告訴 APK 在哪」和「被允許讀它」是兩回事:`/data/app/**` 對 shell 使用者能不能穿越並沒有白紙黑字的保證,所以強化過的版本完全可能印出一條好好的路徑,然後在你要拉檔案時拒絕你。`parsePmPathOutput` 之所以把「被拒絕」和「空答案」分開,就是為了這個,APK Extractor 也把這個差別攤開來而不是藏起來。

失敗訊息對照

訊息意義
Error: Unknown option: --user這個版本的 `pm path` 不接受 `--user`。跟這一族所有的選項拒絕一樣,它在印出任何一行 `package:` 之前就中止,所以答案是「沒問到」而不是「空的」——拿掉旗標再問一次,不要當成 app 沒安裝。哪一版開始接受這個旗標,這個 repo 沒有查證過,所以就當版本未知,讓裝置自己回答。
Exception occurred while executing 'path':`ShellCommand` 外層抓到 `Throwable`,把這個橫幅加上堆疊追蹤寫到標準錯誤。底下那行才是原因,出現 `java.lang.SecurityException` 代表那個 user id 不是 shell 可以查的。`findPmPathFailure` 會先找這個橫幅再去讀路徑,因為標準錯誤一旦被丟掉,「被拒絕」和「沒安裝」就長得一模一樣。
cmd: Can't find service: package`cmd` 找不到 `package` 這個服務可以把子指令交出去。裝置還在開機、`system_server` 還沒註冊它時本來就會這樣——等開機完成再說,不要把手機當成壞了。

版本與廠商注意事項

  • 不存在的套件什麼都不印且以 1 結束,所以空結果代表「沒安裝」而不是「失敗」。
  • shell 使用者到底能不能讀 `/data/app/**` 並沒有保證。多數版本上目錄可穿越、APK 可讀取,這也是取出 base APK 這招流傳十年的原因,但強化過的版本確實會拒絕。

這個我們有 UI

APK Extractor 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器,不必安裝 SDK,也不會上傳任何東西。

開啟 APK Extractor

相關指令

和 pm path 會在同一次作業裡出現的指令。

指令做什麼
pm list packages列出已安裝的套件,也能一次帶出 APK 路徑、uid、版本碼與安裝來源。
dumpsys package套件管理員知道的一切:版本、路徑、flags、安裝來源,以及每個使用者的狀態。
pm install-create開一個安裝工作階段,讓 base 與它的 split 作為一個不可分割的整體一起安裝。

其他套件(pm)指令

指令做什麼
pm uninstall移除套件,或只針對一個 Android 使用者移除——這是不用 root 也能處理掉預載 app 的方法。
pm disable-user在不移除的前提下,把套件對某個 Android 使用者關掉——比解除安裝安全,而且確定能還原。
pm clear清除某個 app 的資料——在 Android 13 之後也可以只清快取。
pm trim-caches要求系統一直丟掉快取檔案,直到剩下你指定的空間為止。
pm install安裝一個已經在裝置上的 APK,也就是 `adb install` 底層在做的事。

這些行為是在撰寫 Web ADB 工具背後的解析程式時,對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方,這一頁會直接說明,而不是給你一個在半數手機上都是錯的數字。

常見問題

adb shell 指令要怎麼執行?

在手機上打開開發者選項與 USB 除錯、接上線,然後從裝了 platform-tools 的機器執行 adb shell <指令>——或者只執行 adb shell 取得互動提示字元,再直接打指令、不用前綴。如果指令會輸出二進位資料(例如截圖),請改用 adb exec-out 而不是 adb shell:單純的 shell 服務會配一個終端機,而它會改寫換行位元組並毀掉資料。

adb shell 指令需要 root 嗎?

這份參考裡的都不用。它們以 shell 使用者身分執行,可以針對自己的 Android 使用者管理套件、讀取大多數 dumpsys 服務、寫入設定提供者、注入輸入,以及讀取共用儲存空間。需要 root 的是這份參考刻意避開的事:讀取其他 app 的私有資料(除了對可除錯版本使用 run-as)、寫入系統分割區,或直接讀 /data/anr。

為什麼在我的手機上輸出看起來不一樣?

不是 Android 版本就是廠商。有些旗標與欄位是從特定版本才有的,那些都在各指令頁註明了。其餘是廠商改動,而受影響最深的是 dumpsys:一份 dump 是除錯輸出,它的文字就是那個服務的作者最後印了什麼,而廠商既會改它也會把改動往回移植。請用名稱而不是位置來讀欄位,並把沒見過的格式當成差異而不是失敗。

可以用瀏覽器而不是終端機來跑嗎?

很多指令可以——本站的 Web ADB 工具從 Chromium 系桌面瀏覽器透過 WebUSB 和手機對話,不必安裝 SDK,也不會上傳任何東西。每一頁在有對應工具時都會連過去。有兩個限制值得知道:同一時間只有一個程式能持有 ADB 介面,所以桌面的 adb server 要先停掉;而 adb forward 與 adb reverse 在瀏覽器裡完全無法運作。

比較想按而不是打字?Web ADB Toolkit 會從瀏覽器透過 USB 執行這類指令。或者瀏覽全部指令。