如何使用 gluonfx:build 在生成的可执行文件中添加版本、描述和版权元数据？

Question

我们需要生成的可执行文件中的元信息，以便右键单击并选择“详细信息”将显示描述、版权和版本。

我们在 releaseConfiguration 块中添加了描述和供应商，但可执行文件仍然没有元信息。

Answer 1

在 GluonFX 插件支持此功能之前，有一种相对简单的方法可以将元数据添加到您的可执行文件中。

您需要一个version.rc文件，就像 OpenJFX 用于不同的 JavaFX 库的文件： version.rc 。

然后，基本上你需要用正确的值编译它，最后将它与生成可执行文件的 obj 文件的 rest 链接起来。

这些是必需的步骤：

构建 GluonFX 项目

假设你有一个像HelloGluon这样的项目，你需要运行一次：

mvn gluonfx:build

这将在target/gluonfx/x86_64-windows/HelloGluon.exe下生成一个没有元数据的可执行文件。

资源文件

通过target/gluonfx/x86_64-windows/gvm/tmp/icon/IconGroup.obj添加了默认图标这一事实意味着已经有一个资源文件添加到可执行文件中。 由于只能有一个，我们需要通过一些手动工作来绕过它。

如果你检查日志：

Default icon.ico image generated in C:\%path.to.project%\target\gluonfx\x86_64-windows\gensrc\windows\assets.
Consider copying it to C:\%path.to.project%\src\windows

因此，让我们这样做：创建文件夹C:\%path.to.project%\src\windows ，并复制图标icon.ico和version.rc文件。

编辑C:\%path.to.project%\src\windows\version.rc并在#define STR(x) #x之后添加以下内容：

IDI_ICON1 ICON "icon.ico"

编译

按照 OpenJFX win.gradle构建文件中用于编译的标志，并从 x64 命令提示符，您可以运行：

cd C:\%path.to.your.project%\src\windows

rc /d JFX_FNAME=HelloGluon.exe /d JFX_INTERNAL_NAME=HelloGluon \
   /d "JFX_COMPANY=My company" /d "JFX_COMPONENT=My component" \
   /d "JFX_NAME=My name" /d "JFX_VER=1.0.0" /d "JFX_BUILD_ID=1.0.0.0+1" \
   /d "JFX_COPYRIGHT=My Copyright" /d "JFX_FVER=1,0,0" \
   /d "JFX_FTYPE=0x7L" \
   /FoC:\%path.to.your.project%\src\windows\version.res version.rc


cvtres /machine:x64 -out:C:\%path.to.your.project%\src\windows\version.obj C:\%path.to.your.project%\src\windows\version.res


这应该创建version.obj ：

> dir
 
C:\%path.to.your.project%\src\windows

21/01/2023  14:38    <DIR>          .
21/01/2023  14:38    <DIR>          ..
21/01/2023  14:18            15.031 icon.ico
21/01/2023  14:38             1.528 version.obj
21/01/2023  14:36             2.629 version.rc
21/01/2023  14:36               796 version.res

关联

现在检查日志target/gluonfx/log/process-link-****.log并复制链接命令，现在用你的 `version.obj 替换IconGroup.obj ：

link C:\%path.to.project%\target\gluonfx\x86_64-windows\gvm\HelloGluon\launcher.obj \
C:\%path.to.project%\target\gluonfx\x86_64-windows\gvm\tmp\SVM-*****\com.gluonapplication.gluonapplication.obj \

C:\%path.to.project%\src\windows\version.obj \

j2pkcs11.lib java.lib ... crypt32.lib /NODEFAULTLIB:libcmt.lib \
/SUBSYSTEM:WINDOWS /ENTRY:mainCRTStartup comdlg32.lib ... prism_d3d.lib /WHOLEARCHIVE:glass.lib ... /WHOLEARCHIVE:prism_d3d.lib \
/OUT:C:\%path.to.project%\target\gluonfx\x86_64-windows\HelloGluon.exe \
/LIBPATH:C:\~\.gluon\substrate\javafxStaticSdk\20-ea+7\windows-x86_64\sdk\lib \
/LIBPATH:C:\graalvm-svm-java17-windows-gluon-22.1.0.1-Final\lib\svm\clibraries\windows-amd64 \
/LIBPATH:C:\graalvm-svm-java17-windows-gluon-22.1.0.1-Final\lib\static\windows-amd64


这将再次链接您的可执行文件与您的元数据，您将从 Windows Explorer 中看到详细信息：

请注意，如果您再次运行mvn gluonfx:build ，您将丢失元数据，并且您将需要重新运行手动链接命令。