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。 版本号的递增是根据发行的更改级别而定义的。

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

发布周期

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

通常情况下，你可以预期以下的发布周期：

• 每12个月发布一个主版本。
• 每个主版本会包含 1 - 3 个次要版本。
• 每周发布修订版本更新（会随时发布用于紧急的 bugfix）。

发布时间表

日期	版本	状态
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 自行决定。 指导方针不代表我们在任何时间交付的承诺，义务或者保证。

政策支持

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

弃用的实践

有时候，一些“破坏性的改变”是必要的，例如删除对 select API 和功能的支持。

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

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

弃用政策

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