发布渠道
这些文档已经过时且不再更新,访问 zh-hans.react.dev 查看新的 React 文档。
查看 版本策略 了解 React 的发布渠道。
React 依靠强大的开源社区收集 bug 报告,发起 pull request 和 提交 RFC。为了鼓励大家反馈,我们打算共享一些特殊的 React 版本,其中包括未发布的功能。
此文章与从事框架,库或开发工具的开发人员息息相关。而主要使用 React 来构建应用程序的开发者无需担心此预发布渠道。
React 的每个发布渠道都是针对不同的用例进行设计的:
- 最新版本用于稳定的 semver React 版本。此版本可通过 npm 安装获取。此渠道为目前大家已经在用的方式。其主要用于所有面向用户的 React 应用程序。
- Next 版本主要用于追踪 React 源码仓库的 main 分支。我们会将其视为下一个次要版本发布的候选版本。使用它可以进行 React 与第三方项目间的集成测试。
- 实验阶段版本包含稳定版本中不提供的实验阶段的 API 与功能。同时它也追踪了 main 分支,但启用了附加新功能的标志。使用此渠道可以尝试即将发布的功能。
所有版本都将发布到 npm,但只有最新版本遵循语义版本控制。预发布版本(应用于 Next 和实验渠道的版本)会根据其内容的哈希值和提交日期生成版本号,例如,Next 的版本为 0.0.0-68053d940-20210623
,实验版则为 0.0.0-experimental-68053d940-20210623
。
最新版是面向用户应用程序的唯一官方支持发布渠道。提供 Next 和实验版本的目的是用于测试,我们并不保证功能在这两个版本中不发生变化。因为它们并不遵循用于最新版发布的 semver 协议。
将预发布版本发布到与稳定版本相同的注册表,我们可以利用许多支持 npm 工作流的工具,比如:unpkg 和 CodeSandbox。
最新版渠道
最新版是用于稳定 React 版本的渠道。它对应是 npm 中 latest
标签。此版本是所有交付给真实用户的 React 应用程序的推荐版本。
如果你不确定应该使用哪个版本,那就用最新版。如果你是 React 开发人员,那么这就是你正确的选择。
你可以认为最新版的更新是非常稳定的。版本遵循语义版本控制方案。在版本政策中了解更多关于我们对稳定性和增量迁移的承诺。
Next 渠道
Next 属于预发布渠道,用于追踪 React 仓库的 main 分支。我们使用在 Next 渠道的预发布版本作为最新版发布渠道的候选版本。你可以将 Next 视为最新版的超集,它的更新频率更高。
最近的 Next 版本和最近的最新版本之间的变化程度,与两个次要的 semver 版本之间的变化程度大致相同。但是,Next 渠道不遵循语义版本控制。在 Next 渠道中,你应该预期到后续的版本中偶尔会有不兼容的改动。
不要在面向用户的应用程序中使用预发布版本。
Next 渠道中的预发布版本在 npm 中携带 next
标签发布。版本号是根据其构建内容的哈希值和提交日期生成的,例如:0.0.0-68053d940-20210623
。
使用 Next 渠道进行集成测试
Next 渠道用于支持 React 与其他项目之间的集成测试。
React 的所有更改在发布之前都要经过大量的内部测试。然而,React 的整个生态系统使用了无数的环境和配置,我们不可能针对每一项进行测试。
如果你是 React 第三方框架,库,开发者工具或类似基础设施项目的作者,则可以通过定期针对最新版本运行的测试用例,帮助我们一起维持 React 稳定,为你的用户和整个 React 社区保驾护航。如果你对此有兴趣,请按照下列步骤进行操作:
- 在你喜欢的持续集成平台上设置 cron job。CircleCI 和 Travis CI 均支持 cron job。
-
在 cron job 中,使用 npm 的
next
标签将 React 版本更新至 Next 渠道中的最新版本。使用 npm cli:npm update react@next react-dom@next
或者 yarn:
yarn upgrade react@next react-dom@next
- 针对更新的 packages 运行你的测试用例。
- 如果均通过,那么恭喜你!你的项目可以与下个小版本的 React 一起使用。
- 如果发生意外中断,请通过提交 issues 告知我们。
Next.js 项目使用了这个工作流。你可以参考他们的 CircleCI 配置作为示例。
实验版渠道
与 Next 相似,实验版渠道是一个预发布渠道,用于追踪 React 仓库 main 分支。但不同于 Next 的是,实验版包含尚未准备好广泛推广的功能及 API。
通常,对 Next 更新时也会对实验版本进行更新。它们基于相同的源,但是构建时会使用不同的功能标记。
实验阶段发布的版本可能与 Next 和最新版本的发布均不相同。不要在面向用户的应用程序中使用实验版。 你应该能够想象到实验渠道中发布的版本会频繁进行破坏性的更新。
实验版本会在 npm 上会以 experimental
标签的形式发布。版本会根据构建内容的哈希值和提交日期生成,例如,0.0.0-experimental-68053d940-20210623
。
实验阶段发布包含哪些内容?
实验阶段的功能并未打算公开发布,在最终确定之前可能会发生重大变化。有些实验功能可能永远不会完成 —— 我们进行实验的目的是为了测试变更提案的可行性。
例如,如果我们在宣布发布 Hook 时,其已经在实验渠道中存在,我们会在最新版本发布 Hook 的前几周,将其发布到实验渠道中。
你可能会发现在实验阶段进行集成测试是很有必要的。但是,请注意,实验阶段版本的稳定性不如 Next 版本。我们并不保证实验版本之间的稳定性。
如何了解有关实验功能的更多信息?
实验性的功能可能会有文档,也可能不会有文档。通常,在实验渠道的内容发布到 Next 或 Latest 中之前,才会编写文档。
如果找不到文档,则可能会附有 RFC 说明。
当我们准备发布新的实验内容时,我们会发布到 React 博客中,但这并不意味着我们将公开发布每个实验的内容。
你可以参考 Github 公开仓库的历史记录以查看完整的变更列表。