1.5. 使用 code.quarkus.redhat.com 创建 Getting Started 项目
作为应用程序开发人员,您可以使用 code.quarkus.redhat.com 生成 Quarkus Maven 项目,并自动添加并配置要在应用程序中使用的扩展。另外,code.quarkus.redhat.com 会自动管理将项目编译为原生可执行文件所需的配置参数。
您可以生成 Quarkus Maven 项目,包括以下活动:
- 指定应用程序的基本详情
- 选择您要包含在项目中的扩展
- 使用项目文件生成可下载归档
- 使用自定义命令编译和启动应用程序
先决条件
- 您有一个 Web 浏览器。
- 您已准备了环境以使用 Apache Maven。如需更多信息,请参阅准备您的环境。
- 您已配置了 Quarkus Maven 存储库。要使用 Maven 创建 Quarkus 应用程序,请使用 Red Hat-hosted Quarkus 存储库。如需更多信息,请参阅为在线存储库配置 Maven settings.xml 文件。
可选 : 已安装 Quarkus 命令行界面(CLI),这是您可以在 dev 模式中启动 Quarkus 的方法之一。
如需更多信息 ,请参阅安装 Quarkus CLI。
Quarkus CLI 仅用于 dev 模式。红帽不支持在生产环境中使用 Quarkus CLI。
流程
- 在您的 Web 浏览器中,访问 https://code.quarkus.redhat.com。
指定项目的基本详情:
-
输入项目的组名称。name 格式遵循 Java 软件包命名规则,例如
org.acme
。 -
输入项目生成的 Maven 工件的名称,如
code-with-quarkus
。 选择您要用来编译和启动应用程序的构建工具。您选择的构建工具决定了以下设置:
- 生成的项目的目录结构
- 您生成的项目中使用的配置文件格式
在生成项目后,会显示用于编译和启动 code.quarkus.redhat.com 的自定义构建脚本和命令。
注意红帽仅支持使用 code.quarkus.redhat.com 创建 Quarkus Maven 项目。
-
输入项目的组名称。name 格式遵循 Java 软件包命名规则,例如
指定应用程序项目的更多详情:
- 要显示包含更多应用程序详情的字段,请选择 More options。
-
输入您要用于项目生成的工件的版本。此字段的默认值为
1.0.0-SNAPSHOT
。使用 语义版本 是首选的;但是,您可以选择指定不同类型的版本控制。 选择是否希望 code.quarkus.redhat.com 将初学者代码添加到项目中。当您添加标记为 "STARTER-CODE" 的扩展时,您可以启用此选项在生成项目时自动为这些扩展创建示例类和资源文件。但是,如果您没有添加提供示例代码的任何扩展,这个选项不会影响生成的项目。
注意code.quarkus.redhat.com 应用程序自动使用最新版本的 Red Hat build of Quarkus。但是,如果需要,可以在生成项目后手动更改为
pom.xml
文件中的较早 BOM 版本,但不建议这样做。选择要使用的扩展。Quarkus 应用程序包含您选择为依赖项的扩展。Quarkus 平台还确保这些扩展与将来的版本兼容。
重要不要在同一项目中使用
RESTEasy
和 RESTEasy扩展旁边的 quark 图标( )表示扩展是 Red Hat build of Quarkus 平台发行版本的一部分。红帽更喜欢使用同一平台中的扩展,因为它们被一起测试和验证,因此更易于使用和升级。
您可以启用选项,为标记为"STARTER-CODE"的扩展自动生成初学程序代码。
要确认您的选择,请选择 Generate your application。显示的对话框显示以下项目:
- 下载包含您生成的项目的存档的链接
- 可用于编译和启动应用程序的命令
- 要将带有生成的项目文件的存档保存到机器中,请选择 Download the ZIP。
- 提取存档的内容。
进入包含您提取的项目文件的目录:
cd <directory_name>
要在 dev 模式中编译并启动应用程序,请使用以下方法之一:
使用 Maven:
./mvnw quarkus:dev
使用 Quarkus CLI:
quarkus dev