本文详解如何通过 jpackage 的 $APPDIR 变量动态指定 java.library.path，使基于 JNI 的 Java 应用在 Linux 安装包中可靠加载共享库，避免硬编码绝对路径。
本文详解如何通过 jpackage 的 `$appdir` 变量动态指定 `java.library.path`，使基于 jni 的 java 应用在 linux 安装包中可靠加载共享库，避免硬编码绝对路径。
在使用 jpackage 打包含 JNI 依赖的 Java 应用时，Linux 平台常因原生库（如 .so 文件）路径解析失败而启动报错——典型错误为 UnsatisfiedLinkError: no xxx in java.library.path。尽管 Windows 版安装包能自动在 JAR 同级目录下发现 .dll，但 Linux 的 deb 或 rpm 包默认将应用安装至 /opt/<appname>/lib/app/，且启动脚本不继承命令行中 -Djava.library.path=... 的设定，导致手动指定相对路径（如 .）或硬编码绝对路径（如 /opt/myapp/lib/app）均不可靠或缺乏可移植性。
根本解法在于利用 jpackage 自动生成的运行时环境变量：$APPDIR。该变量由安装器在生成的启动脚本（如 /opt/myapp/bin/myapp）中定义，指向应用根目录（即包含 lib/app/ 的父目录），且在 JVM 启动前已注入环境上下文。因此，正确做法是在 --java-options 中引用该变量：
jpackage \ --input target/ \ --name MyApp \ --app-version 1.2 \ --main-class uk.co.myco.MyApp \ --main-jar MyApp.jar \ --java-options '-Djava.library.path=$APPDIR/lib/app' \ --icon resources/icon.png \ --linux-package-name myapp \ --type deb
⚠️ 注意事项：
- $APPDIR 仅在 Linux/macOS 的启动脚本中有效，Windows 使用 %APPDIR%（需额外适配）；
- 路径必须相对于 $APPDIR 精确指定（如 lib/app 是默认布局，若自定义 --dest 或资源结构需同步调整）；
- 不要使用单引号包裹整个选项（如 '--java-options=-D...'），应确保 shell 变量展开发生在 jpackage 运行时，故推荐写法为 --java-options '-Djava.library.path=$APPDIR/lib/app'；
- 验证方式：安装后检查 /opt/myapp/bin/myapp 脚本，确认其中存在类似 export APPDIR="/opt/myapp" 和 java -Djava.library.path="$APPDIR/lib/app" ... 的逻辑。
最终，该方案兼顾了可移植性与健壮性——无论应用被安装到 /opt/myapp、/usr/local/myapp 或用户自定义路径，$APPDIR 均能动态适配，无需重新打包或修改配置。这是官方推荐的跨平台 JNI 路径管理实践，也是 jpackage 设计中被低估却至关重要的特性。
