《游戏编辑器技术原理与架构》13.3 发布检查与质量门禁
门禁分两级:block 失败阻止发布,warn 失败只记录。发布结论只看 block;报告同时列出两级的失败项。空门禁视为通过——没有检查就不该拦人,但也没提供任何保证。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的发布质量门禁。
category
门禁分两级:block 失败阻止发布,warn 失败只记录。发布结论只看 block;报告同时列出两级的失败项。空门禁视为通过——没有检查就不该拦人,但也没提供任何保证。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的发布质量门禁。
配置分三层:默认值、项目文件、命令行。合并顺序决定优先级,对象深合并、数组整体替换——数组是列表语义,逐项合并只会得到谁都不认识的东西。字符串支持 ${path} 变量展开,未定义变量原样保留,方便发现拼写错误。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的构建配置合并。
一次构建是「请求 + 步骤链」:请求带平台、场景与配置,每个步骤消费请求并产出产物。步骤串行,任一步抛错立即中止,已经产出的产物保留在报告里;产物去重但保持首次出现的顺序。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器内构建。
流水线按阶段推进:阶段内可并行,阶段间串行;某阶段有失败,后续阶段全部跳过并记为失败。每个任务按输入清单算缓存键,命中缓存直接跳过。报告给出执行、跳过、失败三张清单与最大并行宽度。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的云端 CI 流水线。
远程桌面会话持有分辨率、码率与输入事件流;带宽按码率直接换算,分辨率影响画面内容但不影响码率上限。云端构建队列按先来先服务,配额按任务成本累加,提交即扣、取消即还,超配额直接拒绝。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的远程桌面与云端构建。
WebAssembly 模块声明自己需要哪些导入函数、导出哪些函数、占多少页内存。加载器只做四件事:导入必须全部由宿主提供、内存总量不超预算、同模块不重复加载、卸载时把内存还回去。真实的实例化交给运行时,这四件事不变。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器 WASM 化。
三种角色配一张操作矩阵:owner 全权,editor 只能编辑,viewer 只读。编辑锁是矩阵之外的二级约束:被他人锁住的路径连 owner 也不能直接改,必须先解锁——锁保护的是正在改,不是身份。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的协作权限与锁。
两条并发的编辑落到同一路径、值又不同,就是冲突。检测按路径分组,同值的并发编辑不算冲突。解决策略三选一:last-write-wins 取时间戳最大者,owner 取指定作者的版本,manual 交给人工——返回 null 表示待定。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的并发编辑冲突。
每次编辑是一个带全局版本号的操作。日志只接受下一个版本;提前到达的操作先缓存,版本补齐时按序一次排空;重复或过期的操作直接拒绝。应用成功的操作按顺序通知订阅者,保证两端看到同一序列。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的协作变更同步。
编辑器的卡顿往往不在渲染,而在自己身上:属性面板重建、资产扫描、布局计算。剖析器用 begin/end 成对计时,栈结构支持嵌套;百分位与慢操作清单回答偶发卡顿有多偶发、最慢的是谁。时钟可注入,测试不依赖真实时间。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的编辑器自身性能。
缩略图、导入、校验都进同一个后台队列:优先级高的先出,同优先级先来先出;同 id 任务不重复排队;并发上限到了就拒绝出队,完成一个再放一个。去重与并发上限是队列的两条硬约束,缺一个就会把线程池打爆。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的后台任务队列。
大场景导入把任务按工作线程数切批,每批内顺序执行、批间推进。单个任务失败重试一次,仍失败才进入失败集;进度按批回调。真实的线程池在这里被缩成同步模型,但调度、重试、进度三件事的语义不变。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的并行导入。
示例在受控接口调用时检查权限。清单声明需要什么,安装时授予什么,调用时检查什么。写盘、网络、起进程属于危险权限,必须经过用户确认;只读权限也需要匹配已授予的条目。隔离域则为扩展的存储与消息端口提供命名空间。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的扩展权限与隔离。
扩展需要三个入口:自己的窗口、主菜单里的一项、以及一个快捷键。菜单是树,路径一次补全中间节点;快捷键是全局资源,跨扩展冲突必须当场拒绝,而不是等用户按下组合键时才发现两个命令同时触发。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的菜单与快捷键扩展。
编辑器支持扩展,第一步不是开放 API,而是让每个扩展交出一份可校验的清单:id、版本、依赖。注册表据此拒绝重复 id、发现缺失依赖、按依赖排出启动顺序,并用环路报告代替一个看似成功却永远起不来的顺序。本节从零实现并真跑 6 条用例,对标 Unity / Unreal / Godot / Cocos Creator 的扩展注册与依赖。
《游戏编辑器技术原理与架构·扩展、调试与规模化》的目录与学习路径:45 篇逐节索引、三条阅读路线、十五章依赖关系,以及本卷与卷一《架构内核》、卷二《资产管线》、卷三《视图、交互与子编辑器》和站内既有《子系统与工具》最小骨架的分工边界;读完能判断哪些章节必须先读、哪些可以跳读,也能看清一个编辑器在扩展、调试与规模化三个方向上的完整能力全景。
全 45 篇的章节索引:从编辑器扩展框架出发,依次处理自定义 Inspector 与控件、自定义资产类型与导入器、自定义 Gizmo 与视口,再覆盖编辑器脚本 API、脚本热重载与域重载、调试器集成、Profiler 面板、远程调试与真机预览、编辑器性能、多用户协作编辑、云编辑器与 WebAssembly、构建与发布、编辑器自动化测试与回归,最后以系列收口收尾,完成工业级编辑器的能力全景与从 helio 到工业级的路线图。
资产改名不是改文件名就完事——所有引用它的资产都得跟着改。本节实现 renameAsset(入边重指向 + 返回修复数)与 fixUpText(引号包裹的路径精确替换、不误伤同名前缀);6 条用例本机真跑,钉住「单条/多条入边重指向、零引用改名、路径精确替换、多出现全替换」五条重构语义。
节点图要自动排版,还要能撤销布局操作。本节实现分层布局算法与快照撤销栈。6 条用例钉住层级分列、跨层连线与撤销恢复。对标 Blender 自动布局与 Houdini 的布局命令。
模板更新了(加字段、删字段),场景里已有的实例不能塌。migrateInstance 按「新增字段取默认 / 删除字段移除覆盖 / 新增字段已有用户覆盖则保留」迁移每个实例——尊重用户的覆盖,同时让模板演进安全落地。6 条用例本机真跑,对标 Unity Prefab 的 Overrides 面板与 Unreal 的 Blueprint 重编译。