您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

SWTBot 實戰：Eclipse RCP 應用自動化 GUI 測試完全指南

編輯：Java 相關知識

前言：為何選擇 SWTBot？

基於 Eclipse 的應用廣泛普及，GUI 自動化測試需求隨之而來。SWTBot 是年輕且強大的開源專案（已納入 Eclipse 基金會孵化），專注簡化 SWT 與 Eclipse RCP 應用的 GUI 測試，平台獨立、功能完善，已成功應用於多個產品測試。本文詳述環境建置、首個測試案例、架構設計、核心 API 與實戰技巧。

環境建置與第一個測試案例

安裝 SWTBot

Eclipse 選單 Help → Install New Software
新增更新站點：https://download.eclipse.org/technology/swtbot/galileo/dev-build/update-site/
選擇安裝：SWTBot SWT Test、Eclipse Test、GEF Test（撰寫時 GEF 尚未整合）

建立測試專案

建立 Eclipse Plug-in 專案
在 MANIFEST.MF 依賴頁籤添加 SWTBot 相關外掛
建立 JUnit 4 測試類別，指定 @RunWith(SWTBotJunit4ClassRunner.class)

測試案例：模擬新增更新站點

@RunWith(SWTBotJunit4ClassRunner.class)
public class AddUpdateSiteTest {
  private static SWTWorkbenchBot bot;

  @BeforeClass
  public static void setUp() throws Exception {
    bot = new SWTWorkbenchBot();
    bot.viewByTitle("Welcome").close();
  }

  @Test
  public void testAddUpdateSite() throws Exception {
    bot.menu("Help").menu("Install New Software...").click();
    SWTBotShell shell = bot.shell("Install");
    shell.activate();

    bot.button("Add...").click();
    SWTBotShell shell1 = bot.shell("Add Site");
    shell1.activate();

    bot.textWithLabel("Name:").setText("SWT development tools");
    bot.textWithLabel("Location:").setText("https://www.eclipse.org/swt/updates/3.5");

    SWTBotAssert.assertEnabled(bot.button("OK")); // 驗證按鈕狀態

    bot.button("Cancel").click(); // 取消以便重複執行
    bot.button("Cancel").click();
  }

  @AfterClass
  public static void tearDown() throws Exception {
    bot.sleep(5000);
  }
}

關鍵點：必須使用 SWTBotJunit4ClassRunner，因 SWTBot 測試事件會阻塞，若與 UI 同執行緒會導致測試卡死。

執行測試

選中測試類別 → Run → Run Configurations
選擇 Eclipse Application，設定啟動參數
執行：Eclipse 啟動，SWTBot 自動模擬操作並驗證

SWTBot 架構深度解析

三大模組

SWT 模組：核心基礎，提供 Widget 代理類、查找器、匹配器
Eclipse 模組：支援 Perspective/View 等 Eclipse 特有元件，實作結構一致
GEF 模組：圖形編輯框架測試支援（孵化階段）

核心類別結構

SWTBot 類提供各種方法取得目標控制項代理類（Widgets）。查找器依條件定位控制項，匹配器支援強大表達式（基於 Hamcrest 庫）。

SWT 與 SWTBot 類別對應關係

SWT Widget 子類 → SWTBot 代理類繼承 AbstractSWTBot
SWT Control 子類 → SWTBot 代理類繼承 AbstractSWTBotControl

抽象類實作通用測試方法：模擬滑鼠動作、檢查控制項狀態等。

驗證點與斷言機制

SWTBot 在 SWTBotAssert 提供 GUI 專用斷言，支援常規驗證、正則表達式驗證等。並提供快照功能：測試失敗時自動截圖儲存，直觀定位問題。

非同步處理：ICondition 機制

傳統方式需自行處理執行緒超時/等待，易產生維護問題。SWTBot 透過 ICondition 介面與實作類，提供完善的等待條件機制（如控制項顯示、文字變更、啟用狀態等）。若內建不足，可呼叫 Conditions 工廠類自訂條件。

實戰開發技巧

控制項定位策略

從 SWTWorkbenchBot 起始，透過 Bot 方法尋找目標控制項
GUI 物件為樹狀結構，指定適當父物件可大幅提升查找效率
API 直觀易讀：bot.button("text")、bot.textWithLabel("Label:")、bot.menu("menu").menu("submenu") 等