wm size
會改變裝置回報顯示器的解析度，或覆寫它，讓手機假裝自己是另一塊螢幕。
- 指令
- adb shell wm size
- 指令
- 畫面與擷取
- 風險
- 會改變裝置
語法
wm size [<width>x<height> | reset]旗標與參數
| token | 意義 |
|---|---|
| <width>x<height> | 要求顯示器回報這個解析度，而不是它自己的。 |
| reset | 拿掉覆寫，回到實體解析度。 |
範例
wm size只回報。沒有參數就不會改動。
wm size 1080x2340假裝自己是一台 1080p 手機。
wm size reset還原。在需要它之前就先學會。
輸出怎麼讀
輸出範例
Physical size: 1440x3120
Override size: 1080x2340一行，或兩行。Override 那行「只在覆寫存在時」才會印出來，而這就是全部的關鍵：它的存在是手機正在假裝的訊號，而它的值才是版面實際看到的尺寸。Physical 那行永遠不變。
輸出欄位
| 欄位 | 意義 |
|---|---|
| Physical size | 面板真正的樣子。 |
| Override size | 改成回報的值。只在覆寫存在時出現。 |
需要什麼權限
不用 root、也不用 `adb root`，但覆寫背後確實需要一個真正的平台權限。`wm` 是一行的 shell 腳本，跑的是 `cmd window "$@"`（AOSP 的 `cmds/wm/wm.sh`），而覆寫會經過的那兩個 window manager 呼叫 `setForcedDisplaySize` 與 `clearForcedDisplaySize`，都標註了 `@EnforcePermission(android.Manifest.permission.WRITE_SECURE_SETTINGS)`。`shell` 使用者所屬的套件 `com.android.shell`，在自己的資訊清單裡就有 `android.permission.WRITE_SECURE_SETTINGS`，所以一條已授權的線就夠了，而且除了 USB 偵錯本身，開發者選項裡沒有東西在管它。回報是免費的那一半：`wm size` 不帶參數就只是讀，這也是為什麼它是你動任何東西之前該跑、該記下來的指令。有兩個陷阱住在管線裡而不是權限裡。解析器是用 `indexOf` 找一個小寫的 `x`，而且它接受每個維度後面帶 `px` 或 `dp`——所以 `411dpx731dp` 是一個合法的、要求與密度無關形狀的寫法，而 `1080pxx2340px` 不是，因為它切開的是第一個 `px` 裡面那個 `x`。另外，兩行尺寸走 stdout，而每一行 `Error:` 都走 stderr，所以一支只留 stdout 的腳本，在實際上被拒絕的地方只會看到一個空答案。
失敗訊息對照
| 訊息 | 意義 |
|---|---|
| Error: bad size 1080X2340 | 參數裡沒有小寫的 `x`，或者那個 `x` 就在最前面或最後面。`runDisplaySize` 在呼叫 window manager 之前就拒絕了，所以什麼都沒改。大寫的 `X`、`*`，或某個語系的乘號都會落在這裡——被截斷的變數留下的 `1080x` 也是。 |
| Error: bad number | 後面會接上例外自己的 `toString()`，所以整行會指出它讀不懂的那個 token。某一個維度在拿掉可選的 `px` 或 `dp` 後綴之後不是整數。`1080pxx2340px` 是這一組裡最意外的成員：切點落在第一個 `px` 裡面，留下 `1080p` 被當成數字解析。什麼都沒改。 |
| Remote exception: | 回報那條路徑聯絡不到 window manager，於是在 stdout 上印了這行加例外，而不是一個尺寸。這正是本站的解析器回傳「未知」而不是一個數字的原因：任何不是 `Physical size:` 的東西都不可以被變成解析度，而 0x0 是所有猜測裡最糟的一個。 |
| Exception occurred while executing 'size': | shell 指令處理器接到一個 `Throwable`，下一行會說出它是誰。這裡出現 `java.lang.SecurityException` 代表呼叫者沒有 `WRITE_SECURE_SETTINGS`，而在原廠版本上從 `adb shell` 執行不該發生這種事——請把它當成被改過的版本，而不是參數打錯。覆寫沒有套用。 |
| cmd: Can't find service: window | `cmd` 找不到 `window` 服務，因為 `wm.sh` 只是 `cmd window` 的包裝。裝置還在開機、`system_server` 還沒登記它的時候，這是預期中的。什麼都沒讀到，也什麼都沒設定。 |
會改變什麼，以及怎麼回頭
覆寫會跨過重新開機留下來，而且它改的是「所有東西」被畫出來的尺寸，包含你想拿來還原的設定 app。值設錯可能讓操作元件跑到螢幕外，變成一台無法用自己修好自己的手機。`wm size reset` 會還原，而且不管這個覆寫是不是從這裡設的都有效——所以在設任何東西之前，先把那個指令放在看得到的地方。
版本與廠商注意事項
- 同時也要設定密度。版面的斷點是看與密度無關的像素（像素乘 160 再除以 dpi），所以只改解析度等於在測一個現實中不存在的形狀。
- 失敗不會有什麼有用的回報：被拒絕時回來的是一行遠端例外而不是尺寸，所以看到不是尺寸的東西就當成「未知」，不要當成 0x0。
這個我們有 UI
Android ADB Toolbox 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。
相關指令
和 wm size 會在同一次作業裡出現的指令。
| 指令 | 做什麼 |
|---|---|
| wm density | 回報顯示密度，或覆寫它——真正會讓版面斷點移動的是這一個。 |
| screencap | 擷取螢幕畫面，可以寫進手機裡的檔案，也可以把 PNG 送到標準輸出。 |
| getevent | 直接從核心串流原始輸入事件，或列出每個輸入裝置能回報什麼。 |
其他畫面與擷取指令
| 指令 | 做什麼 |
|---|---|
| screenrecord | 把螢幕錄成裝置上的一個 MP4 檔。 |
這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。