1.10. 配置红帽构建的 Quarkus 项目输出
在构建应用程序前,您可以通过更改 application.properties 文件中的属性的默认值来控制构建命令输出。
先决条件
- 您已创建了 Quarkus Maven 项目。
流程
-
进入
{project}/src/main/resources文件夹,并在文本编辑器中打开application.properties文件。 添加您要更改的属性并保存文件。
Expand 表 1.1. 您可以更改的属性 属性 描述 类型 default quarkus.native.enabled启用原生镜像生成。当设置为
true时,应用程序将编译到原生可执行文件中。布尔值
falsequarkus.native.sources-only仅生成原生镜像源,而不构建最终的原生可执行文件。
布尔值
falsequarkus.package.main-class指定应用程序的入口点。在大多数情况下,您必须更改这个值。
string
io.quarkus.runner.GeneratedMainquarkus.package.jar.enabled决定是否构建 JAR 文件。设置为
false以防止创建 JAR。布尔值
truequarkus.package.jar.type定义要构建的 JAR 类型。支持的值有
fast-jar(默认)、uber-jar、mutable-jar和legacy-jar(已弃用)。要防止 JAR 生成,请设置quarkus.package.jar.enabled=false。string
fast-jarquarkus.package.type(已弃用)已弃用。* 使用
quarkus.package.jar.type来配置 JAR 类型。* 对于原生构建,将quarkus.native.enabled设置为true。* 对于原生源构建,也将quarkus.native.sources-only设置为true。* JAR 构建可以通过将quarkus.package.jar.enabled设置为false来禁用。string
jarquarkus.package.jar.manifest.add-implementation-entries确定运行程序 JAR 文件的
MANIFEST.MF中是否包含实施信息。布尔值
truequarkus.package.jar.user-configured-ignored-entries指定不能复制到输出工件中的文件列表。
字符串(列表)
(无)
quarkus.package.runner-suffix指定应用到 runner JAR 文件的后缀。
string
-runnerquarkus.package.output-directory指定应用程序构建的输出文件夹。该路径相对于构建系统目标目录解析。
string
(无)
quarkus.package.output-name指定最终构建工件的名称。
string
(无)
示例:配置应用程序输出名称
您可以通过在 application.properties 文件中配置 quarkus.package.output-name 属性来自定义应用程序输出的名称。
-
打开
src/main/resources/application.properties文件。 添加以下属性:
quarkus.package.output-name=my-quarkus-custom-app-name
quarkus.package.output-name=my-quarkus-custom-app-nameCopy to Clipboard Copied! Toggle word wrap Toggle overflow 构建应用程序:
./mvnw clean package
./mvnw clean packageCopy to Clipboard Copied! Toggle word wrap Toggle overflow 验证生成的应用程序 JAR 文件是否命名为:
my-quarkus-custom-app-name.jar
my-quarkus-custom-app-name.jarCopy to Clipboard Copied! Toggle word wrap Toggle overflow
自定义输出名称有助于将您的构建工件与项目约定或部署要求保持一致。