通過RAP將Eclipse RCP應用遷移至瀏覽器運行完整實戰

Eclipse RAP（Rich Ajax Platform）讓RCP（Rich Client Platform）應用幾乎零修改即可在瀏覽器中運行。本文通過將官方Mail模板從RCP遷移至RAP的完整過程，演示依賴替換、擴展點重構、啟動機制改造、主題品牌化等關鍵步驟。

遷移前準備

• 創建RCP插件項目com.vwpolo.rcp.mail，選擇「RCP Mail Template」
• 確認目標：將桌面端Mail Demo轉為Web端RAP Mail Demo

核心遷移步驟

1. 依賴替換（plugin.xml → Dependencies）

根據項目實際引用補充其他RAP bundles（如org.eclipse.rap.jface）。

2. 擴展點重構（plugin.xml → Extensions）

3. 啟動類改造：IEntryPoint實現

原Application實現IApplication，改為實現IEntryPoint：

public class Application implements IEntryPoint {
    @Override
    public int createUI() {
        Display display = PlatformUI.createDisplay();
        return PlatformUI.createAndRunWorkbench(display, new ApplicationWorkbenchAdvisor());
    }
}

對比RCPstart()：無需處理事件循環、display.dispose()、重啟邏輯，RAP容器自動管理生命周期。

4. 品牌化配置（org.eclipse.rap.ui.branding）

<branding
    id="com.vwpolo.rap.mail.branding"
    servletName="rapmail"
    defaultEntrypointId="com.vwpolo.rap.mail.entrypoint"
    themeId="org.eclipse.rap.ui.defaultTheme"
    title="RAP Mail Demo"
    favicon="icons/favicon.ico"
    body="loading.html"
    exitConfirmationClass="com.vwpolo.rap.mail.ExitConfirmation">
</branding>

• servletName：瀏覽器訪問路徑/rapmail
• body：加載頁面（如GMail風格「正在載入...」）
• exitConfirmationClass：關閉瀏覽器彈出確認對話框

5. ActionFactory適配

RAP無ActionFactory.ABOUT，兩種方案：

1. 自定義Action（推薦）：

aboutAction = new Action() {
    public void run() {
        Shell shell = window.getShell();
        Bundle bundle = Platform.getBundle(MailActivator.PLUGIN_ID);
        String version = bundle.getHeaders().get(Constants.BUNDLE_VERSION);
        MessageDialog.openInformation(shell, "RAP MailDemo", "版本: " + version);
    }
};
aboutAction.setText("關於");
aboutAction.setId("com.vwpolo.rap.mail.about");

2. 直接刪除About菜單項

驗證運行

1. 右鍵項目 → Run As → RAP Application
2. 瀏覽器訪問https://localhost:8080/rapmail
3. 效果：完整Mail界面（郵件列表、文件夾樹、預覽面板）在Web中流暢運行

遷移核心差異總結

遷移建議

• 優先替換依賴與擴展點，再處理編譯錯誤
• 利用PlatformUI.isWorkbenchRunning()區分RCP/RAP運行時邏輯
• 自定義主題（CSS）適配Web風格，替換默認SWT主題
• 大型項目分模塊漸進式遷移，保持雙端同步構建

完成上述步驟，RCP應用即可零成本擁抱Web部署優勢。