Eclipse 3.1.x SWT 項目原生庫導入完整解決方案

問題背景

Eclipse 3.1.x 將 SWT 原生庫打包在 org.eclipse.swt.win32.win32.x86_3.1.x.jar 中，不再像舊版本那樣單獨提供 DLL 文件。直接導入解壓目錄會報錯，需正確配置原生庫路徑。

正確解決步驟

步驟 1：安裝環境與解壓 JAR

1. 安裝 Eclipse 3.1.x + SWT Designer 插件
2. 定位 JAR：plugins/org.eclipse.swt.win32.win32.x86_3.1.x.jar
3. 使用 WinRAR/7-Zip 解壓該 JAR
4. 在解壓目錄中找到 swt-win32-XXXX.dll（如 swt-win32-3139.dll）

步驟 2：複製 DLL 到 JRE bin 目錄（關鍵）

# Windows 命令行示例
copy swt-win32-3139.dll "%JAVA_HOME%\jre\bin\"

# 或手動複製到：
# C:\Program Files\Java\jre1.x.x\bin\
# C:\Program Files (x86)\Java\jre1.x.x\bin\

原理：JVM 默認在 java.library.path 中包含 JRE bin 目錄，System.loadLibrary() 會自動尋找。

步驟 3：清理解壓目錄

# 刪除解壓產生的文件夾
rmdir /s /q org.eclipse.swt.win32.win32.x86_3.1.x

否則 SWT Designer 會錯誤導入該文件夾而非 JAR。

步驟 4：創建 SWT 項目

1. File → New → Project → SWT/JFace Java Project
2. 項目自動包含正確的 SWT JAR
3. 無需手動配置 Native Library Location

替代方案對比（官方文檔列舉）

啟動參數配置示例（生產環境推薦）

# eclipse.ini 或啟動腳本
-Djava.library.path=/opt/swt/native/linux/x86_64
# 或 Windows
-Djava.library.path=C:\swt\native\win32\x86_64

常見錯誤與排查

驗證代碼

import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Shell;

public class SWTTest {
    public static void main(String[] args) {
        Display display = new Display();
        Shell shell = new Shell(display);
        shell.setText("SWT 驗證");
        shell.setSize(300, 200);
        shell.open();
        while (!shell.isDisposed()) {
            if (!display.readAndDispatch()) display.sleep();
        }
        display.dispose();
    }
}

運行無誤報錯且彈出窗口，即配置成功。

推薦學習資源

• 《SWT/JFace in Action》附錄 "Creating projects with SWT/JFace" 第 316 頁
• Eclipse SWT 官方 FAQ: Native Library Loading
• SWT Designer 官方文檔：Project Creation Wizard

掌握 SWT 原生庫加載機制，能避開 Eclipse RCP 開發中最常見的環境配置坑。