跳转到主要内容

ORM 发布和成熟度级别

本页解释了 Prisma ORM 的发布过程、版本控制方式以及如何处理整个发布过程中可能发生的重大更改。

发布​

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

查看 GitHub 上的所有发行说明.

产品成熟度级别​

一个版本可能包含不同成熟度级别的产品或功能。成熟度级别描述了产品或功能的完整性，以及用户可以期望在重大更改方面的表现。

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

抢先体验​

如果功能或产品是抢先体验

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

我们不建议在生产中使用抢先体验功能或产品。

预览​

如果功能或产品是预览版

  • 我们已经在方向和表面方面验证了功能或产品。
  • 除非在发行说明和文档中另有说明，否则用户可以依靠该功能或产品以及相关的 API 保持基本稳定。
  • 虽然可能存在小错误，但没有明显的已知问题。
  • 我们欢迎对此进行反馈，以便尽快使解决方案稳定。

预览版通常在功能标志后面可用，或者需要某种形式的选择加入（例如，通过在 CLI 中提供 --preview-feature 标志，或者将其添加到 Prisma 模式中 Prisma 客户端的 generator 块中的 previewFeatures 属性）。

我们不建议在生产中使用预览版功能或产品。

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

正式发布 (GA)​

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

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

版本控制​

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

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

SemVer 版本控制如何工作？​

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

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

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

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

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

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

  • 稳定表面（即正式发布）中的重大更改只会出现在新的 MAJOR 版本中。
  • 重大更改仍然可以在 MINOR 中推出，但仅适用于默认情况下不活动的选择加入的预览版和抢先体验功能（例如，通过预览功能标志或特定的选择加入选项或新的 CLI 命令）。
  • 在 MINOR 中发布的 opt-in 重大更改（即预览版和抢先体验版）只会在新 MAJOR 版本中提升为正式发布（无需选择加入）。

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

  1. 当带有重大更改的主要产品更新发布到正式发布时，MAJOR 版本会递增。
  2. 当发布添加向后兼容的新功能的产品更新时，MINOR 版本会递增。具有重大更改的功能只能在 opt-in 时引入，即抢先体验和预览版。
  3. 当功能错误得到修复时，PATCH 版本会递增，并且始终是向后兼容的。

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