Java 原生介面開發：javah 標頭檔產生器完整指南

javah 工具簡介

javah 是 JDK 早期版本提供的工具，用於從 Java 類別產生 C/C++ 標頭檔（.h）與樁檔（stub），支援 JNI（Java Native Interface）開發。注意：JDK 10 起已移除 javah，改用 javac -h 替代。

指令語法

javah [選項] 類別名稱 [其他類別...]

類別名稱使用完整限定名，不需 加 .class 副檔名。

選項對照表

現代替代方案：javac -h

JDK 8+ 推薦直接使用編譯器產生標頭檔：

# 編譯並同步產生 .h 檔到 include 目錄
javac -h include -d build/classes src/com/example/NativeDemo.java

優點：單一指令完成編譯與標頭檔產生，避免版本不一致。

JNI 開發流程概覽

1. 在 Java 類別宣告 native 方法
2. 編譯 Java 類別：javac -h include MyClass.java
3. 依產生的 .h 實作 C/C++ 函式
4. 編譯為共享庫（.so/.dll/.dylib）
5. Java 端用 System.loadLibrary 載入

產生的標頭檔關鍵內容

• JNIEXPORT/JNICALL 巨集：跨平台匯出修飾詞
• 函式簽名：Java_套件名_類別名_方法名(JNIEnv*, jobject, ...)
• 型別對應：jint、jstring、jobjectArray 等

常見坑點

• 套件名含底線：標頭檔函式名會將 _ 轉為 _1，需注意對應。
• 多載方法：JNI 依參數型別區分，C 端需實作對應簽名。
• 例外處理：C 端拋出例外需用 ThrowNew，不可直接 throw。

建議工具鏈

建議使用 CMake 或 Gradle 整合原生編譯，搭配 javac -h 自動化流程，避免手動維護標頭檔。