前言

梦想CAD控件一直专注于二维 CAD 图纸的高性能显示和编辑，帮助众多企业解决了“CAD功能与自身C/S架构软件相结合”的难题。 随着国产操作系统的普遍应用，大量用户反馈：“需要在国产操作系统的软件里集成CAD的功能”，为了满足用户国产系统适配的需求，我们重构了梦想CAD桌面端控件的底层代码，为大家提供了QT C++版本的控件，目前上架了浏览功能，有需要编辑功能的可以联系客服，下面我们讲解一下如何完成部署测试。

一、开发环境准备

确保你的开发环境满足以下最低要求：

1.1、CMake ≥ 3.10（需包含 cmake-gui 工具，用于生成构建系统）

1.2、Visual Studio 2017（用于编译 mxcadviewer 源代码）

二、资源准备

1. 源码解压

下载 mxcadviewer-cpp 源码压缩包（示例：mxcadviewer-cpp(try)(x86_64-windows)(20251218).7z），并解压到指定目录，如下图：  

2. 第三方库下载

1. 进入解压后目录的 3rdparty 子目录；

2. 打开 download_address_cn.txt 文件，查看第三方库下载地址；

3. 下载 3rdparty.7z 压缩包，并解压到当前 3rdparty 目录下。

3. 快速体验（可选）

若需先验证运行效果，可直接双击解压目录下 bin 文件夹中的 MxCADViewer.exe 程序。  

三、项目构建步骤

1. 创建构建目录

在源码根目录下新建 build 文件夹，用于存放 CMake 生成的构建文件，如图：

2. CMake 配置

A.打开 cmake-gui 工具；

B. 源目录：选择 CMakeLists.txt 所在的源码根目录（D:/dev/mxcadviewer-cpp(try)(x86_64-windows)(20251218)）；

C.构建目录：选择刚创建的 build 目录（D:/dev/mxcadviewer-cpp(try)(x86_64-windows)(20251218)/build）；

D.点击界面左下方的 Configure 按钮，开始执行配置流程，如下图：

E. 设置编译器和CPU架构，选择 Visual Studio 15 2017 和 x64，最后点击 Finish 开始配置，如下图：

3. CMake 变量调整与生成

A. 配置完成后，在变量列表中确认/调整以下关键参数：

MX_BUILD_3D：默认勾选（构建 3D 功能），可取消勾选仅构建 2D 功能；

MX_BUILD_LOGIN：默认取消勾选，必须保持取消状态（登录系统代码未开源，勾选会导致编译失败）；

Qt5 路径：自动配置为 3rdparty/qt 目录下的对应路径，无需手动修改。

B. 确认参数无误后，点击 Generate 按钮生成 VS 工程文件。如图：

4. VS 编译运行

A.打开 build 目录下生成的 .sln 解决方案文件；

B.在 Visual Studio 2017 中选择对应编译模式（Debug/Release）；

C.编译并运行 mxcadviewer 项目。

总结

1. 核心前提：确保 CMake ≥3.10、VS2017 环境就绪，且第三方库完整解压到 3rdparty 目录；

2. 关键配置：MX_BUILD_LOGIN 必须取消勾选，避免编译失败；MX_BUILD_3D 可按需选择是否勾选；

3. 构建流程：创建 build 目录 → CMake 配置/生成 → VS 打开 sln 编译运行。