Java 呼叫 MATLAB 完整實戰：MATLAB Builder JA 部署與跨平台執行指南

將 MATLAB 演算法封裝為 Java 可呼叫的元件，是企業級專案常見的跨語言整合需求。本文以 MATLAB Builder JA（現已整合入 MATLAB Compiler SDK）為核心，完整記錄從環境準備、專案建立、元件打包、到無 MATLAB 環境機器部署 MCR 的全流程，並分享 AMD CPU 相容性問題的解決方案。

一、版本選擇與環境前置作業

• MATLAB 版本：Builder JA 於 R2006b 才引入，建議使用 R2009a (7.8) 或更新版本。
• JDK 需求：JDK 1.6 以上；JAVA_HOME 必須正確設定，MATLAB 內執行 getenv('JAVA_HOME') 驗證。
• AMD CPU 注意事項：若安裝後 MATLAB 閃退，需新增系統環境變數 BLAS_VERSION 指向 matlabroot\bin\win32\atlas_Athlon.dll。

二、建立 Builder JA 專案（以 Magic Square 官方範例為例）

1. 啟動 deploytool，選擇 MATLAB Builder JA，新建專案 magicsquare。
2. 將範例資料夾 matlabroot/toolbox/javabuilder/Examples/MagicSquareExample 複製至工作目錄（如 D:/javabuilder_examples/magic_square，路徑勿含空白）。
3. 在 MATLAB 指令視窗切換至該目錄，執行 makesqr(5) 驗證 M-code 正確性。
4. 回到 deploytool，將 makesqr.m 拖入專案的 magic 封裝資料夾；右鍵將類別資料夾重新命名為 class（預設用專案名，易混淆）。
5. 勾選 Generate Verbose Output，點擊 Build。完成後產生 src/（Java 原始碼）與 distrib/（magicsquare.jar）。

三、Java 端整合與測試

1. 建立 Java 專案，加入兩個 JAR：magicsquare.jar 與 matlabroot/toolbox/javabuilder/jar/javabuilder.jar。
2. 複製範例測試程式 MagicDemoJavaApp/getmagic.java 到專案並執行。
3. 程式會提示輸入階數（如 5），正確輸出 5×5 魔方陣即代表整合成功。

四、無 MATLAB 環境機器部署（MCR 安裝）

目標機器無需安裝完整 MATLAB，只需執行 MCR 安裝程式：
matlabroot/toolbox/compiler/deploy/win32/MCRInstaller.exe（依版本路徑略有不同）。
安裝完成後，Java 程式即可透過 MCR 執行 MATLAB 編譯元件。

五、常見坑點與避雷指南

• 類別資料夾命名：務必手動改為 class，否則產出的 package 結構不符預期。
• AMD CPU 相容性：設定 BLAS_VERSION 環境變數可解決閃退；Intel CPU 通常無此問題。
• MCR 版本對應：MCR 必須與編譯時的 MATLAB 版本完全一致，否則執行期會報 Version mismatch。
• 授權檢查：Builder JA 屬於 MATLAB Compiler SDK 附加產品，需確認 License 包含該 Toolbox。

六、總結

MATLAB Builder JA 讓演算法工程師專注於 .m 檔開發，Java 工程師只需引用 JAR 即可呼叫，實現語言邊界的無縫銜接。掌握「專案建立 → 打包 → MCR 部署」三步驟，並留意硬體相容性與版本對應，即可穩定落地生產環境。