Eclipse RCP 開發：正確訪問打包在插件 JAR 中的圖片資源

在 Eclipse RCP 開發中，直接使用相對路徑或絕對路徑讀取圖片資源，雖然在 IDE 內運行正常，但導出為插件後所有資源被打包進 JAR，原有路徑失效。本文介紹官方推薦的 AbstractUIPlugin.imageDescriptorFromPlugin() 解決方案。

問題根源

插件導出時，icons/logo.png 等資源被封裝在 plugins/com.example.plugin_1.0.0.jar 內，類路徑不再是檔案系統路徑，傳統 new File() 或 getClass().getResource() 皆會失敗。

標準解決方案

使用 org.eclipse.ui.plugin.AbstractUIPlugin 提供的靜態方法：

String imagePath = "icons/logo.png"; // 圖片在插件內的相對路徑
ImageDescriptor descriptor = AbstractUIPlugin.imageDescriptorFromPlugin(
    "com.untworld.esystem.launcher",  // 插件 ID（plugin.xml 中的 id）
    imagePath
);

// 後續可透過 descriptor.createImage() 獲取 Image 實例
Image image = descriptor.createImage();

關鍵點

• 插件 ID：必須與 plugin.xml 中的 id 屬性完全一致
• 資源路徑：相對於插件根目錄，區分大小寫
• 返回值：ImageDescriptor 可延遲載入，避免記憶體洩漏

完整使用範例

public class ResourceUtil {
    public static Image getImage(String pluginId, String path) {
        ImageDescriptor desc = AbstractUIPlugin.imageDescriptorFromPlugin(pluginId, path);
        return desc != null ? desc.createImage() : null;
    }
}

// 調用處
Image logo = ResourceUtil.getImage("com.myapp.ui", "icons/logo.png");

避坑指南

1. 確認 build.properties 包含資源目錄：bin.includes = icons/
2. 不要在 Image 不再使用時忘記 dispose()
3. 大量圖片建議使用 ImageRegistry 統一管理

此方式完美解決 JAR 內資源訪問問題，是 Eclipse RCP 開發的必備技能。