如何使用 jlink 将外部库添加到自定义运行时映像？

问题描述

我想将我的项目所需的外部库添加到自定义运行时映像。

我在我的项目中使用以下外部库：vlcj.jar、vlcj-javafx.jar

要使 vlcj.jar 工作，我还需要添加外部库：jna.jar、jna-platform.jar、vlcj-natives.jar

如果我重写我的应用程序以便不需要使用 vlcj.jar 和 vlcj-javafx.jar，那么自定义运行时映像创建行如下所示：

jlink --no-header-files --no-man-pages --compress=2 --strip-debug --module-path 'path/to/javafx-jmods-15.0.1' --add-modules javafx.controls,javafx.web --output /path/to/RuntimeImage

然后我创建我的应用程序的 jar：

cd path/to/myapp
jar cvfe path/to/myApp.jar MainClass *.*

然后我将 myApp.jar 添加到 RuntimeImage 并运行应用程序：

cd path/to/RuntimeImage
path/to/RuntimeImage/bin/java -jar myApp.jar

应用程序启动。东西不错。

唯一不好的是它在没有 VLCJ 的情况下也能工作。如何将外部 VLCJ 库添加到自定义运行时映像并使用它运行我的应用程序？

解决方法

自定义运行时映像不支持自动模块（非模块 jar），因此 jlink 映像中没有任何依赖 jar，该映像定义了与 vlc 一起运行的类路径。

您可以在自己的 jar 中编辑 META-INF\MANIFEST.MF 以指定类路径，以便可以从您运行 java -jar 的同一目录中读取额外的 jar：

Class-Path: vlcj.jar vlcj-javafx.jar jna.jar jna-platform.jar vlcj-natives.jar

或者使用显式类路径为您的应用程序切换到标准启动：

path/to/RuntimeImage/bin/java -cp myApp.jar:vlcj.jar:vlcj-javafx.jar:jna.jar:jna-platform.jar:vlcj-natives.jar your.MainClass

java java jlink