傳回應用程式的版面配置樹狀結構。
用量
android layout [-dhp] [--device=PARAM] [--flat] [--full] [--no-idle] [--output=PARAM]
選項
--device=PARAM- 裝置序號。-d,--diff- 已淘汰,為無運算旗標。將在日後推出的版本中移除。--flat:傳回扁平清單,而非樹狀結構。--full- 傳回完整樹狀結構,包括非互動式和隱藏元素。-h,--help:顯示指定指令的說明訊息。--no-idle- Don't wait for layout idle state when fetching layout.-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 元素。--no-idle:立即擷取版面配置,不必等待應用程式 UI 執行緒達到閒置狀態。
範例
列印有效畫面的 UI 版面配置樹狀結構 (格式美觀):
android layout --pretty
將完整 UI 階層 (包括非互動式元素) 儲存至檔案:
android layout --pretty --full --output=./hierarchy.json