1.5. 使用 code.quarkus.redhat.com 创建 Getting Started 项目

流程

1. 在您的 Web 浏览器中，前往 https://code.quarkus.redhat.com。

2. 从可用版本列表中，code.quarkus.redhat.com 应用程序默认选择红帽构建的 Quarkus 的最新版本。

   注意

   code.quarkus.redhat.com 应用程序使用最新版本的红帽构建的 Quarkus，这是首选的选项。但是，在生成项目后，您可以根据需要手动更改为 pom.xml 文件中的更早的 BOM 版本，但不建议这样做。

3. 指定项目的基本详情：

   
   1. 输入项目的组名称。名称格式遵循 Java 软件包命名约定；例如，org.acme。
   2. 输入项目生成的 Maven 工件的名称，如 code-with-quarkus。

   3. 选择您要用来编译和启动应用程序的构建工具。您选择的构建工具决定了以下设置：

      • 生成的项目的目录结构
      • 生成的项目中使用的配置文件的格式

      • 在生成项目后，用于编译和启动 code.quarkus.redhat.com 的应用程序的自定义构建脚本和命令

        注意

        红帽仅支持使用 code.quarkus.redhat.com 来创建 Quarkus Maven 项目。

4. 指定应用程序项目的更多详情：

   1. 要显示包含更多应用程序详情的字段，请选择 More options。

      
   2. 输入您要用于项目生成的工件的版本。此字段的默认值为 1.0.0-SNAPSHOT。首选使用 语义版本，但您可以选择指定不同类型的版本。
   3. 选择是否希望 code.quarkus.redhat.com 将入门代码添加到项目中。将标记为"STARTER-CODE"的扩展添加到项目中时，您可以启用此选项，以便在生成项目时自动为这些扩展创建示例类和资源文件。但是，如果您没有添加提供示例代码的任何扩展，这个选项不会影响生成的项目。
   注意

   code.quarkus.redhat.com 应用程序自动使用最新版本的红帽构建的 Quarkus。但是，如果您需要，可以在生成项目后手动更改为 pom.xml 文件中的较早 BOM 版本，但不建议这样做。

5. 选择要使用的扩展。Quarkus 应用程序包含您选择的扩展作为依赖项。Quarkus 平台还确保这些扩展与将来的版本兼容。

   重要

   不要在同一项目中使用 quarkus-rest 和 quarkus-resteasy 扩展。两者都提供相似的功能，但它们的运作方式有所不同。使用 quarkus-rest 是首选的。

   扩展旁边的 quark 图标( )表示扩展是红帽构建的 Quarkus 平台版本的一部分。红帽更喜欢使用来自同一平台的扩展，因为它们经过测试和验证，因此更易于使用和升级。

   对于使用"STARTER-CODE"标记的扩展，您可以启用 选项自动生成初学者代码。

   

6. 要确认您的选择，请选择 Generate your application。出现的对话框显示以下项目：

   • 下载包含您生成的项目的存档的链接
   • 您可以使用该命令编译和启动应用程序
7. 要使用生成的项目文件将存档保存到机器中，请选择 Download the ZIP。
8. 提取存档的内容。

验证

1. 以 dev 模式编译和启动应用程序。如需更多信息，请参阅 编译和启动 Red Hat build of Quarkus Getting Started 项目。
2. 从 Quarkus CLI 软件包并运行 Getting Started 项目。如需更多信息，请参阅打包并运行红帽构建的 Quarkus 入门应用程序。