Repository navigation
Replies: 2 comments
|
@jhaizhou-ops 正文更新了:新增第八节「按模块看」,逐个顶层目录给出现状(规模、谁在用、平台分支数、平行实现、已有的缝)和拆法 / 归属 / 测法,以及模块拆分的六个阶段;同时更正了一处说法——公开仓近两天的冲突热点是 |
0 replies
|
@jhaizhou-ops 跟进一下这帖「想请你定的」几条——从这两天 main 上的实际改动看,大部分已经用做法回答了,我按现状对一遍,不再等逐条回复:
我们这边相应调整:旧层( |
0 replies
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
@jhaizhou-ops 想跟你讨论一下合入流程和架构。现在贡献者基本都是 agent,PR 几分钟一个,验证和开发的节奏已经脱节,合入一直在堵。下面是我们安卓线从这两天的实际情况里看到的堵点,以及一套建议,请你看看哪些可行、怎么定。
一句话
问题不在 agent 写得太快,而在每个 PR 的验证成本太高,而且全部要过同一个闸口(维护方的审阅);平台之间的分叉又把每个 PR 的验证成本推得更高。所以想两头一起改:把单个 PR 变便宜、能让机器判;让大部分 PR 不必经过维护方。
一、当天的事实(11-09,公开仓)
caps_policy_test、contrib_unproven_test、pack_contracts_test、shader_input_fp_test、userpath_cache_test、widen_auto_infra_test等)你在 #48 发的 A / B / C 分类帖,本身就说明维护方在手工做三件事:判断 PR 碰了哪个平台、要哪种证据、排什么顺序。
二、堵点:一条只有一个出口的流水线
加开发 agent 只会让入口更宽,出口不会变宽。要提高合入速度只有两条路:降低每个 PR 在闸口要花的时间,以及让一部分 PR 根本不用经过这个闸口。
三、每个 PR 在闸口都要人做什么
docs/坑记录.md(107 个提交里 20 个改它)和launchers/shared/experience.v1.json(Mac、Windows 共写)① 最值得先动:main 只要有一步红,门禁结论就只能是「红,但和基线一样」,于是每个 PR 都要人读这段解释。门禁最大的价值是替人说行或不行,main 不绿,这个价值就没了。
四、多平台为什么让它更难:回放层分叉了
后果直接落在上面的 ②:安卓想加一个能力(节拍、首遇预算、限帧),要么改共用文件、拖上 iOS / Mac 的回归证明,要么在安卓副本里再写一份、让分叉更深。当天 main 上安卓回放层的分叉计数(#71 的统计):转接宏 51、安卓侧命令解码分支 80、
mtl_命名函数定义 35、共用文件里的__ANDROID__205。收敛的设计其实已经写好了(
docs/设计_回放核心共用.md,D0–D9),目前只做完 D0 和 D8 的第一段。五、目标形态:按目录分区,机器判能判的,人只看共享层
flowchart LR P["PR<br/>新行为默认关"] --> S{"按目录分流<br/>CODEOWNERS"} S -->|只改平台目录<br/>(多数)| Z["区负责人 + 门禁全绿<br/>agent 先做第一道审"] S -->|碰共享层<br/>(少数)| O["维护方 / 架构负责人<br/>宿主契约测试证多平台"] Z --> Q["合并队列<br/>main 恒绿,全绿自动合"] O --> Q Q --> M["main"] M -.-> N["每晚设备批(合入之后)<br/>开 / 关整批 A/B<br/>够了再发小 PR 翻默认值"]按你的 A / B 分类粗看,只改单个平台目录的 PR 明显多于碰共享代码的;正式比例可以统计一周再定。
六、七项措施
docs/坑记录.md一条一个文件;experience.v1.json按启动器 / 章节拆;测试入口按目录自动发现;补丁 series 按编号排序(见第九节)长期根治是回放核心共用:把 iOS 回放层抽成纯 C 共用核心,每个平台只实现
nvn_gpu_*后端和一个节拍源;跨平台不回归由宿主上「同一段命令流在每个后端回放」的契约测试自动证明,鸿蒙接入也只写一个后端。这一步投入大,适合一个人或一组 agent 连续推进,期间冻结回放层的平行改动。七、推进顺序
main 恒绿是其余几项的前提:main 不绿,合并队列和自动放行都无从谈起。
八、按模块看:每个目录怎么拆、归谁、怎么测
前面只拆到「平台区 / 共享层」两层,这一节落到每个顶层目录。数字取自公开仓 main(11-09);公开仓历史从首次快照起算只有约 1.3 天、107 个提交,安卓和图形目录这期间改动很少(大部分安卓 PR 还没合入),热点统计等它们合进来后要再做一次。
8.1 现状
runtime/srcruntime/include/*.hgraphics/nvnnvn_mtl.m对安卓 shim;缝:nvn_backend.h、nvn_vsync.handroidandroid/native/nvn、directgraphics/metalNxTrack.cs也编进安卓gal_abi.hgraphics/vulkangraphics/tracks2a_track.h、track_platform.hservicesNative.cs与s2a_native.h两份 ABI,安卓另有链接桩compatpackpack/jobslaunchers/*experience.v1.json由两个启动器共写ios·shell·macoshost_main.c反向包含ios/settings.hplatformplat.h四端共用testsdocsdocs/坑记录.md是头号热点另外,核心代码直接 include 平台私有文件的情况已登记 17 条(如
runtime/src/thread.c包含thread_android.inc、svc_mem.c包含安卓 tracking 头);共用文件直接 include 苹果系统头:runtime 45 条、graphics 30 条。仓里还没有鸿蒙代码。8.2 总原则
共享代码里不出现平台名,平台差异只从一个口子进来:运行时走
platform/plat.h,图形走nvn_gpu_*契约,出包走pack/targets/<平台>/。8.3 运行时:先拆掉「核心反向包含平台」
flowchart TB subgraph 现在 C1["runtime/src 共用文件"] -->|include| A1["android/native/thread_android.inc …"] C1 -->|include| I1["ios/settings.h …"] end subgraph 目标 C2["runtime/core<br/>零平台分支"] --> P["platform/plat.h v3"] PA["platform/android<br/>线程放核、VM、追踪"] -->|实现| P PP["platform/apple<br/>QoS、mach、设置"] -->|实现| P endplatform/android/,plat.h补线程放核、虚拟内存、追踪、生命周期、崩溃这些钩子(升 v3);host_main.c对ios/settings.h的依赖也改走plat.h。platform/android、platform/apple归各平台线。8.4 图形:按前端 / 核心 / 后端重新分目录
android/native/nvn、direct→graphics/backends/vulkan;NxTrack.cs→graphics/track;graphics/vulkan归到安卓名下。只搬不改,路径映射照tools/port_old_paths.tsv的做法,在途 PR 用脚本换路径。backends/vulkan不再触发 Metal 那约 17 分钟的门禁。8.5 其余模块
servicesNative.cs、s2a_native.h由它生成;删安卓链接桩compatcompat/verify.shandroidios·shell·macoslaunchers/*experience.v1.json按启动器 / 章节拆、构建时合并;启动器与出包的协议单独成契约packpack/jobs分共用作业框架 + 按目标平台部分;pack/targets/<平台>/归平台线platformplatform/ohostestsdocs/坑记录.mddocs/坑记录/<模块>/<一条一个文件>.md,索引自动生成;AGENTS.md 的「自己追加」改成「新建文件」8.6 模块拆分的顺序
experience.v1.json拆开;ios / shell / macos 补门禁认领platform/android,plat.h升 v3,加两道计数platform/ohos+ 复用backends/vulkan+ 壳阶段 0 到 2 主要是搬家和工具,每一步都是可独立合入、可回退的小 PR。
九、风险
自动合入会放大门禁的漏洞:门禁没覆盖到的东西会直接进 main。当天就有一例,应用侧 Java 编译不在宿主门禁里,一处坏注释差点混过去(#169,已修)。所以每晚设备批和机器初审不能省,门禁覆盖面也要跟着补。
想请你定的
experience.v1.json拆开、苹果壳补门禁认领)能否先做;阶段 1、2 的目录搬家由谁来做、什么时候冻结相关目录。安卓线不用等流程改动就会做的
欢迎其他平台线一起讨论,尤其是 iOS / Mac 线对第 3、4 项和回放核心共用的看法。
All reactions