Android レイアウト

アプリのレイアウト ツリーを返します。

使用方法

android layout [-dhp] [--device=PARAM] [--flat] [--full] [--no-idle] [--output=PARAM]

オプション

  • --device=PARAM - デバイスのシリアル番号。
  • -d,--diff - 非推奨。no-op フラグ。今後のリリースで削除される予定です。
  • --flat - ツリーではなくフラットなリストを返します。
  • --full - 操作できない要素や非表示の要素を含むツリー全体を返します。
  • -h,--help - 指定されたコマンドのヘルプ メッセージを表示します。
  • --no-idle - レイアウトを取得するときにレイアウトのアイドル状態を待機しない。
  • -o,--output=PARAM - 指定したファイルまたはディレクトリにレイアウトを書き込みます。省略すると、標準出力に出力されます。
  • -p,--pretty - 返された JSON を整形して出力します。

android 個のオプション:

  • --sdk=PARAM - Android SDK へのパス。
  • -v,--verbose - トラブルシューティングの詳細出力を有効にします。
  • -V,--version - バージョン情報を出力して終了します。

説明

android layout は、接続された Android デバイスまたはエミュレータのアクティブな画面のライブ UI 階層をキャプチャし、JSON 形式で出力します。

AI エージェントとテスト スクリプトは、android layout を使用して、視覚的なスクリーンショットだけに頼ることなく、表示されているテキスト、リソース ID、ユーザー補助の説明、インタラクションの状態、要素の境界を検査できます。

レイアウト出力の形式設定とフィルタ

  • -p, --pretty: 人間が読みやすいように、インデントと改行を使用して JSON 出力をフォーマットします。
  • -o, --output: レイアウト JSON を標準出力ではなく、指定されたファイルパスに書き込みます。
  • --flat: ネストされた階層ツリーではなく、UI ノードのフラットな JSON リストを出力します。
  • --full: デフォルトでフィルタリングされる非インタラクティブな UI 要素と非表示の UI 要素が含まれます。
  • --no-idle: アプリの UI スレッドがアイドル状態になるのを待たずに、レイアウトをすぐにキャプチャします。

例

アクティブな画面の UI レイアウト ツリーを整形して出力します。

android layout --pretty

UI 階層全体(インタラクティブでない要素を含む)をファイルに保存します。

android layout --pretty --full --output=./hierarchy.json