在链式调用中,“共享库”是指连接器正常运行所需的任何外部库或依赖项。这些共享库由 Workiva 直接维护、更新和分发(除少数例外] )。目前,Java 21 是我们唯一的共享库,但如有需要,可能会添加其他依赖项。
要禁用共享库并替换为您自己的自行安装的库,请向您的 GroundRunner.config 文件中添加一个新的配置选项:
SHARED_LIBRARY_OVERRIDES=java-21=/path/to/java21/home,java-24=/path/to/java24/home此覆盖中提供的 路径 必须有效,并且必须包含一个名为“bin”的文件夹,其中包含相关的可执行文件。但是,路径本身不应该包含 bin 目录。
范例
考虑一个示例 Java 安装的文件夹结构:~/.asdf/installs/java/corretto-21.0.6.10.1 ❯ tree -L 1
这个结构看起来会是这样的:
. ├── 附加许可信息 ├── 程序集异常 ├── 许可 ├── 自述文件.md ├── bin ├── commitId.txt ├── conf ├── include ├── jmods ├── legal ├── lib ├── man ├── release └── version.txt你会注意到该文件结构中有 bin 文件夹。此文件夹 未 包含在我们提供的路径中。
相反,在 Mac 上, GroundRunner.config 文件中的覆盖设置如下所示:SHARED_LIBRARY_OVERRIDES=java-21=/Users/username/.asdf/installs/java/corretto-21.0.6.10.1
在 Windows 机器上,它看起来会像这样:SHARED_LIBRARY_OVERRIDES=java-21=C:\Program Files\Java\jre-21
注意:请确保您的 Windows 安装路径中使用反斜杠 (\)。
JRE 安装
在 GroundRunner 的初始安装过程中,不会安装 Java 运行时环境 (JRE)。安装完成后,GroundRunner 开始运行,它会根据需要自动下载 JRE 来运行依赖于 Java 的命令。无需安装或管理员干预,检索到的 JRE 不会影响主机上已存在的 JRE 安装。了解
更多关于 GroundRunner 的要求。
排除的连接器
这些连接器与 Workiva 的共享库不兼容,必须使用 GroundRunner 的系统 Java 安装,因为这些连接器仍然使用从 cacerts 文件中读取的自定义证书: