返回指南
编辑此页面

将项目更新到最新 Quarkus 版本

您可以使用更新命令将 Quarkus 项目更新或升级到最新的 Quarkus 版本。

更新命令主要使用 OpenRewrite 配方来自动更新大多数项目依赖项、源代码和文档。 虽然这些配方更新了许多迁移项，但它们并未涵盖 迁移指南 中详述的所有项。

更新后，如果缺少预期的更新，请考虑以下原因

  • 该配方可能不包括您项目中的特定项。

  • 您的项目可能使用了与最新 Quarkus 版本不兼容的扩展。

  • 如果您有 Gradle Kotlin 构建文件 (.kts)，则在 OpenRewrite 支持这些文件之前，Quarkus 更新 将失败。

对于使用 Hibernate ORM 或 Hibernate Reactive 的项目，请查看 Hibernate ORM 5 到 6 迁移 快速参考。 以下更新命令仅涵盖本指南的一部分。

先决条件

要完成本指南，您需要

  • 大约 30 分钟

  • 一个 IDE

  • 已安装 JDK 17+ 并正确配置了 JAVA_HOME

  • Apache Maven 3.9.9

  • 如果您想使用它，可以选择 Quarkus CLI

  • 如果您想构建本机可执行文件（或者如果您使用本机容器构建，则为 Docker），可以选择安装 Mandrel 或 GraalVM 并进行适当的配置

  • 一个基于 Quarkus 2.13 或更高版本的项目。

步骤

  1. 使用您的版本控制系统为您的项目创建一个工作分支。

  2. 要在下一步中使用 Quarkus CLI，请安装最新版本的 Quarkus CLI。 使用 quarkus -v 确认版本号。

  3. 转到项目目录并将项目更新到最新流

    使用 Quarkus CLI
    quarkus update

    可选：要指定特定的流，请使用 --stream 选项；例如：--stream=3.2

    使用 Maven
    ./mvnw io.quarkus.platform:quarkus-maven-plugin:3.24.4:update -N

    可选：要指定特定的流，请使用 -Dstream 选项；例如：-Dstream=3.2

  4. 分析更新命令的输出以获取潜在的说明，并在必要时执行建议的任务。

  5. 使用差异工具检查所有更改。

  6. 查看 迁移指南，了解更新命令未更新的项目。 如果您的项目有此类项目，请实施这些主题中建议的附加步骤。

  7. 确保项目构建没有错误，所有测试都通过，并且应用程序在部署到生产环境之前按要求运行。

相关内容

关于相同主题

Quarkus 是开放的。 本项目的所有依赖项均可根据 Apache Software License 2.0 或兼容许可获得。 CC by 3.0

本网站使用 Jekyll 构建，托管在 GitHub Pages 上，并且是完全开源的。 如果您想让它变得更好，fork 该网站 并向我们展示您的成果。

导航
关注我们
获取帮助
语言
Quarkus 由社区项目组成
Copyright © Quarkus. 保留所有权利。 有关我们商标的详细信息，请访问我们的 商标政策 和 商标列表。 第三方的商标归其各自所有者所有，此处提及并不暗示任何认可或关联。