工程部署

本文档旨在说明如何将 CMS Editor（开发版） 中制作完成的工程导出，并迁移至大屏或终端设备上的 CMS Vision（运行版） 进行部署和运行。

1. 工程导出

在搭建完工程的电脑上（开发版）进行以下操作：

1. 打开 CMS Editor（开发版）。
2. 进入 工程管理 页面。
3. 在列表中找到目标工程，点击 导出。
   • 注：如果需要保留历史数据，请同时进行数据备份/导出操作。
4. 将导出的 .cmsproj 工程文件（及相关数据备份文件）拷贝至 U盘或通过网络发送至目标设备。

2. 工程导入

将工程文件拷贝至目标设备的本地磁盘后，根据软件版本和场景，可选择以下两种方式之一进行导入：

方式一：通过软件向导快速部署（ v2.37.0 及以上版本）

适用于新安装 Vision 后的首次配置，无需进入后台复杂操作。

1. 安装并打开 CMS Vision（运行版），进入软件初始化向导界面。
2. 在向导中选择 导入/还原工程 选项。
3. 浏览并选择本地的 .cmsproj 工程文件/.cmsbak工程数据。
4. 跟随向导提示完成加载，软件将自动把该工程设为运行工程并启动服务。

方式二：通过管理后台手动导入（通用方式）

适用于已有工程切换、由于某种原因跳过向导或旧版本软件。

1. 打开管理后台：运行 CMS Vision，在 Windows 任务栏右下角找到 CMS 服务监控托盘图标，点击打开后台界面。
2. 进入工程页：在左侧菜单栏点击 “工程” 图标，进入工程管理页签。
3. 导入工程：点击列表上方的 导入 按钮，选择拷贝进来的 .cmsproj 文件。
4. 数据还原（如需）：若有数据备份文件，选中工程后点击 还原，选择数据文件进行恢复。
5. 设为运行工程：成功后，在工程列表中勾选该工程，点击 设为运行工程。
6. 启动服务：点击界面上方的 启动 按钮，等待服务初始化完成即可。

---

3. 常见问题

如果在部署过程中遇到以下问题，请参照对应方案解决：

Q1：工程部署运行后，是否支持修改工程配置，如何进入？

• 支持，点击【主页】，访问Web开发版，即可进入修改。

Q2：Web 开发版修改内容后，Vision 运行版未更新

• 解决方法：在 Vision 运行界面，同时按下 Ctrl + R 或 F12 + F5 强制刷新前端资源配置。

Q3：运行后报错 "An error occurred while saving the entity changes..."

• 原因：文件权限问题。通常是因为使用微信/QQ传输文件时，文件属性被自动设置为“只读”。
• 解决方法：
  1. 右键点击工程文件，选择 属性。
  2. 在常规选项卡中，取消勾选“只读”，点击确定。
  3. 重新导入工程。

​

Q4：工程运行后，界面显示“暂无权限查看当前页面”

• 原因：

  1. 在 v2.34.0 之前的工程版本中，软件权限控制较为严格（完整权限模式），默认全员禁止访问，必须由管理员分配权限后才能访问。
  2. CMS Editor（开发版） 默认使用 超级管理员 (SuperAdmin) 身份登录，拥有所有权限；而 CMS Vision（运行版） 默认以 游客 (Tourist) 身份进入。
  3. 因此，若开发时未手动给游客角色配置对应的页面查看权限，在运行版中就会因权限不足而提示无法查看。

• 解决方法：

  • 方案 A（推荐，适用于 v2.34.0及以上版本）：若项目为简单监控场景（HMI），可在工程设置中将权限模式切换为 “简易模式”（默认全员可访问）。
  • 
  • 方案 B（保留完整权限）：使用超级管理员账号登录运行版，进入权限管理页面，手动为用户（如 Visitor）添加页面访问权限。
  

---

4. 常用配置

启动设置

• 进入 设置 -> 启动：
  • 开机启动：建议开启，确保设备通电后自动运行工程。
  • 客户端关闭时自动退出：根据需求设置。若关闭此项，则关闭前台窗口后，后台服务仍会保持运行。

​

多屏显示

• Vision（运行版）：进入 设置 -> 显示设置，点击“多屏显示设置”，根据现场屏幕数量和分辨率配置窗口布局。

  

• Editor（开发版）：在 运行设置 中也可进行多屏模拟调试。