OmniLab Android 測試站 2.0 升級指南

OmniLab Android 測試站 (ATS) 是開發人員和測試工程師用來自動化測試 Android 裝置的主要工具。OmniLab ATS 提供介面，可管理裝置、查看結果及執行測試套件，例如 Compatibility Test Suite (CTS)。

OmniLab ATS 2.0 是電台引擎的重大現代化升級。我們已將基礎架構遷移至 Google 的現代化高效能平台 OmniLab。這項異動可讓 Android 開發人員和測試工程師使用 Google 採用的強大工具。

建議您開始使用 OmniLab ATS 2.0。只要透過設定旗標啟用這項功能，就能立即享有更優異的效能和穩定性。

OmniLab ATS 2.0 的主要優點

  • 現代化基礎架構：運用 OmniLab 平台提升穩定性和效能。
  • 順暢轉換：網頁使用者介面或核心測試執行工作流程不會有任何異動。
  • 為未來做好準備：與 Google 的統一測試基礎架構保持一致，可更快採用新功能。

新功能

這些功能可簡化測試作業：

  • 大量更新測試計畫：您可以透過標籤篩選多個測試計畫，然後一次設定。您只需一個步驟，就能更新數十個方案的自訂時間表、測試執行動作和資源，減少手動設定時間。

  • 改善多主機和雲端部署支援：ATS 2.0 可最佳化測試排程、檔案傳輸和檔案快取，讓系統在多種部署模式下都能穩定、有效率且靈活運作。

  • 雲端協調：ATS 2.0 支援雲端協調，可在測試執行期間動態佈建、擴充及管理 Cuttlefish 虛擬裝置。

功能比較：ATS 1.0 與 ATS 2.0

功能ATS 1.0ATS 2.0
基礎引擎Tradefed 和 Tradefed 叢集OmniLab 平台 (Google 標準裝置平台)
UIMTT UIMTT UI
規模本機和多主機本機和多主機；針對多主機部署作業進行最佳化
重試基本重試規則可自訂重試次數、進階重試排程
虛擬裝置支援支援本機和雲端裝置農場支援本機和雲端裝置農場
處理結果以 Tradefed 為基礎OmniLab ATS (與 CTS 控制台共用)
API支援支援

使用者體驗異動

雖然大部分變更都是內部作業，但請注意下列行為更新：

  • 受密碼保護的測試套件 (例如 Security Test Suite (STS))： 在 ATS 1.0 中，受密碼保護的套件是使用 Trade Federation setup_scripts 擷取 (例如執行 unzip -P ...)。

    在 OmniLab ATS 2.0 中，伺服器會在啟動 Tradefed 前，以原生方式處理測試套件解壓縮作業。受密碼保護的套裝組合：

    • 從「設定指令碼」中移除手動 unzip -P ... 指令。保留解壓縮指令碼會導致叫用錯誤。
    • 直接在「測試資源定義」下方的「密碼」欄位中，輸入測試套件解密密碼。

    在 ATS 2.0 中調整 STS 測試設定

    圖 1. 在 ATS 2.0 中調整 STS 測試設定。

  • 結果目錄：由於基礎架構變更，磁碟上的測試結果輸出目錄結構已更新。不過，您仍可透過「測試執行」資訊主頁存取這些檔案。

    查看輸出檔案

    圖 2. 查看輸出檔案清單。

  • 測試記錄：測試記錄結構已變更。您可以在一次叫用中看到三種記錄來源：Tradefed xTS 測試產生的記錄 (也包含在 ATS 1.0 中)、裝置和測試狀態的 OmniLab 伺服器記錄，以及 V2 Mobly 模組的 Mobly 測試記錄。

    ATS 2.0 記錄來源

    圖 3. ATS 2.0 記錄來源：Tradefed xTS、OmniLab 伺服器和 Mobly 測試記錄。

    如果執行 CTS 時開啟動態下載選項，除了 CTS 測試外，OmniLab ATS 也會自動觸發 MCTS 測試，且 MCTS 記錄檔也會顯示在 Tradefed 記錄檔部分。

    測試清單中的 MCTS 測試

    圖 4. 由 XTS 動態下載觸發的 MCTS 測試。

    Tradefed 記錄部分中的 MCTS 記錄

    圖 5. 除了 CTS 記錄外，Tradefed 記錄部分也會顯示 MCTS 記錄。

升級程序

升級是透過軟體切換旗標，因此不需要重新安裝或變更硬體。

如要啟用新版 OmniLab ATS 2.0，請按照下列步驟操作：

  1. 停止目前的執行個體：

    mtt stop

  2. 使用 force_ats_version 2 旗標啟動 OmniLab ATS：

    mtt start --force_ats_version 2

    如果使用的不是最新建構版本，請新增 --force_update 來擷取：

    mtt start --force_ats_version 2 --force_update

  3. 選用：如果遇到 ATS 2.0 問題，可以移除 --force_ats_version 2 或明確使用 --force_ats_version 1，暫時還原為 ATS 1.0：

    mtt start --force_ats_version 1

轉換時程

我們將於 2026 年分階段淘汰 OmniLab ATS 1.0。請據此規劃遷移作業：

  • 2026 年第 1 季：所有開發人員和合作夥伴都能選擇使用 ATS 2.0。
  • 2026 年第 2 季：越來越多開發人員和合作夥伴會預設使用 ATS 2.0。
  • 2026 年第 3 季：ATS 2.0 將成為所有開發人員和合作夥伴的標準版本。
  • 2026 年第 4 季：舊版 ATS 1.0 將淘汰，並從正式版建構作業中移除。

支援

如果在升級過程中遇到任何問題，請參閱下列資源：