UG NX 2406 + VS2022 C++ 二次开发：从零配置到生成首个DLL的5个关键步骤-平芜编程栈

UG NX 2406 + VS2022 C++ 二次开发：从零配置到生成首个DLL的5个关键步骤

在工业设计领域，UG NX作为一款功能强大的CAD/CAM/CAE集成软件，其二次开发能力为工程师提供了极大的定制化空间。本文将详细介绍如何基于最新版本的UG NX 2406和Visual Studio 2022，从零开始配置C++二次开发环境，并完成首个DLL模块的开发与部署。

1. 开发环境准备与配置

UG NX二次开发环境的搭建需要精确的组件匹配和配置。以下是确保开发环境正确设置的详细步骤：

必备软件清单：

UG NX 2406（已安装并激活）
Visual Studio 2022（建议安装Community或Professional版本）
Windows SDK（与VS2022兼容的版本）

环境配置关键点：

VS2022工作负载选择：
- 安装时务必勾选"使用C++的桌面开发"工作负载
- 额外组件需包含：
  - Windows 10/11 SDK
  - C++ MFC for latest v143 build tools
  - C++ ATL for latest v143 build tools
UG NX开发文件定位：
- 默认安装路径下（如C:\Program Files\Siemens\NX2406\UGOPEN）包含关键开发文件：
  - vs_files文件夹（包含VS模板）
  - include文件夹（头文件）
  - lib文件夹（库文件）
系统环境变量设置：
- 添加UGII_BASE_DIR指向NX安装目录（如C:\Program Files\Siemens\NX2406）
- 添加UGII_USER_DIR指向你的开发工作目录（后续会用到）

提示：建议以管理员身份运行VS2022进行开发配置，避免权限问题导致文件复制失败。

2. VS2022项目创建与属性配置

正确配置Visual Studio项目是二次开发成功的关键。以下是针对UG NX 2406的专用配置方法：

2.1 创建DLL项目

在VS2022中新建项目，选择"动态链接库(DLL)"模板
命名项目（如FirstNXPlugin），选择合适的位置
确保项目平台设置为x64（UG NX只支持64位开发）

2.2 关键属性配置

在项目属性页中，需要进行以下关键设置：

C/C++ → 常规：

附加包含目录添加：

$(UGII_BASE_DIR)\UGOPEN\include $(UGII_BASE_DIR)\UGOPEN\cpp\include

链接器 → 常规：

附加库目录添加：
```
$(UGII_BASE_DIR)\UGOPEN\lib
```

链接器 → 输入：

附加依赖项添加以下库文件：

libufun.lib libugopenint.lib libvmathpp.lib libnxopencpp.lib libnxopenuicpp.lib

预处理器定义：

添加：

_CRT_SECURE_NO_WARNINGS _SILENCE_ALL_CXX17_DEPRECATION_WARNINGS

配置完成后，建议将属性设置保存为属性表（.props文件），方便后续项目复用。

3. 编写首个UFUN函数模块

UG NX二次开发的核心是UFUN（User Function）函数库。下面我们创建一个简单的长方体生成模块。

3.1 基本代码结构

在主要源文件（如dllmain.cpp）中添加以下代码框架：

#include "pch.h" #include <uf.h> #include <uf_modl.h> #include <uf_ui.h> #define UF_CALL(X) { \ int _status = (X); \ if (_status != 0) { \ char _msg[256]; \ UF_get_fail_message(_status, _msg); \ UF_UI_write_listing_window(_msg); \ } \ } extern "C" DllExport void ufusr(char* param, int* retcode, int paramLen) { if (!UF_CALL(UF_initialize())) { // 实际功能代码将放在这里 UF_CALL(UF_terminate()); } } extern "C" DllExport int ufusr_ask_unload() { return UF_UNLOAD_IMMEDIATELY; }

3.2 添加几何创建功能

在ufusr函数中添加长方体创建代码：

UF_FEATURE_SIGN sign = UF_NULLSIGN; double block_orig[3] = { 0.0, 0.0, 0.0 }; // 原点坐标 char* block_len[3] = { "50.0", "30.0", "20.0" }; // 长宽高尺寸 tag_t blk_obj; // 对象标识 UF_CALL(UF_MODL_create_block1(sign, block_orig, block_len, &blk_obj));

这段代码将在坐标系原点创建一个50×30×20的长方体。

3.3 编译与错误处理

编译时需注意：

确保项目平台工具集与NX版本匹配（v143 for VS2022）
若出现字符集相关错误，可将项目属性中的字符集设置为"使用多字节字符集"
遇到链接错误时，检查库文件路径是否正确

4. 部署与调试技巧

完成DLL编译后，需要正确部署才能被UG NX加载。

4.1 文件部署结构

建议采用以下目录结构：

MyNXDev/ ├── startup/ # 存放DLL和菜单文件 ├── application/ # 存放对话框资源 └── config/ # 配置文件

4.2 环境变量配置

确保系统环境变量UGII_USER_DIR指向你的开发目录（如D:\MyNXDev）
对于调试版本，可添加UGII_DEBUG_SHLIB环境变量并设置为1，启用调试输出

4.3 调试配置

在VS2022中配置调试：

项目属性 → 调试
- 命令：指向UG NX可执行文件（如C:\Program Files\Siemens\NX2406\NXBIN\ugraf.exe）
- 工作目录：设为UG NX安装目录
使用UF_UI_write_listing_window输出调试信息到NX信息窗口

4.4 快速测试方法

将生成的DLL复制到startup目录
启动UG NX，新建或打开一个部件文件
按Ctrl+U，选择你的DLL文件执行
观察是否成功生成长方体

5. 进阶开发与优化

掌握基础开发后，可通过以下方式提升开发效率和质量。

5.1 常用开发模式对比

开发模式	入口函数	适用场景	优点	缺点
ufusr	ufusr	简单功能	部署简单	交互性差
ufsta	ufsta	交互功能	支持菜单调用	配置复杂
UI Styler	自定义	复杂界面	可视化设计	学习曲线陡

5.2 代码优化建议

错误处理增强：

int result = UF_initialize(); if (result != 0) { char err_msg[133]; if (UF_get_fail_message(result, err_msg)) { UF_UI_write_listing_window(err_msg); } *retcode = result; return; }

资源管理：

使用RAII模式管理UF会话
确保每个UF_initialize()都有对应的UF_terminate()

性能优化：

批量操作使用事务处理
减少不必要的对象选择操作

5.3 扩展开发能力

菜单集成：创建.men文件示例：

VERSION 120 EDIT UG_GATEWAY_MAIN_MENUBAR BEFORE UG_HELP CASCADE_BUTTON MY_MENU LABEL My Tools END_OF_BEFORE MENU MY_MENU BUTTON CREATE_BLOCK LABEL Create Block ACTIONS my_plugin.dll END_OF_MENU