跳到主要内容

ORM 发布和成熟度级别

本页介绍 Prisma ORM 的发布流程、版本控制方式以及如何处理发布过程中可能发生的重大变更。

发布​

Prisma ORM 的发布通常每三周进行一次。请注意，这不是硬性规定，发布可能会因内部原因而推迟。

在 GitHub 上查看所有发布说明.

产品成熟度级别​

一个版本可能包含处于不同成熟度级别的产品或功能。成熟度级别描述了产品或功能的完整性以及用户可以预期的重大变更。

注意：从 2.13.0 版本开始，“实验性”不再是产品成熟度等级的一部分。

早期访问​

如果一个功能或产品是 早期访问

  • 我们已经验证了一个问题，并正在考虑解决方案，但不确定该解决方案是否完整或完美契合。
  • 我们希望收集更多反馈并根据需要调整解决方案，我们知道用户已准备好迎接重大变更

我们不建议在生产环境中使用“早期访问”功能或产品。

预览​

如果一个功能或产品是 预览

  • 我们已经在方向和表面方面验证了该功能或产品。
  • 用户可以信赖该功能或产品以及相关的 API 大部分是稳定的，除非发布说明和文档中另有说明。
  • 没有重大的已知问题，但可能存在小的错误。
  • 我们欢迎对这些提出反馈，以尽快使解决方案稳定。

预览通常在功能标志后面提供，或者需要某种形式的选择加入（例如，通过在 CLI 中提供 --preview-feature 标志，或者对于 Prisma Client，将它们添加到 Prisma schema 的 generator 块中的 previewFeatures 属性）。

我们不建议在生产环境中使用“预览”功能或产品。

另请参阅： 所有当前可用的“预览”功能。

正式发布 (GA)​

如果一个功能或产品是 正式发布

  • 该解决方案已经过一段时间的测试，我们收到了足够的反馈，认为它稳定且可以用于生产环境。
  • 在 99% 的情况下应该没有错误（不能保证完全没有错误的软件）

版本控制​

Prisma ORM 的发布方案从 3.x.x 版本开始遵循语义版本控制 (SemVer)。

Prisma ORM 和语义版本控制 (SemVer)​

SemVer 版本控制如何工作？​

语义版本控制 (SemVer) 使用以下规则进行版本升级（引自 SemVer 规范）

给定版本号 MAJOR.MINOR.PATCH，递增

  1. MAJOR 版本，当你进行不兼容的 API 更改时，
  2. MINOR 版本，当你以向后兼容的方式添加功能时，以及
  3. PATCH 版本，当你进行向后兼容的错误修复时。

Prisma ORM 版本控制如何遵循 SemVer？​

从 3.x.x 版本开始，Prisma ORM 严格遵守 SemVer 版本控制方案。

以下是 Prisma ORM 如何遵循 SemVer 的简要概述

  • 稳定表面（即 正式发布）的重大变更只会在新 MAJOR 版本中引入。
  • 重大变更仍然可以在 MINOR 版本中推出，但仅适用于默认情况下未激活的选择加入的“预览”和“早期访问”功能（例如，通过“预览”功能标志或特定的选择加入选项或新的 CLI 命令）。
  • 在 MINOR 版本中发布的“选择加入”重大变更（即“预览”和“早期访问”）将仅在新 MAJOR 版本中晋升为“正式发布”（无需选择加入）。

给定版本号 MAJOR.MINOR.PATCH，Prisma ORM 的版本号按如下方式递增

  1. 当具有重大变更的重大产品更新发布到“正式发布”时，MAJOR 版本会递增。
  2. 当发布添加向后兼容新功能的产品更新时，MINOR 版本会递增。具有重大变更的功能可能仅在它们是“选择加入”的情况下引入，即“早期访问”和“预览”。
  3. 当功能性错误被修复并且始终向后兼容时，PATCH 版本会递增。

注意： 在 2.28.0 版本之前，Prisma ORM 并没有严格遵循 SemVer 版本控制。这意味着在 2.MINOR.PATCH 范围内的版本中，MINOR 版本可能包含重大变更。要了解有关 Prisma ORM 采用 SemVer 的更多信息，请查看博客文章。