wm density

端末を変える

ディスプレイの密度を報告、または上書きします。レイアウトのブレークポイントを実際に動かすのはこちらです。

コマンド: adb shell wm density
コマンド: 画面と取り込み
リスク: 端末を変える

構文

wm density [<dpi> | reset]

フラグと引数

トークン	意味
<dpi>	報告させる密度。Android 自身のバケットは 120 から 640 で、ベンダーはその間の値も出荷します。
reset	上書きを外して物理密度に戻します。

使用例

```
wm density
```
報告のみ。
```
wm density 420
```
`wm size 1080x2340` と組み合わせると幅 411 dp の端末になり、これは実在するブレークポイントです。
```
wm density reset
```
取り消し。

出力の読み方

出力例

Physical density: 560
Override density: 420

`wm size` と同じ形です。Physical は常に、Override は設定されている間だけ。どのレイアウトになるかを決めるのは dp なので、意味のある量は「幅のピクセル × 160 ÷ この dpi」です。420 dpi の 1080 px は 411 dp、同じ 1080 px を 320 dpi にすると 540 dp のタブレット寄りのレイアウトになります。

出力フィールド

フィールド	意味
Physical density	パネルの実際の dpi。
Override density	代わりに報告されている値。上書きが設定されている間だけ現れます。

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

サイズの上書きと同じく再起動をまたいで残り、設定アプリを含む端末上のすべての UI 要素の縮尺を変えます。端末のパネルで密度 800 にすると、ボタンが 1 個半しか見えない状態になり、タップで抜け出すことはできません。`wm density reset` が戻る道です。試す前に手元に置いてください。

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

density だけ、あるいはサイズだけを変えると、存在しない端末の形になります。両方設定してください。
0 やとんでもなく大きい値は、画面を試す方法ではなく読めなくする方法です。

これには UI があります

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

Android ADB Toolbox を開く

コマンド	何をするか
wm size	ディスプレイの解像度を報告します。上書きすれば、端末は別の画面のふりをします。
screencap	スクリーンショットを撮ります。端末上のファイルに書くか、PNG として標準出力に流します。
settings put	設定プロバイダに値を書きます。開発者向けオプションのほとんどの裏にある仕組みです。

他の画面と取り込みコマンド

コマンド	何をするか
screenrecord	端末上の MP4 ファイルに画面を録画します。

Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。

よくある質問

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

構文