settings put

端末を変える

設定プロバイダに値を書きます。開発者向けオプションのほとんどの裏にある仕組みです。

コマンド: adb shell settings put
コマンド: 設定プロバイダ
リスク: 端末を変える

構文

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

フラグと引数

トークン	意味
system \| secure \| global	名前空間。間違ったところに key を書くと、誰も読まない key が作られ、しかも黙って失敗します。

使用例

```
settings put global window_animation_scale 0.0
```
アニメーションを 1 つ切ります。開発者向けオプションは実際には 3 つの倍率を設定し、残りは `transition_animation_scale` と `animator_duration_scale` です。
```
settings put system show_touches 1
```
画面を触った位置に点を描きます。デモの録画に便利です。
```
settings put global http_proxy 10.0.0.5:8080
```
端末の HTTP スタックを自分の機械のプロキシに向けます。
```
settings put global http_proxy :0
```
プロキシを消します。`:0` はプラットフォーム自身の設定 UI が書く値です。

出力の読み方

成功時は何も出ません。無言が答えなので、出力がないことを信じるのではなく `settings get` で確かめてください。間違った名前空間への書き込みも、正しい書き込みと同じくらい無言です。

出力フィールド

フィールド	意味
(no output)	書き込みが受け付けられました。
Exception / Permission Denial	このビルドでは shell ユーザーがその key を書けません。

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

導出できる解毒剤はありません。プラットフォームは前の値を覚えないので、書く「前」に `settings get` で読み、その値を保管してください。いちばん痛いのはプロキシの key です。`global http_proxy` が設定されたまま端末を持ち出すと、どのネットワークでもインターネットが使えず、端末上には理由を説明するものが何もありません。空文字ではなく `settings put global http_proxy :0` で消してください。

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

元に戻すとは古い値を書き戻すことで、そのためには先に読んでおく必要があります。このコマンド自身に取り消しはありません。
空文字でプロキシを消すのは確実ではありません。いくつかのビルドは 2 つの引用符をそのまま保存し、端末は無意味な宛先を向いたままになります。書くべき値は `:0` です。
「アニメーション off」は 1 つではなく 3 つの key です。window の倍率だけを設定しても、transition と animator は動いたままです。

これには UI があります

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

Android ADB Toolbox を開く

コマンド	何をするか
settings get	端末の設定プロバイダから値を 1 つ読みます。
am broadcast	ブロードキャスト intent を送ります。SystemUI の demo mode などプラットフォームのレシーバをシェルから動かす方法です。
wm size	ディスプレイの解像度を報告します。上書きすれば、端末は別の画面のふりをします。

よくある質問

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 経由で実行します。あるいは全コマンドを見る。

構文