Skip to content

docs(migration): 校正 0.2.7 到 1.0 迁移说明并补充发布核对 - #1169

Merged
RSS1102 merged 7 commits into
developfrom
chore/release-readiness-closeout
Oct 15, 2026
Merged

RSS1102 merged 7 commits into
developfrom
chore/release-readiness-closeout

Conversation

@RSS1102

@RSS1102 RSS1102 commented Oct 15, 2026 •

Copy link
Copy Markdown
Collaborator

🤔 这个 PR 的性质是?

勾选规则:
1.只要有新增参数,就勾选”新特性提交“
2.只修改内部bug,未新增参数,才勾选”日常 bug 修复“
3.其他选项视具体改动判断

  • 日常 bug 修复
  • 新特性提交
  • 文档改进
  • 演示代码改进
  • 组件样式/交互改进
  • CI/CD 改进
  • 重构
  • 代码风格优化
  • 测试用例
  • 分支合并
  • 其他

🔗 相关 Issue

无关联 Issue。承接已关闭的历史准备 PR #1163;正式版本升级独立于 #1170。

💡 需求背景和解决方案

从0.2.7升级时,原迁移附录存在名称错配和漏项,组件条目也有仅要求“核对当前API”的泛化提示。本PR对照真实0.2.7发布包与1.0候选公开入口补核文档,修正会误导迁移的说明,并保留最终发布尚需确认的事项。维护者已确认本轮文档工作可交付,后续发布验收单独跟踪。

最终改动:

  • 旧包与0.2.7标签的159个lib文件逐字节一致。补出原383项盘点遗漏的3个Slider mixin和2个文字全局开关,指南覆盖388个旧自有名称,分别提供明确处置及组件定位。
  • 为57个组件增加现有条目的稳定锚点与具体参数/职责迁移,复用原有分组和同一份指南,不添加搜索功能或57份重复文档。
  • 修正BadgeConfig、MessageMarquee、TDImageDialog、TDTimeCounterStyle、TDLinkType等错误映射;补充枚举变化、删除能力边界及3个无同名新常量的旧图标。
  • 补充7个最小迁移用法到共享fixture,指南和包内MIGRATION从源同步。没有修改组件lib生产源码、版本号、CI、回归测试文件或Golden。
  • 对照候选历史200个来源PR,补充18条发布说明候选、去重与修正分组;候选稿附于chore(release): release v1.0.0 #1170,不手工改自动CHANGELOG。4项旧行为/视觉修复保留最终裁定。
  • 保留此前历史Spec取代说明和发布待办整理;一次性核对工具与冻结证据放在Spec076,不作为第二份用户迁移正文或新增CI入口。

Spec076完整核对报告逐项说明核对方法、实际结果和证明范围;发布待办仍由Spec074/PUBLISH.md索引。

本轮验证:

  • 388条旧名称和57个组件的路由、锚点及目标检查通过,当前369个自有公开声明API审计0问题;候选lib/生成API与本PR一致。
  • 重新生成检查57份API文档一致,370份Demo片段严格分析通过。
  • Flutter3.32.0/3.47.7:迁移外部宿主严格分析与各21项既有交互测试通过;新增7个用法完成编译分析,没有把它们冒算成7组新增交互测试。
  • 文档契约26项、主题桥接6项、同步检查6份文档、站点生产构建通过。保留既有大chunk警告,未放宽门禁。

交付状态:本轮文档核对已由维护者确认可交付,进入合并审核。 后续发布验收统一记录于发布清单,不阻塞本轮文档交付,也不表示全部业务迁移或1.0发布已验收。 浏览器自动启动受环境限制,折叠深链接/桌面与375px/键盘实际体验尚待验证;4项历史修复的最终日志表述仍待裁定。本次文档修复需先合入,再同步#1170并冻结最终head核对产物。当前声明级完整定位不证明所有继承成员、旧成员调用、业务能力或像素都运行通过。最终合并检查以新head实际CI为准。

📝 更新日志

  • docs(migration): 校正0.2.7到1.0的图片弹窗、计时样式、枚举与图标迁移说明,补齐旧公开名称及对应组件改法。

  • 本条 PR 不需要纳入 Changelog

☑️ 请求合并前的自查清单

⚠️ 请自检并全部勾选全部选项。⚠️

  • 标题遵循 Conventional Commits 格式:type(<scope>?): 修改描述。
    示例:fix(TBottomTabBar): 修复 iconText 模式底部溢出
  • “相关 Issue”处带上修复的 Issue 链接或无关联 Issue
  • 已添加对应的 Spec 链接,或已由 Review 确认本次改动无需 Spec
  • 相关文档已补充或无须补充

@RSS1102 RSS1102 changed the title docs(release): 收敛过时方案与 1.0 发布验收入口 docs(release): 整理历史迁移方案与 1.0 发布待办 Oct 15, 2026
@github-actions

github-actions Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

完成

Web Demo

APK 下载

@RSS1102 RSS1102 changed the title docs(release): 整理历史迁移方案与 1.0 发布待办 docs(migration): 校正 0.2.7 到 1.0 迁移说明并补充发布核对 Oct 15, 2026
@RSS1102
RSS1102 merged commit 2c5213b into develop Oct 15, 2026
18 checks passed
@RSS1102
RSS1102 deleted the chore/release-readiness-closeout branch October 15, 2026 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant