Skip to content

安装制品与运行输出 ​

首次部署使用完整安装包;已有安装通过更新入口升级;源码构建输出用于开发和本地验证。本页说明制品选择、安装前检查和故障定位,工具链要求见系统要求,安装后的启动步骤见首次运行。

选择正确制品 ​

场景前提与检查
首次部署从可信的项目发布或交付渠道取得完整安装包;增量更新包不替代首次安装
现有安装升级先记录主程序、插件/项目包版本与配置,按更新与恢复契约确认包类型和回退条件
源码构建输出按环境与首次构建检查 .NET、C++/native、x64 与签名条件;托管编译成功不等于运行输出依赖完整
排查安装制品生成查部署链路和脚本契约,不要为了查看安装行为执行会上传的发布 wrapper

安装器使用仓库外的 Advanced Installer 工程,具体组件与权限提示以本次交付包为准;本页不把未经核对的向导按钮、默认组件或升级行为当作代码契约。

主程序通过 ColorVision/Update/ChangelogPage.cs 打开网页变更日志。仓库根目录 CHANGELOG.md 保留为项目链接和网站发布原稿,不复制到主程序的构建或 publish 输出目录;已有文件不清理。安装器、更新包和共享文件清单的日志排除规则见构建与发布脚本。

部署前与部署后边界 ​

  • 先确认 Windows x64 环境、目标安装目录和当前交付版本,核对安装目录写权限;安装服务或提升权限需要相应授权。
  • 安装、升级可能覆盖程序文件或修改系统状态;已有配置和客户数据不能作为排障默认删除目标。
  • 若文件被占用,先记录占用进程与具体文件,交由获准的操作者安排停机。不要自动结束用户进程或停止现场服务。
  • 源码运行输出的依赖由项目引用和复制规则决定;缺失 DLL 时查 ColorVision/ColorVision.csproj 及运行时依赖,不要以“安装已结束”证明依赖齐全。
  • 启动可能初始化模块和连接服务,不应在安装完成后无条件勾选启动。确认环境后再按启动与最小运行验证操作,该主题维护唯一的启动检查步骤。

失败定位 ​

现象先收集证据,再检查
安装程序无法启动包来源、版本、系统错误与完整性证据;系统策略拦截需要由获准人员处理,不绕过安全策略
文件无法写入或升级覆盖失败实际目标路径、权限和占用者;不要盲目切换安装目录留下并行旧版本
安装后启动失败本次日志、缺失 DLL 名、native 架构、配置解析错误;进入首次运行主题核对启动阶段
升级后行为异常主程序/插件/项目包版本是否匹配,实际加载位置、旧配置和恢复状态;先定位差异再决定修复或回退

验证缺口 ​

本页没有声明安装器自动化覆盖。知识校验只验证引用;真正的安装、升级、卸载、服务变更与回退,需要在获准的目标环境记录安装日志、实际版本及结果,不能由一次构建或文档检查代替。

基于 MIT License 发布。