第 3 章 在命令行中创建 Quarkus 项目


您可以在命令行中使用 Quarkus Maven 插件来创建 Quarkus 项目,方法是在命令行中提供属性和值,也可以在交互模式中使用插件来创建 Quarkus 项目。生成的项目将包含以下元素:

  • Maven 结构
  • 关联的单元测试
  • 在启动应用程序后,一个可在 http://localhost:8080 上访问的登录页面
  • src/main/docker中的 JVM 和原生模式的 Dockerfile 文件示例
  • 应用程序配置文件

流程

  1. 在命令终端中,输入以下命令验证 Maven 是否使用 JDK 11,并且 Maven 版本为 3.6.2 或更高版本:

    mvn --version
    Copy to Clipboard Toggle word wrap
  2. 如果前面的命令没有返回 JDK 11,请将到 JDK 11 的路径添加到 PATH 环境变量,然后再次输入前面的命令。
  3. 要使用 Quarkus Maven 插件创建新项目,请使用以下方法之一:

    • 使用以下命令:

      mvn io.quarkus:quarkus-maven-plugin:1.11.7.Final-redhat-00009:create \
          -DprojectGroupId=<project_group_id> \
          -DprojectArtifactId=<project_artifact_id> \
          -DplatformGroupId=com.redhat.quarkus \
          -DplatformArtifactId=quarkus-universe-bom \
          -DplatformVersion=1.11.7.Final-redhat-00009 \
          -DclassName="<classname>"
      Copy to Clipboard Toggle word wrap

      在这个命令中,替换以下值:

      • <project_group_id > : 项目的唯一标识符
      • <project_artifact_id > : 项目和项目目录的名称
      • < classname> :生成的资源的完全限定名称,如 org.acme.quarkus.sample.HelloResource
    • 以互动模式创建项目:

      mvn io.quarkus:quarkus-maven-plugin:1.11.7.Final-redhat-00009:create
      Copy to Clipboard Toggle word wrap

      提示时,输入 required 属性值。

      注意

      另外,您可以通过输入以下命令来使用项目属性的默认值创建项目:

      mvn io.quarkus:quarkus-maven-plugin:1.11.7.Final-redhat-00009:create -B

      下表列出了您可以使用 create 命令定义的属性:

      Expand
      属性默认值描述

      projectGroupId

      org.acme.sample

      项目的唯一标识符。

      projectArtifactId

      none

      您的项目和项目目录的名称。如果您没有指定 projectArtifactId,则 Maven 插件将启动交互式模式。如果目录已存在,生成会失败。

      projectVersion

      1.0-SNAPSHOT

      项目的版本。

      platformGroupId

      io.quarkus

      您的平台的组群 ID。所有现有的平台均由 io.quarkus 提供。但是,您可以更改默认值。

      platformArtifactId

      Quarkus-universe-bom

      平台 BOM 的工件 ID。要使用本地构建的 Quarkus 将 quarkus-universe-bom 添加到 pom.xml 文件中。

      platformVersion

      最新平台版本

      要用于项目的平台版本。您可以提供一个版本范围,并且 Maven 插件使用最新版本。

      className

      生成的资源的完全限定名称。创建应用程序后,REST 端点通过以下 URL 公开:

      http://localhost:8080/$path

      如果您使用默认 路径,则 URL 为 http://localhost:8080/hello

      path

      /hello

      只有设置了 className 时,资源路径。

      extensions

      []

      要添加到项目( comma)中的扩展列表。

注意

默认情况下,Quarkus Maven 插件使用最新的 quarkus-universe-bom 文件。此 BOM 聚合扩展,以便您可以将应用程序中引用它们,以对齐依赖项版本。如果您离线,Quarkus Maven 插件使用 quarkus-universe-bom 的最新本地可用版本。如果 Maven 找到 quarkus-universe-bom 版本 2.0 或更早版本,则会使用基于 quarkus-universe-bom 的平台。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat