Android 版面配置

傳回應用程式的版面配置樹狀結構。

用量

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