Skip to content

兼容性策略 ​

Flet 努力在 API 稳定性与持续改进框架之间取得平衡——在 Flet 1.0 之前和之后都要修复 bug、简化 API。

破坏性变更 ​

破坏性变更是指:当你升级 Flet 时,可能需要更新应用代码、配置、依赖或构建设置。

例如:

  • 移除某个公开 API;
  • 改变默认行为,且会影响已有的应用;
  • 改变事件载荷或方法的返回值;
  • 改变最低支持的 Python、Flutter、平台或依赖版本;
  • 改变构建、打包或发布的必要条件。

当某项破坏性变更需要迁移指导时,应列在破坏性变更与废弃中,并在发布说明里给出链接。

废弃策略 ​

在条件允许时,Flet 会先废弃某个 API,再将其移除。被废弃的 API 在废弃期内仍然可用,在支持的地方会发出运行时警告,并在 API 文档中以废弃标签标注。

默认情况下,被废弃的 API 会在三个次版本之后被移除。例如,在 0.85.0 中被废弃的 API,通常计划在 0.88.0 中移除。

也有一些例外:当某个废弃需要更长的迁移时间,或兼容性会阻碍一项重要修复时。任何例外都应在相关的发布说明或迁移指南中明确指出。

变更记录在何处 ​

  • 发布说明列出每个版本,并链接到发布公告、变更日志和迁移指南。
  • 破坏性变更与废弃按版本分组,解释需要迁移的变更。
  • API 参考页面在受影响的 API 旁边展示废弃详情。

关注我,学习大模型、大数据、Python等热门技术。