wm size

端末を変える

ディスプレイの解像度を報告します。上書きすれば、端末は別の画面のふりをします。

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

構文

wm size [<width>x<height> | reset]

フラグと引数

トークン	意味
<width>x<height>	自分の解像度の代わりに、この解像度を報告するようディスプレイに頼みます。
reset	上書きを外して物理解像度に戻します。

使用例

```
wm size
```
報告のみ。引数なしは変更なしです。
```
wm size 1080x2340
```
1080p の端末のふりをします。
```
wm size reset
```
取り消し。必要になる前に覚えてください。

出力の読み方

出力例

Physical size: 1440x3120
Override size: 1080x2340

1 行、または 2 行です。Override の行は「上書きが存在するときだけ」印字され、そこがすべての要点です。その存在が端末がふりをしている合図で、その値こそがレイアウトが実際に見るサイズです。Physical の行は変わりません。

出力フィールド

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

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

上書きは再起動をまたいで残り、しかも「すべて」が描かれるサイズを変えます。取り消すために開くはずの設定アプリも含めてです。値を間違えると操作部が画面の外に出て、端末から端末を直せなくなります。`wm size reset` で戻り、しかもこの上書きをここから設定したかどうかに関係なく効きます。何かを設定する前に、そのコマンドを見えるところに置いてください。

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

同時に density も設定してください。レイアウトのブレークポイントは密度非依存ピクセル（ピクセル × 160 ÷ dpi）に反応するので、解像度だけを変えると実在しない形の端末を試すことになります。
失敗が有益に報告されることはありません。拒否はサイズではなくリモート例外の行として返るので、サイズでないものは 0x0 ではなく「不明」として扱ってください。

これには UI があります

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

Android ADB Toolbox を開く

コマンド	何をするか
wm density	ディスプレイの密度を報告、または上書きします。レイアウトのブレークポイントを実際に動かすのはこちらです。
screencap	スクリーンショットを撮ります。端末上のファイルに書くか、PNG として標準出力に流します。
getevent	カーネルから生の入力イベントを流し読みします。各入力デバイスが何を報告できるかの一覧も取れます。

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

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

構文