settings put

會改變裝置

把值寫進設定提供者——多數開發者選項小技巧背後的機制。

指令: adb shell settings put
指令: 設定提供者
風險: 會改變裝置

語法

settings put <system|secure|global> <key> <value>

旗標與參數

token	意義
system \| secure \| global	命名空間。把 key 寫進錯的那一個，會產生一個沒有人會讀的 key，而且失敗是無聲的。

範例

```
settings put global window_animation_scale 0.0
```
關掉一種動畫。開發者選項實際上會設三個倍率，另外兩個是 `transition_animation_scale` 與 `animator_duration_scale`。
```
settings put system show_touches 1
```
在螢幕被觸碰的位置畫一個點，錄示範影片時很好用。
```
settings put global http_proxy 10.0.0.5:8080
```
把手機的 HTTP 堆疊指向你機器上的 proxy。
```
settings put global http_proxy :0
```
清掉 proxy。`:0` 是平台自己的設定介面會寫入的值。

輸出怎麼讀

成功時什麼都沒有。沒有輸出就是答案，所以請用 `settings get` 確認，而不是相信「沒有輸出」。寫進錯誤命名空間也一樣安靜。

輸出欄位

欄位	意義
(no output)	寫入被接受了。
Exception / Permission Denial	這個版本不允許 shell 使用者寫那個 key。

會改變什麼，以及怎麼回頭

沒有可以推導出來的解藥：平台不會記住原本的值，所以請在寫入「之前」用 `settings get` 讀一次並把那個值留著。最會咬人的是 proxy 那個 key——一台帶著 `global http_proxy` 出門的手機，在任何網路上都沒有可用的網際網路，而手機上沒有任何東西會解釋原因。清除要用 `settings put global http_proxy :0`，不要用空字串。

版本與廠商注意事項

還原就是把舊值寫回去，而那代表你得先讀過。這個指令本身沒有復原。
用空字串清 proxy 並不可靠：有幾種版本會把那兩個引號原樣存下來，手機還是指著一個沒用的目標。該寫的值是 `:0`。
「關掉動畫」是三個 key 而不是一個。只設 window 的倍率，transition 與 animator 還是照跑。

這個我們有 UI

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

開啟 Android ADB Toolbox

指令	做什麼
settings get	從手機的設定提供者讀出一個值。
am broadcast	送出廣播 intent，這是從 shell 驅動 SystemUI demo mode 等平台接收器的方法。
wm size	回報顯示器的解析度，或覆寫它，讓手機假裝自己是另一塊螢幕。

常見問題

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 執行這類指令。或者瀏覽全部指令。

語法