凯视佳产品文档 产品文档与技术支持

UC3DStudio 运行环境与安装

版本 1.0 · 更新于 2026-10-21 · 阅读 0

UC3DStudio 的系统要求、绿色部署方式、安装目录结构与升级注意（说明书 V1.38 §2）。

适用软件版本 v1.0.29（说明书 V1.38，2026-10-13）。
数据来源：《UC3DStudio 用户说明书》V1.38 §2「运行环境与安装」。

运行环境

项目 要求
操作系统 Windows 10 / 11（64 位）
硬件 x86_64 CPU、≥4GB 内存、USB 3.0 接口（连接传感器）
传感器 KSJXS 系列 UC3D 线激光轮廓传感器（随附 SDK 驱动）

安装（绿色部署）

  1. 将发布包 bin/ 目录整体拷贝到目标机（如 D:\UC3DStudio\）——目录内包含软件本体与 Qt 运行库，请勿拆分。
  2. 首次运行若被安全软件拦截：右键 UC3DStudio.exe → 属性 → 勾选「解除锁定」。
  3. 双击 UC3DStudio.exe 启动。软件禁止多开，已有实例运行时会提示「已在运行中」。

安装目录结构

文件 / 目录 说明
UC3DStudio.exe 主程序
UC3DMeasure.dll 测量算法库
libUC3DStat.dll 统计与制程能力库（SPC/CPK、直方图、正态拟合）
libUc3dComm.dll 通讯输出库（Modbus 从站 + TCP Client 无协议通道）
config.ini 启动配置：[General] 标题栏文案、[Toolbar] 工具栏按钮布局
comm_config.json 通讯通道配置（Modbus / TCP Client 参数与输出项编排）
*.uc3dproj 项目文件：单文件保存全部配置（系统 / 传感器 / 滤波 / 补正 / 检测项 / ROI / 通讯）
themes/*.qss 主题样式（darktech / lightpro / highcontrast）
platforms/ 等 Qt 运行库插件（勿删）
data/ 默认数据保存目录（可在「系统设置」中修改）
license.dat 授权文件（可选，导入后生效）

升级注意

  • 升级前备份 *.uc3dproj 项目文件与 comm_config.json。
  • 新版对旧工程向下兼容（新增属性缺省时走默认值）；降级不保证兼容，回滚请连带恢复项目文件备份。
  • 重新编译后若「限制功能」仍可用，多半是旧 license.dat 仍在用户数据目录下生效（构建过程不清用户数据），并非代码异常——可在启动诊断日志中确认实际加载的 license 路径。

日志：开启「系统设置 → 调试日志」后，运行日志写入 log/debug_*.log（文件名带创建时间，单文件 ≤10MB 自动轮转）。反馈问题时请附带该日志。