如何配置jpackage解决Linux平台JNI依赖Java应用的本地库加载问题？

问题根源 #

Linux下jpackage生成的启动脚本默认工作目录是用户当前目录（比如~/），而非应用安装目录（/opt/<lowercaseappname>/lib/app），所以你设置的-Djava.library.path=.指向的是用户工作目录，而非共享库所在目录，导致加载失败。

推荐解决方案 #

1. 使用jpackage官方--library-path参数（最优方案） #

jpackage提供了--library-path参数专门用于配置本地库路径，它会自动处理跨平台的路径映射，将共享库复制到安装包的正确位置，并在启动脚本中自动配置Java的库路径，无需手动指定绝对路径。

示例打包命令

假设你的项目打包前的目录结构如下：

dist/
├── MyApp.jar          # 主可执行Jar
└── libMyNative.so     # JNI共享库

执行以下打包命令：

jpackage \
  --name MyApp \
  --input ./dist \
  --main-jar MyApp.jar \
  --type deb \
  --library-path ./dist \  # 指定打包时共享库所在的源目录
  --main-class com.example.MyAppMain \
  --vendor "Your Company"

说明：

• --library-path指定的是打包前本地库的存放目录，jpackage会将该目录下的所有共享库复制到安装包的/opt/myapp/lib/app目录（与Jar同目录）。
• 生成的启动脚本会自动设置正确的java.library.path，启动应用时无需额外配置，就能正常加载JNI库。

2. 自定义启动脚本动态获取库路径 #

如果需要更灵活的配置，可以修改jpackage生成的启动脚本，让它自动推导应用安装目录下的库路径：

1. 找到安装后的启动脚本（通常在/opt/<appname>/bin/<appname>）。
2. 在脚本中添加路径推导逻辑，替换原有的java.library.path配置：

   # 获取应用安装目录下的库路径
   APP_BIN_DIR=$(dirname "$(realpath "$0")")
   APP_LIB_DIR="$APP_BIN_DIR/../lib/app"
   
   # 启动Java应用时使用该路径
   java -Djava.library.path="$APP_LIB_DIR" \
        -jar "$APP_LIB_DIR/MyApp.jar" \
        "$@"
   

3. 遵循Linux系统库规范（不推荐用户级应用） #

将共享库安装到系统标准库路径（如/usr/lib），但这种方式可能导致库版本冲突，仅适合系统级别的应用部署。

验证方案 #

打包完成后安装deb包，直接启动应用即可验证JNI库是否正常加载。该方案同样适用于Mac平台，Windows平台jpackage默认已自动处理同目录库的路径映射，无需额外配置。

内容的提问来源于stack exchange，提问作者Michael Ellis