OmniLab Android 測試站 2.0 升級指南

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

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

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

OmniLab ATS 2.0 的主要優點

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

新功能

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

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

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

功能比較：ATS 1.0 與 ATS 2.0

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

使用者體驗異動

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

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

    查看輸出檔案

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

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

    ATS 2.0 記錄來源

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

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

    測試清單中的 MCTS 測試

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

    Tradefed 記錄部分中的 MCTS 記錄

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

升級程序

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

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

  1. 停止目前的執行個體，然後使用 force_ats_version 2 旗標重新啟動：

    mtt start --force_ats_version 2

    在遷移期間，建議使用 dogfood 代碼存取通過驗證的最新版本，其中包含 ATS 2.0 功能：

    mtt start --force_ats_version 2 --tag dogfood --force_update

  2. 選用：如果 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 將淘汰，並從正式版建構作業中移除。

暫時的功能落差

我們正努力補齊暫時欠缺的功能：

  • 暫時測試計數：記錄檔即時更新時，暫時通過和失敗計數可能要等到測試完成才會顯示。
  • 工作階段續傳：如果主機重新啟動，執行中的測試無法續傳，必須重新啟動。

支援

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