Flutter 兼容性策略

Flutter 团队试图在 API 稳定性的需求与不断发展 API 以修复错误、改进 API 人体工程学以及以连贯的方式提供新功能的需求之间取得平衡。

为此，我们创建了一个测试注册表，您可以在其中提供您自己的应用程序或库的单元测试，我们在每次更改时都会运行这些测试，以帮助我们跟踪可能破坏现有应用程序的更改。我们的承诺是，我们不会进行任何破坏这些测试的更改，除非与这些测试的开发者合作：（a）确定更改是否足够有价值，以及（b）为代码提供修复，以便测试继续通过。

如果您想将测试作为此程序的一部分提供，请向flutter/tests 存储库提交 PR。该自述文件详细描述了该过程。

如果我们确实进行了重大更改（定义为导致一个或多个提交的测试需要更改的更改），我们将在我们的flutter-announce邮件列表以及我们的发行说明中宣布此更改。

我们提供受重大更改影响的代码迁移指南列表。

我们有时会弃用某些 API，而不是在一夜之间完全破坏它们。这独立于我们的兼容性策略，该策略完全基于提交的测试是否失败，如上所述。

Flutter 团队不会按计划删除弃用的 API。如果团队删除了弃用的 API，则它遵循与重大更改相同的程序。

Dart 语言本身有一个单独的重大更改策略，并在Dart 公告中发布公告。

通常，Flutter 团队目前没有关于其他依赖项的重大更改的任何承诺。例如，使用新版 Skia（某些平台上 Flutter 使用的图形引擎）或 Harfbuzz（Flutter 使用的字体整形引擎）的新版 Flutter 可能会发生影响贡献测试的更改。此类更改不一定附带迁移指南。

除非另有说明，否则本网站上的文档反映了 Flutter 的最新稳定版本。页面最后更新于 2024-07-06。 查看源代码 或 报告问题.