Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions PUBLISH.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

## 1.0 发布前准备

本轮状态、剩余项和关闭条件统一记录在 [发布候选收口记录](./specs/074-release-readiness-closeout/readiness.md)。先按该记录处理缺口,再在独立 `release/1.0.0` PR 升级版本并冻结候选;版本 PR 的建立不表示已经放行。

1. 固定发布候选提交,记录完整 SHA、目标版本及 Flutter/Dart 版本;统一组件 pubspec、示例 pubspec 与 example/assets/version 的版本展示及构建号。本轮准备不等于已经发布 1.0。
2. 从 `0.2.7` 升级的说明统一维护在 [迁移指南](./tdesign-site/site/docs/migration-0.2.7-to-1.0.md)。执行 `node scripts/sync-readme.mjs` 更新指南内可运行片段并同步包内副本,随后用 `--check` 确认;站点直接读取源文件,不直接改包内副本。
3. 在 Flutter 3.32.0 和当前 stable 的隔离环境解析依赖并执行严格分析、Upload 回归、独立迁移消费测试;记录图片选择器及平台实现包的实际版本。最低版本、正常升级、业务同时依赖较新图片选择器三个场景分别留证。
Expand Down
2 changes: 2 additions & 0 deletions specs/058-release-preparation/acceptance.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> 后续补核:本阶段383项盘点漏了3个公开mixin和2个文字顶层变量;当前指南按388项补齐,见[Spec076](../076-migration-release-documentation-audit/acceptance.md)。本文件及原JSON保留原阶段证据,不作为当前完整导出清单。

> 文档路径和维护来源已由[Spec062](../062-documentation-source-consolidation/spec.md)调整;下文保留本阶段历史记录,未完成迁移内容和验收仍以原清单为准。

> 最新处置(2026-10-15,Spec060):已实修Ghost语义回退的2个观察项,8项由既有Flutter契约及运行断言支持;21项差异与1项平台几何已有具体方案,524项仍待补运行。当前代码为30767a55上的未提交工作区,本地新指纹验证见 [Spec060](../060-token-difference-resolution/acceptance.md),不沿用旧远端CI作为本次修复通过证据。
Expand Down
2 changes: 2 additions & 0 deletions specs/058-release-preparation/pr-validation.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> 历史提交验收,仅适用于下列基线;后续合并、迁移方案调整和当前发布缺口见 [发布收口记录](../074-release-readiness-closeout/readiness.md)。不要把此处旧路径、旧任务和旧测试数量当作当前状态。

# PR 提交前复核

日期:2026-10-15。提交基线:30767a5521e871b1738040f854adf001e50e4774,与本次获取的 origin/develop 一致。
Expand Down
4 changes: 3 additions & 1 deletion specs/058-release-preparation/release-notes-draft.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,10 @@

最终候选的真实设备、设计对照和残余 Review 记录尚需核销;本轮排除的 CI/发布流程问题仍另行跟进。正式 pub.dev 包、站点和 APK 交付后的消费/下载验证也必须执行。不得把本草稿视为已经可以发布的声明。

## 消费证据补核后的修复补充(Spec060)
## 后续修复补充

- fix(button): 修复默认幽灵按钮的文字与描边未跟随自定义反色主题的问题;禁用样式与实例状态样式优先级保持原约定。

- fix(theme): 修复稀疏自定义深色JSON未配置的背景、文字与引用回退为浅色Token的问题(已随PR1166合入;见[Spec068](../068-custom-theme-dark-mode/acceptance.md)及主题回归测试)。

该草稿不代替自动生成的CHANGELOG。其他运行差异仍以Spec060逐项方案及待验收状态为准。
2 changes: 2 additions & 0 deletions specs/061-migration-documentation-design/acceptance.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> **历史设计,已被后续方案取代。** 本阶段只交付设计。正文来源以 [Spec062](../062-documentation-source-consolidation/spec.md) 为准;阅读结构和组件定位以 [Spec064](../064-migration-reading-flow/spec.md) 为准;侧栏入口以 [Spec072](../072-migration-navigation-and-demo-entry/spec.md) 为准。原定57个独立章节、自动注入摘要和拟定锚点不再作为实施任务,不应据此重复开发。下文及 JSON 矩阵保留原始设计,不能作为当前页面清单或已验证声明。尚缺的真实业务迁移、设备和设计证据见 [发布收口记录](../074-release-readiness-closeout/readiness.md)。

> 文档路径和维护来源已由[Spec062](../062-documentation-source-consolidation/spec.md)调整;下文保留本阶段历史记录,未完成迁移内容和验收仍以原清单为准。

# 设计验收
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"status": "design-only",
"status": "superseded-design",
"source": "specs/058-release-preparation/component-migration-index.json",
"entries": [
{
Expand Down Expand Up @@ -629,5 +629,10 @@
"proposedSiteTarget": "/flutter/migration-1-0#migration-theme",
"implemented": false
}
]
],
"supersededBy": [
"specs/062-documentation-source-consolidation/spec.md",
"specs/064-migration-reading-flow/spec.md"
],
"usage": "Historical proposal only; entries and implemented flags do not describe the current site."
}
2 changes: 2 additions & 0 deletions specs/061-migration-documentation-design/plan.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> **历史设计,已被后续方案取代。** 本阶段只交付设计。正文来源以 [Spec062](../062-documentation-source-consolidation/spec.md) 为准;阅读结构和组件定位以 [Spec064](../064-migration-reading-flow/spec.md) 为准;侧栏入口以 [Spec072](../072-migration-navigation-and-demo-entry/spec.md) 为准。原定57个独立章节、自动注入摘要和拟定锚点不再作为实施任务,不应据此重复开发。下文及 JSON 矩阵保留原始设计,不能作为当前页面清单或已验证声明。尚缺的真实业务迁移、设备和设计证据见 [发布收口记录](../074-release-readiness-closeout/readiness.md)。

> 文档来源更新:根迁移正文及站点副本方案已由[Spec062](../062-documentation-source-consolidation/spec.md)取代;迁移正文现维护在站点docs,包内仅保留生成副本。本记录其他未完成项不因此关闭。

# 设计与实施方案
Expand Down
2 changes: 2 additions & 0 deletions specs/061-migration-documentation-design/spec.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> **历史设计,已被后续方案取代。** 本阶段只交付设计。正文来源以 [Spec062](../062-documentation-source-consolidation/spec.md) 为准;阅读结构和组件定位以 [Spec064](../064-migration-reading-flow/spec.md) 为准;侧栏入口以 [Spec072](../072-migration-navigation-and-demo-entry/spec.md) 为准。原定57个独立章节、自动注入摘要和拟定锚点不再作为实施任务,不应据此重复开发。下文及 JSON 矩阵保留原始设计,不能作为当前页面清单或已验证声明。尚缺的真实业务迁移、设备和设计证据见 [发布收口记录](../074-release-readiness-closeout/readiness.md)。

> 文档路径和维护来源已由[Spec062](../062-documentation-source-consolidation/spec.md)调整;下文保留本阶段历史记录,未完成迁移内容和验收仍以原清单为准。

# 0.2.7 → 1.0 迁移文档设计
Expand Down
2 changes: 2 additions & 0 deletions specs/061-migration-documentation-design/tasks.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> **历史设计,已被后续方案取代。** 本阶段只交付设计。正文来源以 [Spec062](../062-documentation-source-consolidation/spec.md) 为准;阅读结构和组件定位以 [Spec064](../064-migration-reading-flow/spec.md) 为准;侧栏入口以 [Spec072](../072-migration-navigation-and-demo-entry/spec.md) 为准。原定57个独立章节、自动注入摘要和拟定锚点不再作为实施任务,不应据此重复开发。下文及 JSON 矩阵保留原始设计,不能作为当前页面清单或已验证声明。尚缺的真实业务迁移、设备和设计证据见 [发布收口记录](../074-release-readiness-closeout/readiness.md)。

# 工作清单

## 本次设计
Expand Down
4 changes: 2 additions & 2 deletions specs/064-migration-reading-flow/spec.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
# 迁移指南分层阅读

状态:实现完成,按用户最新授权提交至PR1163,待合并前Review。
状态:实现已随 [PR1166](https://github.com/Tencent/tdesign-flutter/pull/1166) 合入 develop;后续入口调整见 Spec072。文档结构通过不代表全部业务迁移或发布验收完成。

## 目标

让用户先定位升级范围,再按需阅读具体改法;复用现有已验证迁移代码,避免只优化排版而仍无法执行。

## 契约

总览先于详细代码;57个组件入口按现有6组保留,采用可展开分组。已覆盖的主要场景提供明确的旧用法处理、新用法、行为风险与迁移检查。没有逐项完整验证的组件不标记为只需改名或已完成迁移。383项旧类型对照仍作为折叠附录。
总览先于详细代码;57个组件入口按现有6组保留,采用可展开分组。已覆盖的主要场景提供明确的旧用法处理、新用法、行为风险与迁移检查。没有逐项完整验证的组件不标记为只需改名或已完成迁移。旧类型对照仍作为折叠附录,完整项数以后续源码补核为准。

站点内的组件链接使用本地路由;包内副本使用可独立访问的线上链接。只维护一份迁移正文,复用原有代码片段生成机制。

Expand Down
17 changes: 17 additions & 0 deletions specs/074-release-readiness-closeout/acceptance.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# 验证记录

检查基线:596e013df08e1f7c85032314d2ed611349143395。日期:2026-10-15。

- Flutter3.32.0 / 3.47.7:严格静态分析均零问题;仓库外独立迁移消费各21项通过,包含公开包入口分析。两SDK使用隔离编译缓存,未调整生产依赖。
- 站点示例/API/页面契约测试26项通过;README/迁移片段同步检查6份文档、0项过时。新增文档及修改的入口链接检查通过。
- develop run38733652355:双SDK分析、APK/iOS/Web共6项构建、Linux3.32视觉回归通过;两项功能job仍在工具自测阶段运行,未将其记为全部通过。
- CodeCC旧check116408636711:failure,严重漏洞计数null,0条annotation;重试API返回404,无法在本环境取得有效扫描报告。此项保持待处理。
- 不重新生成macOS Golden;不改历史Token报告、自动CHANGELOG、CI或生产代码。

本轮只能证明上述检查;没有真实设备、设计复核、剩余524项消费证据或最终版本候选发布归档的通过声明。发布门槛见readiness.md;独立版本PR另行记录归档预检。

独立版本升级已创建PR1170,基于develop,不包含本PR文档整理;两SDK真实包归档预检通过、0 warnings,结果留在Spec075。原零差异PR1163已关闭。本PR仍不声明最终候选可发布。

后续状态核对:develop run38733652355完整成功;版本PR1170 head7d3cb3e2的CodeCC check116424269590成功,严重漏洞数为0;PR1169 head3ec9793b扫描亦成功。旧null失败不再阻塞上述已扫描head。最终候选仍须读取对应head的实际结果;未放宽扫描或视觉门禁。

补核CI工具阶段:Flutter3.32.0在本地重跑工作流实际调用的6份工具测试文件(coverage/component runner/visual runner/API audit/typedef/presentation),147项全部通过。未改测试或超时设置。
7 changes: 7 additions & 0 deletions specs/074-release-readiness-closeout/plan.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# 实施方案

1. 同步 develop;确认旧 PR 的改动均已合入,不重复合并空差异。
2. 给 Spec061 四份文档及设计矩阵增加取代说明,保留原设计;校正 Spec064 合并状态,为旧 Spec058 验收添加基线提示。
3. 复跑双 SDK 分析和迁移消费、站点契约及同步检查;读取最新 develop CI,不将旧成功推广到新候选。
4. 在 readiness.md 给出剩余项、完成条件和执行顺序;PUBLISH.md 链接此记录。
5. 另建 release/1.0.0 PR,集中升级正式版元数据并执行真实发布归档预检。
44 changes: 44 additions & 0 deletions specs/074-release-readiness-closeout/readiness.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# 1.0 发布候选收口记录

日期:2026-10-15。代码基线:`596e013df08e1f7c85032314d2ed611349143395`。范围:仅从0.2.7升级到1.0.0。结论:准备继续推进,尚未达到正式发布条件。此处是本轮待办入口,历史报告不覆盖当前候选。

## 已收敛范围

- #1164、#1165、#1166、#1167、#1168 已合入 develop;原 #1163 同步后零差异,已关闭,避免重复合并同一批改动。
- 迁移正文只维护站点 docs,包内 MIGRATION 由同步脚本生成。Spec061 的独立57章/组件摘要方案被 Spec062、064 及后续导航方案取代,旧矩阵仅存档。当前使用六组定位、八组主要改法和旧声明附录;这些不证明所有旧业务场景都已验证。
- 正式版元数据由独立 [PR1170](https://github.com/Tencent/tdesign-flutter/pull/1170)(`release/1.0.0`)收口,保持草稿。不得通过合并 release PR 来试跑发布:现有工作流在合并后创建 tag。

## 发布前必须关闭

| 项目 | 当前证据与缺口 | 下一步及关闭条件 |
| --- | --- | --- |
| Token 消费 | Spec060 历史677项中524项缺运行证据;116项默认值验证、2项修复、8项契约验证仍缺最终视觉;21项方案、1项几何待执行,5项未找到冻结源消费者 | 依照 Spec059 逐组件建立当前候选实际消费断言;有浅深色、自定义覆盖、实例优先级和实际尺寸/颜色记录后才更新该项。对无消费者5项给出处置裁定,不能计作通过。保留历史报告,另产新候选证据 |
| 剩余差异 | [Spec060方案](../060-token-difference-resolution/solutions.md) 仍是待实施方案 | 先确定按钮危险/禁用语义与 Switch 几何目标及设计版本,再分按钮、Switch两批实施。每批双SDK功能回归、Linux3.32精确Golden和设计复核;按钮边框先量测375px、DPR2/3的微信伪元素实际几何,不能直接把4rpx换成2dp |
| 人工验收 | [12项验收表](../058-release-preparation/manual-acceptance.md) 全部未执行,最终SHA、设备和设计版本未填 | 在最终候选构建设备包;真实Android/iOS和目标浏览器执行IME、权限、GPU、滚动及字体/主题场景;逐行记录设备、步骤、结果和证据。单元测试不能替代 |
| 迁移覆盖 | 声明级迁移入口、删除能力及代码一致性核对见[Spec076](../076-migration-release-documentation-audit/acceptance.md);已补核388项旧自有导出。文档有对应入口不代表每个旧成员调用和全部业务场景都通过运行验证 | 对真实0.2.7业务使用的API逐项对照指南和旧声明附录;缺改法补到已有章节,再补对应外部消费场景;旧调用在0.2.7环境独立验证。不得把结构校验等同于全面可迁移 |
| CodeCC | 新版本PR1170 head7d3cb3e2的check116424269590已成功,严重漏洞数明确为0;PR1169 head3ec9793b亦通过。旧#1168的null失败记录保留,不当作具体漏洞 | 本轮通过新PR重新触发扫描恢复有效结果,没有绕过门禁;候选变更后必须确认新的最终head扫描通过,不能沿用旧head的绿色结果 |
| 更新日志 | 自动日志外已有[发布说明草稿](../058-release-preparation/release-notes-draft.md),不能推定工具会采集被标记无需日志的PR | 核对 release PR 自动生成评论覆盖0.2.7以来用户可见变更,特别是Ghost自定义反色、稀疏深色主题JSON及API删除。按现有流程编辑确认的发布评论,不手写自动CHANGELOG |
| 最终候选验证 | develop历史CI和本轮检查并非最终release head | release PR最后一次自动修改后重新记录完整head、依赖和构建哈希;双SDK分析/功能/迁移、Linux精确Golden、APK/iOS/Web、真实发布归档dry-run必须对应同一候选;修订源码后复验受影响项 |
| 交付来源 | 官方固定APK/二维码之前下载到0.2.7,尚无1.0交付证据;tag流程读取移动develop | 发布人按PUBLISH.md核对tag/包/站点/APK来自同一冻结SHA。不能证明来源一致就暂停交付;线上pub.dev消费和二维码APK实际安装在发布后执行,发布前准备对应访问权限与回退方案 |

## 文档交付后的发布验收

2026-10-15,维护者确认PR1169的迁移文档核对可交付。下列事项不阻塞该文档PR的交付,仍须按实际证据完成后续发布验收;本清单不表示已验证通过或获准合并版本PR1170。

| 待验收事项 | 处理方案与关闭条件 |
| --- | --- |
| Slider滑块边界(历史PR868) | 在最终实现验证两端边界、拖动和不同尺寸,再按实际效果决定是否保留该条修复日志 |
| Table固定列滚动(历史PR890) | 验证当前TTable固定首列、限制高度和纵向滚动的组合场景,确认文档配置方法与实际行为一致 |
| TreeSelect外凸圆角(历史PR880) | 对照最终设计确认效果,优先归入当前视觉调整说明;没有最终设计或页面证据时不单列为已验证的旧像素修复 |
| Web文字垂直居中(历史PR903) | 验证当前文字布局;按旧强制补偿机制及全局开关移除、当前用法整理说明,不承诺旧算法仍被保留 |
| 迁移指南浏览器验收 | 桌面及375px检查组件索引跳转、折叠内容定位、刷新、返回和键盘操作,记录浏览器及结果;已有静态检查不能替代这一步 |
| 最终候选同步 | PR1169合入develop后同步PR1170,冻结完整SHA;复核迁移副本、API、示例、发布说明、归档预检及完整CI。实际通过前版本PR保持草稿 |

## 操作顺序

1. 先合入不涉及版本的修复;待裁定视觉先取得冻结设计/跨端依据,保留未通过状态。
2. 完成 Token 和人工验收,修正指南缺口;在 release PR 核对自动生成发布说明。
3. 同步最终 develop 到独立版本 PR,冻结候选;完成全矩阵、归档预检和扫描,确认工作流使用该候选。
4. 发布门槛全部关闭后再合并版本 PR,按 PUBLISH.md 上传和上线;验证正式包消费、正式站点和APK二维码。

当前没有设备和设计裁定,不能把对应项改为完成,也不能据此合并版本 PR 或宣称1.0已发布。
17 changes: 17 additions & 0 deletions specs/074-release-readiness-closeout/spec.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# 发布准备收口

## 目标与范围

以 develop `596e013df08e1f7c85032314d2ed611349143395` 为本次检查基线,消除过时迁移设计任务,记录当前运行证据与剩余发布门槛。正式版本号在独立 `release/1.0.0` PR 调整。

## 契约

历史审计和源指纹保持原样;旧设计标明被取代,不伪造完成勾选。功能、Token 消费、设计视觉、设备和线上交付分别留证;没有证据的门槛仍待执行。操作记录集中在 readiness.md,PUBLISH.md 只链接,不复制状态。

## 非目标

不机械应用未裁定 Token 补丁,不改 Golden、CI 规则或自动 CHANGELOG,不发布包、tag、站点、APK。

## 验收

文档链接有效,同步检查及既有文档测试通过;重新执行双 SDK 严格分析与独立迁移消费测试并记录结果。版本 PR 不混入这些整理。
10 changes: 10 additions & 0 deletions specs/074-release-readiness-closeout/tasks.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# 工作清单

- [x] 同步最新 develop,确认 #1163 零差异。
- [x] 标记过时迁移方案与历史验收边界。
- [x] 汇总待关闭事项、证据要求与操作顺序。
- [x] 双 SDK 分析与独立迁移消费复验。
- [x] 文档测试、同步和链接检查。
- [x] 单独提交版本升级草稿 PR:#1170,目标develop。

发布放行事项另见 readiness.md;本目录任务通过不表示放行。
Loading
Loading