第 5 章 使用 code.quarkus.redhat.com 创建 Quarkus Maven 项目

流程

1. 使用 Web 浏览器导航至 https://code.quarkus.redhat.com

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

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

   3. 选择您要用于编译和启动应用程序的构建工具。您选择的构建工具：

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

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

        注意

        红帽只支持使用 code.quarkus.redhat.com 创建 Quarkus Maven 项目。红帽不支持生成 Gradle 项目。

        

        View larger image

        

3. 指定应用程序项目的其他详情：

   1. 选择 Configure more options 以显示包含更多应用程序详情的字段。
   2. 输入项目生成的工件中使用的版本。此字段的默认值为 15000 SNAPSHOT。建议使用 语义版本，但如果您愿意，可以使用不同类型的版本。

   3. 选择是否想将 code.quarkus.redhat.com 添加示例代码到项目中。当您从扩展列表中添加带有 图标标记的扩展时，您可以在生成项目时启用这个选项为这些扩展自动创建示例类文件和资源文件。当您没有添加提供示例代码的任何扩展时，这个选项不会影响您生成的项目。

      

      View larger image

      
      注意

      code.quarkus.redhat.com 自动使用 Quarkus 的最新发行版本。您可以在生成项目后手动更改 pom.xml 文件中的 BOM 版本。

4. 从扩展列表中选择您要在应用程序中使用的扩展。所选扩展作为 Quarkus 应用程序的依赖项包括，其版本由 Quarkus 平台管理，以确保其兼容性。

   您可以启用选项，为使用 图标标记的扩展自动生成示例代码。

   

   请注意，红帽为列表上的单个扩展提供了不同级别的支持，这由每个扩展名称旁的标签指定： https://access.redhat.com/articles/3348731

   • 红帽完全支持 SUPPORTED 扩展用于生产环境中的企业应用程序。
   • TECH-PREVIEW 扩展受红帽在生产环境中的支持，在 技术预览功能支持范围 下受到红帽的支持。
   • 红帽在生产环境中不支持 DEV-SUPPORT 扩展，但红帽提供的核心功能则由红帽开发人员用于开发新的应用程序。
   • 红帽不支持在生产环境中使用的未标记扩展。

   • DEPRECATED 扩展计划由提供相同功能的较新的技术或实现替代。

     您可以扩展每个扩展旁的 overflow 菜单( '{}')来访问可用于的额外选项：

     • 在命令行中使用 Quarkus maven 插件，为现有项目添加扩展。
     • 复制 XML 代码片段，将扩展添加到项目的 pom.xml 文件中。
     • 获取每个扩展的 groupId、artifactId 和版本。

     • 打开扩展指南。

       

5. 选择 Generate your application 确认您的选择并显示覆盖屏幕，其中包含包含您生成的项目的存档的下载链接。overlay 屏幕还显示可用于编译和启动应用程序的自定义命令。
6. 选择 Download the ZIP，以使用生成的项目文件将存档保存到您的计算机中。
7. 提取存档的内容。

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

   cd <directory_name>

   Copy to Clipboard Toggle word wrap

9. 以开发模式编译并启动应用程序：

   ./mvnw compile quarkus:dev

   Copy to Clipboard Toggle word wrap