Pull Request已成功合入, 合并人@openharmony_ci
(感谢 fangzhen 的贡献)感谢提交 Pull Requests !此PR未通过DCO校验。
校验失败可能原因:
1. 未签署“DCO协议”(开发者原创声明协议),在线签署、查看签署状态。
2. Commits 中未包含 Signed-off-by信息,参考FAQ处理。
修复上述问题后,在PR的评论框输入“check dco” ,单击”评论”,系统将再次进行DCO校验。
当前检测到如下Commits 未包含Signed-off-by信息:
Thanks for submitting a pull request. This pull request has not passed the DCO check.
Possible causes:
1. You have not signed the Developer Certificate of Origin (DCO). Sign the DCO and check DCO status.
2. The commits do not contain the Signed-off-by information. To resolve this issue, see FAQs.
After resolving the preceding issues, enter check dco in the comment box of this pull request and click Comment. The system will check DCO status again.
The following commits do not contain the Signed-off-by information:


感谢提交 Pull Requests!
Thanks for submitting a pull request.


【AI-Review】【建议】【基础代码问题】【可读性问题】产品名称大小写与官方命名不一致
● 问题: 本PR新增的正文及版本映射表中,产品名称大小写与官方命名不一致:第9行"已迁移至 Gitcode"中"Gitcode"应为"GitCode";第13行"Gitcode Releases"中"Gitcode"应为"GitCode";第14行"Github Releases(deprecated)"中"Github"应为"GitHub"。"GitCode"(G和C均大写)是GitCode平台的官方名称(本项目AGENTS.md及官方文档均使用"GitCode"),"GitHub"(G和H均大写)是GitHub的官方名称。
● 影响: 建议。产品名称拼写不规范影响文档专业性,且用户按"GitCode"作为关键词搜索时无法匹配到"Gitcode"的文档内容。README-en.md第9/13/14行存在相同问题。
● 建议: 将README.md和README-en.md中所有"Gitcode"修改为"GitCode",所有"Github"修改为"GitHub"。


【AI-Review】【建议】【基础代码问题】【可读性问题】产品名称大小写与官方命名不一致
● 问题: 本PR新增的正文及版本映射表中,产品名称大小写与官方命名不一致:第9行"migrated to Gitcode"中"Gitcode"应为"GitCode";第13行"Gitcode Releases"中"Gitcode"应为"GitCode";第14行"Github Releases(deprecated)"中"Github"应为"GitHub"。"GitCode"(G和C均大写)是GitCode平台的官方名称,"GitHub"(G和H均大写)是GitHub的官方名称。
● 影响: 建议。产品名称拼写不规范影响文档专业性,且用户按"GitCode"作为关键词搜索时无法匹配到"Gitcode"的文档内容。README.md第9/13/14行存在相同问题。
● 建议: 将README.md和README-en.md中所有"Gitcode"修改为"GitCode",所有"Github"修改为"GitHub"。


README.OpenSource 和 react-native-harmony-screens/package.json的基线版本是3.34.0。确认基线版本是否正确。


npm install 版本改成正式版或者beta版本,文档不出现rc版本,而且有的rc版本外网不存在


感谢提交 Pull Requests!
Thanks for submitting a pull request.


【AI-Review】【严重】【基础代码问题】【代码逻辑错误】scrollEdgeEffects表格行格式损坏
● 问题: README.md第403行的 scrollEdgeEffects 表格行缺少行首 |、Description 列和 Type 列,当前内容为 scrollEdgeEffects | No | iOS | No |,仅剩 Name、Required、Platform、HarmonyOS Support 四列。从 diff 可知,该行由本 PR 从旧版 | scrollEdgeEffects<sup>4.9.0</sup> | 配置内容 ScrollView 的滚动边缘效果 | scrollEdgeEffects | No | iOS | No | 改写而来,改写时丢失了行首竖线、Description 和 Type 列以及版本标签。对比同 PR 的英文版 README-en.md,该行被整体删除,中文版却保留了残缺行。
● 影响: 严重。Markdown 表格行必须以 | 开头才能被渲染为表格行,该行不以 | 开头会被渲染器当作普通文本插入到 gestureResponseDistance 行与 onAppear 行之间,破坏 ScreenProps 属性列表表格的渲染结构,导致该表格后续所有行错位或整段表格断裂。同时中英文文档不一致:英文版无此属性行,中文版保留残缺行。
● 建议: 恢复为完整的表格行格式,补充 Description 和 Type 列,例如:| scrollEdgeEffects | 滚动边缘效果 | \scrollEdgeEffects` | No | iOS | No |`;或者与英文版保持一致直接删除该行(因 Known Issues 中已声明 scrollEdgeEffects 未实现)。


【AI-Review】【严重】【基础代码问题】【代码逻辑错误】@react-navigation/stack 的 npm 与 yarn 安装版本不一致
● 问题: README.md 第66行 npm 命令安装 @react-navigation/stack@6.4.1,而第75行对应的 yarn 命令安装 @react-navigation/stack@6.9.13,同一文档内同一包的 npm 与 yarn 安装版本不一致。README-en.md 第66行与第75行存在同样的不一致。从 diff 可知,本 PR 将 npm 版本从旧版 7.2.10 改为 6.4.1,但未同步更新 yarn 版本(仍保留为 6.9.13),引入了版本不匹配。
● 影响: 严重。用户按照 yarn 命令安装会得到 6.9.13 版本,按照 npm 命令安装会得到 6.4.1 版本,两者次版本号不同(6.9 vs 6.4),API 可能存在差异,导致根据不同安装方式引入的依赖版本不一致,可能引发运行时错误或行为不一致。
● 建议: 将 yarn 命令中的 @react-navigation/stack 版本与 npm 命令保持一致,统一为 6.4.1(即第75行改为 yarn add @react-navigation/stack@6.4.1),README-en.md 同步修改。


【AI-Review】【一般】【基础代码问题】【代码逻辑错误】README-en.md详情区缺少transitionDuration属性行
● 问题: README-en.md 第606行(shouldShowHintSearchIcon)与第607行(direction)之间缺少 transitionDuration 属性行。对比 README.md 第609行,中文版详情区保留了 transitionDuration 行(| transitionDuration | 更改iOS上... | property | No | iOS | No |),而英文版详情区无此行。从 diff 可知,英文版旧版该行带有 <sup>4.8.1</sup> 版本标签被本 PR 删除,中文版该行无版本标签被保留,导致中英文详情区属性列表内容不对齐。
● 影响: 一般。英文用户在详情区看不到 transitionDuration 属性的说明,与中文文档内容不一致,影响文档完整性与中英文一致性。该属性在上方主表格中已有列出(第420行),因此不会导致属性完全缺失,但详情区作为社区版属性汇总缺少该行属于文档内容遗漏。
● 建议: 在 README-en.md 第606行后补充 transitionDuration 行,与中文版保持一致:| transitionDuration | Changes the duration (in milliseconds) of \slide_from_bottom`, `fade_from_bottom`, `fade`, and `simple_push` transitions on iOS, defaults to `500` | property | No | iOS | No |`


感谢提交 Pull Requests!
Thanks for submitting a pull request.


【AI-Review】【一般】【基础代码问题】【可读性问题】中英文 README 遗留问题列表不一致
● 问题:README.md 的"遗留问题"章节保留了 issue#29(GestureDetectorProvider 按原库的引用方式在77环境上引用不到)和 issue#30(在Screen和其子组件中通过Option有设置不同属性时,在77环境ets侧接收到的属性有丢失)两条 0.77 环境相关的已知问题(第620、622行),但 README-en.md 的"Known Issues"章节在本次PR中已将这两条删除。本次PR将文档范围缩减为仅覆盖 0.72 版本(版本映射表、安装命令、兼容性验证均已移除 0.77/0.82 内容),README-en.md 同步移除了这两条 0.77 专属问题,但 README.md 遗漏未删。
● 影响:一般。中英文文档的已知问题列表不一致,使用中文文档的用户会看到两条与 0.77 环境相关的已知问题,而使用英文文档的用户看不到,造成信息不对称;且这两条问题指向的是本文档已不再覆盖的 0.77 环境,对仅关注 0.72 的用户造成误导。
● 建议:与 README-en.md 保持一致,删除 README.md 第620、622行(issue#29 与 issue#30)这两条 0.77 环境相关的遗留问题;或者在 README-en.md 中补回这两条以保持中英文一致。


感谢提交 Pull Requests!
Thanks for submitting a pull request.


感谢提交 Pull Requests!
Thanks for submitting a pull request.


感谢提交 Pull Requests!
Thanks for submitting a pull request.


感谢提交 Pull Requests!
Thanks for submitting a pull request.


【AI-Review】【一般】【编码规范】【注释/可读性】文档中API名称前缀拼写错误,user应为use
● 问题: README.md第351-353行及社区版表格第532-534行列出的三个API名称均使用了"user"前缀,但源码中实际导出的名称均以"use"开头(React Hook命名规范)。具体证据:
- useReanimatedTransitionProgress:react-native-harmony-screens/src/components/Screen.tsx第346行注释引用useReanimatedTransitionProgress,tester测试工程Test1539.tsx:6和Test887.tsx:19的import语句均使用useReanimatedTransitionProgress(非user);
- useHeaderHeight:Gestures.tsx:15、Test1031.tsx:8、Test1296.tsx:8、Test1671.tsx:4均从@react-navigation/elements导入useHeaderHeight(非userHeaderHeight);
- useAnimatedHeaderHeight:Test1802.tsx:10注释引用useAnimatedHeaderHeight(非userAnimatedHeaderHeight)。
在react-native-harmony-screens/src/index.ts的导出列表中未找到任何"user"前缀的导出。
● 影响: 一般。开发者按照README文档使用userReanimatedTransitionProgress、userHeaderHeight或userAnimatedHeaderHeight导入时,会因名称不存在而报"Module has no exported member"错误,无法正常使用这些API。虽然这三个API的HarmonyOS Support列为NO,但文档作为开发者参考依据,名称错误仍会误导用户。
● 建议: 将第351行userReanimatedTransitionProgress改为useReanimatedTransitionProgress,第352行userHeaderHeight改为useHeaderHeight,第353行userAnimatedHeaderHeight改为useAnimatedHeaderHeight。同时检查社区版表格(第532-534行)中的相同拼写错误一并修正。


【AI-Review】【一般】【编码规范】【注释/可读性】文档中API名称前缀拼写错误,user应为use
● 问题: README_en.md第349-351行及社区版表格第530-532行列出的三个API名称均使用了"user"前缀,但源码中实际导出的名称均以"use"开头(React Hook命名规范)。具体证据:
- useReanimatedTransitionProgress:react-native-harmony-screens/src/components/Screen.tsx第346行注释引用useReanimatedTransitionProgress,tester测试工程Test1539.tsx:6和Test887.tsx:19的import语句均使用useReanimatedTransitionProgress(非user);
- useHeaderHeight:Gestures.tsx:15、Test1031.tsx:8、Test1296.tsx:8、Test1671.tsx:4均从@react-navigation/elements导入useHeaderHeight(非userHeaderHeight);
- useAnimatedHeaderHeight:Test1802.tsx:10注释引用useAnimatedHeaderHeight(非userAnimatedHeaderHeight)。
在react-native-harmony-screens/src/index.ts的导出列表中未找到任何"user"前缀的导出。
● 影响: 一般。开发者按照README文档使用userReanimatedTransitionProgress、userHeaderHeight或userAnimatedHeaderHeight导入时,会因名称不存在而报"Module has no exported member"错误,无法正常使用这些API。虽然这三个API的HarmonyOS Support列为NO,但文档作为开发者参考依据,名称错误仍会误导用户。
● 建议: 将第349行userReanimatedTransitionProgress改为useReanimatedTransitionProgress,第350行userHeaderHeight改为useHeaderHeight,第351行userAnimatedHeaderHeight改为useAnimatedHeaderHeight。同时检查社区版表格(第530-532行)中的相同拼写错误一并修正。


start build


start build


首次触发
门禁构建开始,包含静态检查,预计在60分钟内完成,门禁结果会同步发送到注册邮箱。您可以通过如下链接跟踪门禁进展:http://dcp.openharmony.cn/workbench/cicd/detail/6a8e7dd164650f998b24343b/runlist


代码门禁未通过
您可以通过如下链接查看门禁报告:http://dcp.openharmony.cn/workbench/cicd/detail/6a8e7dd164650f998b24343b/runlist
静态检查:
| # | check type | result | report |
|---|---|---|---|
| 1 | codeCheck | noPass | >>> |


start build


部分构建失败,仅触发失败构建
门禁构建开始,包含静态检查,预计在60分钟内完成,门禁结果会同步发送到注册邮箱。您可以通过如下链接跟踪门禁进展:http://dcp.openharmony.cn/workbench/cicd/detail/6a8e93a664650f998b2bf269/runlist


代码门禁未通过
您可以通过如下链接查看门禁报告:http://dcp.openharmony.cn/workbench/cicd/detail/6a8e93a664650f998b2bf269/runlist
静态检查:
| # | check type | result | report |
|---|---|---|---|
| 1 | codeCheck | noPass | >>> |


start build


部分构建失败,仅触发失败构建
门禁构建开始,包含静态检查,预计在60分钟内完成,门禁结果会同步发送到注册邮箱。您可以通过如下链接跟踪门禁进展:http://dcp.openharmony.cn/workbench/cicd/detail/6a8ea30c64650f998b327441/runlist


代码门禁通过
您可以通过如下链接查看门禁报告:http://dcp.openharmony.cn/workbench/cicd/detail/6a8ea30c64650f998b327441/runlist
静态检查:
| # | check type | result | report |
|---|---|---|---|
| 1 | codeCheck | pass | >>> |


docs: 升级文档模板至v0.4.2,仅保留0.72分支内容