JSmooth 打包報錯 "compilation failed error null" 根因排查與解決方案

現象

使用 JSmooth 0.9.9-7 將可執行 Jar 包裝裝為 Windows `.exe` 時，點擊 Compile 彈窗報錯：

jsmooth compilation failed error null

無具體行號、異常堆疊，極難定位。

核心根因：圖標文件 (Icon) 異常

JSmooth 對 `.ico` 文件的解析極其脆弱，常見觸發條件：

• 圖標尺寸不支援（僅支援 16×16、32×32、48×48、64×64）。
• 色深過高（建議 4-bit 或 8-bit，256 色以內）。
• ICO 內部包含多張圖片、PNG 壓縮格式、透明通道異常。
• 文件損壞或非標準 ICO 結構。

三步驟快速修復

1. 清空圖標欄位：JSmooth 介面「Executable」→「Icon」欄位清空 → 再次編譯。**若成功，確定為圖標問題**。
2. 轉換圖標格式：使用線上工具（如 ConvertIO、ICO Convert）將原圖轉為 **標準 32×32、256 色 `.ico`** 或直接用 **`.png`** 替代（JSmooth 亦支援 PNG）。
3. 重新指定並編譯：選擇轉換後的圖標 → Compile → 成功生成 `.exe`。

官方論壇佐證

SourceForge Bug #84："JSmooth seems very limited in the size and bitdepth of icons it supports... Try reducing the bit-depth and removing your larger icons to be just 16x16, 32x32 and maybe 48x48 with only 4 or 8 bits of depth."

社區回覆："After messing around with the parameters, I've fixed my case of 'Error: null'. My solution: Replace the not-working executable icon (.ico file) by a very simple PNG file."

替代方案：更現代的打包工具

建議：新專案優先用 `jpackage` 或 `Launch4j`，避開 JSmooth 多年未維護的坑。

總結

JSmooth `compilation failed error null` **99% 由圖標文件引起**。「清空圖標 → 驗證 → 換標準圖標」三步驟即可解決。長期來看，遷移至 `Launch4j` 或 `jpackage` 更省心。