跳转到内容

Material-UI 的不同版本

你可以随时回到本页来切换你在查阅的不同版本的文档。

Released versions

The most recent stable version (✓) is recommended for use in production.

最新的版本

在这里您可以找到最新的尚未发布的文档和代码。 您可以使用它来查看即将实施的更新 , 并给 Material-UI 的贡献者提供更好的反馈。

版本控制方案

稳定的版本保证了可重复使用的组件和库、教程、工具和学习教程不会意外的过时。 稳定性是 Material-UI 生态系统蓬勃发展的关键。

本文档包含了为您提供的一些前沿的 UI 库所遵循的练习, 在保持稳定的同时确保今后的变更总是以可预测的方式引进。

Material-UI 遵循Semantic Versioning 2.0.0。 Material-UI 的版本号由三部分组成: major.minor.patch。 版本号的递增是根据发行的更改级别而定义的。

  • 主版本包含重要的新功能,更新时需要一些少量开发人员的支持。 当更新到一个新的主要的发行版本时,您可能需要运行更新脚本,重构代码,运行其他测试以及学习新的 API。
  • 次版本 包含重要的新功能。 次要发行版本完全向后兼容;更新时不需要开发人员的支持,但您可以选择修改应用程序和库来使用新的版本中添加的新 API ,特征和功能。
  • 修订版本 的更新风险低,包含了对 bug 的修复和较小的新功能。 更新时不需要开发人员的支持。

发布周期

一个定期的发布周期可以帮助您规划和适应 Material-UI 不断的演变。

通常情况下,你可以预期以下的发布周期:

  • 每12个月发布一个主版本
  • 每个主版本会包含 1-3 个次版本
  • 每周发布修订版本(随时都会对紧急错误的修复发布更新)。

发布时间表

日期 版本 状态
2018 年 5 月 v1.0.0 已发布
2018 年 9 月 v3.0.0 已发布
2019 年 5 月 v4.0.0 已发布
2021 年第一季度 v5.0.beta.0 Work in progress
September 1st, 2021 v5.0.0

查看 里程碑 可以得到一个更详细的总览。

⚠️免责声明 :我们在动态的环境中运作,情况随时可能发生变化。 提供的信息旨在概述总体框架方向, 仅供参考。 我们可能会根据我们的交付能力来随时决定增加或删除新的项目来确保我们的质量标准。 Material-UI 任何功能的开发,发布和时间安排均由 Material-UI 全权决定。 路线图不代表在任何时间交付的承诺和义务。

政策支持

您可以查看 所支持版本 的详细信息。

弃用的实践

“破坏性变更”有时是必要的,例如取消对某些 API 和功能的支持。

为了尽可能轻松地实现这些过渡:

  • 我们会尽量将破坏性的改变降到最低,并且尽可能提供一些辅助迁移的工具。
  • 请您遵循以下描述的弃用政策,这样就有时间将您的应用程序更新到最新版本的 API 和最佳的实践。

弃用政策

  • 我们会尽量在更新日志中公布过时的功能,并尽可能在运行时发出警告。
  • 当宣布一个弃用方案时,我们也会推荐一些更新的路径。
  • 在弃用期间我们仍支持已有的稳定 API,所以您的代码将在此期间可以正常运行。
  • 而对于那些需要更新您的应用程序的同版本依赖(React),只会在主版本发布时介绍。