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

流程

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

2. 从可用版本列表中，选择您需要的 Red Hat build of Quarkus 版本。

   注意

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

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

   

   View larger image

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

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

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

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

        注意

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

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

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

      

      View larger image

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

   image::additional-app-details-project-generator.png["Screenshot of the application details 部分的 code.quarkus.redhat.com 站点，显示带有额外应用程序详情"] 的扩展表单

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

   重要

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

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

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

   

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

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

9. 进入包含提取的项目文件的目录：

   cd <directory_name>

   Copy to Clipboard Toggle word wrap

10. 使用以下方法之一以 dev 模式编译和启动应用程序：

    • 使用 Maven：

      ./mvnw quarkus:dev

      Copy to Clipboard Toggle word wrap

    • 使用 Quarkus CLI：

      quarkus dev

      Copy to Clipboard Toggle word wrap