构建平台与制品边界
本页规定 ColorVision 宿主、插件、客户项目和独立 FileIO 包的平台与制品组合。具体模块从源码知识地图定位;修改共享构建策略时,分别核对宿主、原生依赖和独立包。
先区分动作和制品
| 当前任务 | 权威入口与边界 |
|---|---|
| 理解或修改源码 | 先定位实际模块及其测试;不要求安装设备驱动、启动主程序或发布 |
| 首次准备构建 | 环境与依赖核对 native helper、C++ 工具链、x64 与签名条件 |
| 选择验证范围 | 测试与验证给出最小检查及覆盖缺口;文档检查不能替代产品测试 |
| 构建或发布交付包 | 脚本契约定义入口和副作用;打包 wrapper 可能上传,不能作为默认本地构建 |
| 修改公开行为或平台策略 | 同步对应主题与代码映射,按维护规范复核;不要另写一份面向不同角色的说明 |
平台支持策略
当前支持边界是 Windows x64。build.sln、主安装器、全量/增量更新包、官方插件包和 runtimes/win-x64/native 资产均按 x64 验证。 宿主、官方插件和客户项目的 Platform/PlatformTarget 必须是 x64;RID 可以为空或为 win-x64,多 RID 只能包含 win-x64。 x86、AnyCPU、ARM64、win-x86、linux-x64 和混合 RID 等显式覆盖都会由共享 MSBuild 策略在初始化阶段以及 Build/Pack 入口 fail-fast。
build.sln、scgd_general_wpf.sln 和 UI/UI.sln 只公开 Debug|x64 与 Release|x64。除 ColorVision.FileIO 外,所有 managed 与 native 项目都在这两个配置下映射到 x64。主程序 CI 构建和正式交付使用 Release|x64;本地开发可以使用 Debug|x64。
ColorVision.FileIO 是唯一例外的独立纯托管 NuGet 包。包含它的 solution 在 x64 solution 配置下将该项目的 ActiveCfg 与 Build.0 映射到 Any CPU。 规范产物位于无架构目录的 Engine/ColorVision.FileIO/bin/Release,并使用同一包坐标,各目标框架内均为纯托管 AnyCPU 程序集;它要求 Platform=AnyCPU、PlatformTarget=AnyCPU 且 RID 为空,不生成 x64/x86/ARM64 变体。 发布门禁会核对 nupkg 坐标、全部 PE 资产和 CLR flags。AnyCPU 包可被不同架构进程消费, 并不表示 ColorVision 桌面宿主或官方插件已经支持 ARM64。
# 只读核对项目、solution 和策略声明;不构建、不启动应用或发布
python Scripts\verify_platform_policy.py不带包参数时,此命令不检查已生成的 .nupkg。CI 使用 --fileio-package-directory Engine/ColorVision.FileIO/bin/Release 另核对 FileIO 包坐标、目标框架和 PE/CLR 标志;声明检查通过不能替代实际包验证。
真正增加 ARM64 支持必须分阶段完成:
- 为全部必需的 C++、COM、OpenCV、设备厂商和算法 DLL 提供 ARM64 构建或受支持替代,并完成 ABI 测试;CUDA 能力必须有厂商支持的 Windows ARM64 技术路径,不能用 x64 DLL 代替。
- 消除源码、项目引用和复制脚本中的 x64 固定路径,为 NuGet/插件/项目包增加独立的
win-arm64资产。 - 增加 ARM64 solution 配置和 CI 交叉编译,并在 Windows ARM64 设备上验证启动、插件加载、图像算法、设备通信和更新回滚。
- 生成独立 ARM64 安装器与更新源,验证安装、升级、卸载和包签名后,才能把 ARM64 列为受支持平台。
证据与变更规则
Directory.Build.props、各项目文件和 solution 映射共同决定实际平台策略。Scripts/verify_platform_policy.py 及其测试用于检查策略;测试文件存在不代表已在本轮运行,也不证明真机驱动、安装升级和设备行为。
普通构建与检查不授权签名上传、发布、提交或推送。发布执行规则仍以根 AGENTS.md 和脚本契约为准,不在本页复制另一套命令清单。
