简介面向CATIA二次开发入门者的环境搭建文档围绕CAA、RADE与Visual Studio 2005的安装及联调配置展开帮助初学者跨过专业软件部署这道门槛。内容按VS2005含MSDN帮助文档、CATIA V5R19虚拟光驱挂载、根目录安装与破解、CAA完全安装、第二张光盘切换、include解压、RADE安装、破解文件替换、许可证注册以及CATVBTSetup开发环境搭建的顺序推进每一步都配有界面截图与文字说明并记录了作者摸索过程中遇到的问题与处理办法。压缩包内为1个doc文档约4.8MB可直接查阅或打印后对照操作。目前已有5407人学习适合刚接触CATIA二次开发、需要一份可照做配置清单的高校学生与工程技术人员。1. CAARADE 这套环境到底卡在哪一份十多年前的装机笔记为什么还值得翻装 CATIA 二次开发环境的人十个里有八个会在第三天卡住——不是 C 不会写而是装完 RADE 之后VS2005 的菜单里那个 Open CAA V5 Workspace 根本点不出可用的东西。这份流传于 2011 年前后的装机笔记记录的恰好是 CATIA 二次开发里最脏、最绕、也最没法跳过去的一段CAA、RADE、VS2005 三件套的安装与串联。它不讲几何内核也不讲 C 语法只解决一件事——让一个从没碰过 CAA 的人在一台干净的 32 位 Windows 上把 Mkmk 工作空间建起来把 CAASysCallBack 编译通过让整条链路真正跑通。适合手里已经有安装介质、却被环境拦在门外的在校生和刚转岗的工程师也适合需要给新人搭一台“能编译”的机器、又不想每次从头回忆的老手。2. 装之前先把目录和版本固定下来四个决定成败的前置约定这套环境的坑八成都不是装的时候踩的是装之前没想清楚埋下的。CAA 和 RADE 不是那种“装上就能用”的普通软件它们要往 CATIA 的安装树里插东西、要往 VS 的注册表里写插件、要靠一堆环境变量互相找得到对方。任何一个路径对不上最后的表现都长一个样菜单是灰的或者点了弹一个说不清原因的对话框。所以正经干活之前先把下面四件事定死后面能省掉至少两次重装。2.1 版本矩阵VS2005、V5R19、CAA、RADE 为什么必须成套CAA 这条技术栈对版本是硬绑定不是“差不多就行”。RADE 安装完了要在 VS 里注册一个叫 CAA V5 Workspace 的插件这个插件是按特定 VS 版本的 COM 接口编的CAA 的编译工具链 mkmk 又要求 Tool level 和 CATIA 主版本严格对齐V5R19 对应的就是V5R19_B19填错一位工作空间能打开但一编译就报找不到 framework。这也是为什么笔记里写死 VS2005那个年代的 CAA 只认 VS2003 和 VS2005你装 2008 或 2010RADE 的安装程序可能连插件都注册不进去或者注册进去了菜单也点不动。我一般会把版本关系直接写成一张表贴在机器旁边避免装到一半凭记忆去猜组件版本关键约束Visual Studio2005必须含 C、C#、.NET、VB且装 MSDNCATIAV5R19 SP032 位装在盘符根目录如D:\catia_v5r19CAA与 V5R19 配套安装目录必须指向 CATIA 安装目录RADE与 V5R19 配套与 CATIA 目录平级如D:\RADE编译工具链mkmkTool level 选V5R19_B19装之前在纸上确认这五行全部对得上比装完再排查省事得多。特别注意那位“32 位”这套组合里所有二进制都是 x86 的64 位系统上跑得起来但目录、DLL 和许可文件全按 32 位布局走混着装 x64 版本会把 JS0GROUP.dll 这类共享库的版本搞乱。2.2 目录规划为什么 CATIA 和 RADE 都要装在盘符根目录笔记里反复强调“安装目录为本地盘符的根目录”很多人当废话一路回车结果后面就翻车。原因不玄学CAA 的 framework 路径是拼接出来的CATInstallPath会去拼intel_a\code\bin、CAADoc\Doc、win_b64这里是win_b32/intel_a这些固定子目录路径层级越深拼出来的绝对路径越长而 mkmk 和部分老工具对路径长度、对空格和中文都极其敏感。装在D:\Program Files\Dassault Systemes\B19\这种带空格的路径下编译脚本里没加引号的地方会当场断掉。所以定两个目录CATIA 装D:\catia_v5r19RADE 装D:\RADE两者平级。平级不是审美问题RADE 的CATVBTSetup.exe需要你去指定 CATIA 的安装目录它据此去 CATIA 的 bin 下找依赖库如果 RADE 被塞进 CATIA 目录里面某些相对路径解析会跑偏。我自己习惯在装之前先建好这两个空目录装的时候直接选省得安装程序帮你新建一个带空格的默认路径。另外整个路径上不要出现中文用户名是中文的都建议新建一个纯英文的本地账户再开干。2.3 标识、环境目录与安装类型三个容易被一路回车带过的选项安装向导里有三处特别容易被无脑下一步糊弄过去。第一处是标识IdentifierCATIA、CAA、RADE 三次安装都会问它不是一个随便填的名字而是这套环境在注册表和环境变量里的身份三处填的必须是同一个值否则 RADE 找不到它该挂到哪个 CATIA 上。第二处是环境目录向导会给你一个默认值如果提示目录不存在就选“是”让它新建——这一步千万别跳过跳过之后环境变量文件没生成后面启动 CATIA 会直接报环境错误。第三处是安装类型CAA 和 RADE 都必须选完全安装。很多人觉得“我只写 C不装文档行不行”不行。CAA 的完全安装里包含了编译要用的头文件、库、工具链和文档缺一块编译时就是一堆找不到符号的错误而且报错信息不会告诉你是哪个组件没装。联机文档那一页倒是可以选不装——那是给 CATIA 用的在线帮助跟开发链路无关装了纯粹占硬盘。2.4 许可与授权文件的放置原则这里只讲原则具体文件按你手上的合法授权介质和供应商说明来。整套组件的许可分成两层CATIA 侧和 RADE 侧。CATIA 侧的许可是在安装完成后、通过供应商提供的许可配置流程完成的配置没走完之前 CATIA 主程序是打不开的这不是故障是设计如此。RADE 侧则依赖一组放在D:\RADE\intel_a\code\bin下的可执行组件以及一个从 CATIA 的 bin 目录复制过来的共享库。关于那个共享库原理值得说清楚JS0GROUP.dll是 CATIA 的基础运行时库RADE 的编译和链接过程会调用到它。如果 RADE 目录下自带的版本和 CATIA 主程序的版本对不上表现出来就是编译能过、一运行就崩或者在 CATVBTLicenser 里点 Apply 之后没有任何回执。所以流程是反过来的先确认 CATIA 已经能独立启动再把 CATIA 的JS0GROUP.dll复制到 RADE 的 bin 下覆盖让两边的运行时严格一致。顺序搞反等于拿一个来路不明的库去覆盖一个正常的库。3. VS2005 与 CATIA V5R19 正式安装从虚拟光驱到 intel_a\code\bin这一章是纯操作但每一步都带着“为什么”。顺序上必须先 VS 后 CATIA因为 RADE 安装时会往 VS 里注册插件VS 不在插件无处可挂而 CAA 又要装进 CATIA 的目录树CATIA 不在CAA 的安装程序会直接拒绝往下走。所以链条是VS2005 → CATIA → CAA → RADE一个都不能调换。3.1 VS2005组件勾选与 MSDN 的必要性VS2005 安装时重点只有两个。一是组件VB、.NET、C#、C 四项在笔记里被标为必装。实际情况是 CAA 的工程模板和部分工具依赖 .NET 运行时和 C# 的编译组件你只勾 C 也能装完但后面在 VS 里挂 CAA 插件、或者在解决方案里展开 CAA 的托管节点时会缺东西。二是 MSDN 帮助文档很多人嫌它占空间跳过然后第一次写 CAA 代码就抓瞎——CAA 的 API 命名和参数约定跟普通 Win32 完全是两套风格没有本地文档查一个接口签名能翻半天。安装完成后先别急着装 CATIA启动一次 VS2005 确认能正常进入主界面顺便看一眼“工具 → 选项”里有没有异常。这一步是给自己留个基准点后面 RADE 装完如果 VS 启动报插件加载失败你能立刻判断是 RADE 带来的问题而不是 VS 本身没装好。我一般还会在这一步把 VS 的默认解决方案目录改到一个纯英文短路径下避免后面 CAA 工程生成时路径过长。3.2 CATIA V5R19镜像挂载与七个安装页面的决策点CATIA 的安装介质是 ISO先用虚拟光驱工具挂载再运行里面的 setup。整个向导有七八个页面大部分可以默认但有几个必须自己拿主意。把决策点整理成下表装的时候照着走页面选择说明目标文件夹D:\catia_v5r19必须盘符根目录目录不存在则新建标识与后续 CAA、RADE 一致三处必须同一值环境目录默认不存在则新建生成环境变量文件不能跳过安装类型完全安装缺组件后面编译会莫名报错后续默认页直接下一步无需改动联机文档不安装与开发链路无关确认页点安装等待完成不要中断装完之后先别双击图标许可没配置之前打不开是正常的。这时候正确的动作是去D:\catia_v5r19\intel_a\code\bin下确认目录结构完整——这个code\bin是整个技术栈的枢纽后面 CAA 的编译输出、RADE 的许可组件、VS 的调试配置全要往这里对。目录不存在或者里面只有零星几个文件说明安装没走完别急着往下装 CAA。3.3 许可配置与首次启动验证许可配置按你手上合法授权介质附带的说明执行配置完成后第一次启动 CATIA。这一步的验收标准很朴素主界面能正常打开新建一个 Part 能进草图退出时不报错。三个动作都过说明 CATIA 这一层是健康的可以往上叠 CAA 了。如果启动时报环境相关的错误八成是 3.2 里环境目录那一步跳过了回去检查环境变量里有没有指向D:\catia_v5r19的条目。这里有个血泪经验CATIA 首次启动会初始化一堆用户配置这个过程不要在远程桌面或者分辨率异常的会话里做也不要在装了一半的时候强杀进程。初始化没写完后面 CAA 的CATVBTSetup去读 CATIA 的配置目录时会读到半截文件表现是 Target 页面选完目录点 OK 没反应也不报错就干耗着——这个现象我在两台机器上见过最后都是删掉用户配置目录重来才好的。3.4 装完先做一次目录自检在装 CAA 之前花两分钟把关键目录列一遍比装完再回头找问题快得多。在 cmd 里跑:: 检查 CATIA 安装树的关键子目录是否存在 dir /b D:\catia_v5r19 :: 应能看到 intel_a、CAADoc 等目录 dir /b D:\catia_v5r19\intel_a\code\bin :: 应能看到大量 dll 和 exe这是后续所有配置的基准第一行确认根目录下有没有intel_a和CAADoc。intel_a是 32 位平台的二进制目录CAADoc是文档和示例 framework 的所在CAA 安装时会往这里写东西RADE 的CATVBTSetup又要去CAADoc\Doc找文档路径两个都在才说明 CATIA 装完整了。第二行确认code\bin里有没有成规模的 DLL如果只有几个文件说明“完全安装”没生效这时候装 CAA 只会把问题往后推。命令本身没什么技术含量关键是养成“每装一层就验一层”的习惯。这套环境的故障有个特点后一层的报错往往是前一层没装好导致的如果你不在每层之间设检查点最后面对的就是一个笼统的“工作空间打不开”排查范围大到离谱。4. CAA 与 RADE 联调把开发框架挂到 CATIA 的目录树上CAA 和 RADE 的关系很多新手一开始是懵的两个都要装都要跟 CATIA 版本配套那它们到底谁是谁的上位简单说CAA 是那套庞大的开发框架和文档体系它必须长在 CATIA 的安装树里因为它要复用 CATIA 的库和头文件RADE 是快速应用开发环境提供 VS 里的插件、mkmk 的封装和一键编译的能力它独立于 CATIA 目录存在靠配置去“指向”CATIA。理解了这层后面每一步为什么这么选就都顺了。4.1 CAA 安装为什么必须落在 CATIA 安装目录里CAA 的安装向导第一页之后就会问安装目录这里必须选D:\catia_v5r19也就是 CATIA 的根不是它下面的某个子目录。原因在于 CAA 装进去之后会往intel_a、CAADoc这些既有目录里合并文件编译时要用的头文件和静态库就散落在这套结构里路径是相对 CATIA 根来解析的。你如果把它装到D:\CAA这种独立目录装是能装完但后面 mkmk 编译时找不到CATInstallPath下的库报的错还特别含糊。安装类型同样选完全安装。中途会提示插入第二张盘这时候把 CAA 的第二张光盘映像挂到虚拟光驱里再点确定向导会继续从新挂载的盘符读文件。这里有个细节不要在第一张盘还挂着的时候去“弹出”它虚拟光驱的盘符一变向导缓存的路径就失效了表现是卡在某个百分比不动。稳妥做法是先挂第二张确认盘符出现再回向导点确定。CAA 装完后还有一步收尾把include.rar解压到D:\catia_v5r19。这个压缩包里是 CAA 的头文件集合解压后会在 CATIA 根下形成 include 目录结构。这一步漏了编译时第一个报错就是找不到CATSysFoundation.h之类的头文件。解压时注意别多套一层文件夹要让 include 目录直接出现在D:\catia_v5r19下面。4.2 RADE 安装与二进制文件对齐RADE 装到D:\RADE与 CATIA 平级。向导里的标识要跟前两次填的一致环境目录用默认值、不存在就新建安装类型选完全安装。装完之后它还不能用需要做一轮二进制对齐这一步是整个流程里最容易出错的地方我按顺序拆开说。第一步把授权介质里那组 RADE 侧的可执行组件LaunchCommandControl.exe、mkmkM.exe、mkstepM.exe、ReleaseServer.exe放到D:\RADE\intel_a\code\bin下覆盖同名文件。这四个分别对应启动控制、mkmk 编译、步骤编译和许可服务缺一个编译链路就在对应环节断掉。第二步把D:\catia_v5r19\intel_a\code\bin\JS0GROUP.dll复制到D:\RADE\intel_a\code\bin并覆盖。前面说过这是为了让 RADE 侧的运行时和 CATIA 主程序严格同版本。覆盖之前建议把 RADE 自带的那个备份一下万一后面出问题还能回退。第三步运行D:\RADE\intel_a\code\bin\CATVBTLicenser.exe在弹出的界面里把右侧的选项全部勾上点 Apply。这个工具做的是 RADE 侧的许可登记勾选不全的话编译时会在链接阶段报许可类错误错误码和“找不到库”长得很像容易误判。点完之后要看到成功提示没有提示就说明前面某一步的文件没放对位置。4.3 CATVBTSetup把 RADE 和 CATIA 正式接起来CATVBTSetup.exe也在D:\RADE\intel_a\code\bin下它的作用是把 RADE 和 CATIA 的路径关系写进配置让 VS 里的插件知道去哪找 CATIA。运行后会弹一个提示忽略它继续。界面上两个关键项选项填写内容作用Target → Installation DirectoryD:\catia_v5r19告诉 RADE 去哪找 CATIA 的库和 binDocumentation → Documentation installation PathD:\catia_v5r19\CAADoc\Doc指定本地文档路径供 VS 内联帮助使用填完点 OK看到验证消息就说明写进去了。这里最常见的翻车是 Documentation 那栏路径填错——CAADoc\Doc这个子目录是 CAA 装完之后才有的如果你在装 CAA 之前就跑了 CATVBTSetup这个目录不存在工具可能不报错但写入一个无效路径后面在 VS 里查文档就是一片空白。所以顺序一定要守住CATIA → CAA含 include 解压→ RADE → CATVBTSetup。4.4 在 VS2005 里建立第一个 CAA 工作空间前面全是铺垫到这一步才真正进到开发工具里。先在D:\catia_v5r19下新建一个工作空间目录比如CAAWorkspaceR19然后把CAADoc下的CAASystem.edu整个文件夹复制进去。这个.edu目录是一套官方示例框架包含 IdentityCard、源码和 mkmk 描述文件拿它当第一个工程最省事因为它的依赖最少、结构最标准。打开 VS2005走“文件 → Open CAA V5 Workspace”With 下拉选MkmkWorkspaceDirectory 选刚才那个CAAWorkspaceR19Tool level 选V5R19_B19点 OK。会先弹一个警告点 OK再提示工作空间里没有工程点确定。然后展开树形结构找到CAASysCallBack.m这个文件选中点 OK。VS 的解决方案视图里就会出现框架节点了。还没完。菜单栏此时多出 CAAV5Workspace 菜单点开选Locate Prerequisite Workspaces...Mode 选Access prerequisites from their origin location然后在下方的 Origin for prerequisite Frameworks 里点 Add把D:\catia_v5r19加进去点 OK。这一步是告诉编译系统“依赖的框架在 CATIA 安装目录里”不加的话编译时所有 CATIA 提供的库都会被判为找不到。5. 避坑与排查七个让你重装三次的细节这套环境最气人的地方是错误信息几乎没有指向性。同一个“工作空间打不开”可能是路径有空格可能是标识不一致也可能是某个 DLL 版本不对。下面这几条是实际装机里反复出现的按“现象 → 原因 → 解决”记下来出问题时对着查。5.1 安装阶段路径、盘符与权限现象一CAA 安装到一半卡住不动进度条停在同一位置十几分钟。原因基本是第二张盘没挂上或者挂上之后盘符变了而向导还在等原来那个盘符。解决方法是先确认虚拟光驱里已经是第二张映像盘符在资源管理器里能看到再回向导点确定如果已经卡死只能结束进程删掉 CAA 装了一半的残留目录重来不要试图在原目录上覆盖安装。现象二CATIA 能装完但一启动就报环境错误或者干脆闪退。八成是安装时环境目录那一步选了“否”或者跳过了导致环境变量文件缺项。解决方法是重新跑一次安装程序选修复或者手工确认系统环境变量里有指向D:\catia_v5r19的条目。还有一种可能是安装路径里带了空格或中文这种情况改不回来只能卸了重装到纯英文短路径。现象三许可配置工具点了没反应或者 Apply 之后没有任何回执。原因通常是前面某个文件放的目录不对或者JS0GROUP.dll还是 RADE 自带的旧版本。解决方法是按 4.2 的三步重新走一遍重点确认四个可执行组件确实落在D:\RADE\intel_a\code\bin而不是它的上级目录以及 DLL 的复制方向没有搞反。5.2 工作空间阶段没有工程、找不到 Prerequisite现象四Open CAA V5 Workspace 之后提示工作空间里无工程展开树也看不到.m文件。原因通常是CAASystem.edu复制的位置不对——它必须直接在工作空间根目录下而不是再多套一层。另一个可能是 Tool level 选错选成别的版本号插件认不出这套 framework。解决方法是检查目录层级确认工作空间根下有CAASystem.edu文件夹再核对 Tool level 是否为V5R19_B19。现象五编译报大量“找不到头文件”或“无法解析的外部符号”。前者是include.rar没解压到 CATIA 根或者解压时多套了一层目录后者是Locate Prerequisite Workspaces里没加 CATIA 安装目录或者加了但 Mode 选错。解决办法是先dir确认D:\catia_v5r19\include存在且有内容再回 VS 的 CAAV5Workspace 菜单里重新配一次 Prerequisite。现象六VS2005 启动时提示加载项失败CAA 菜单不出现。原因是 RADE 装在了 VS 之后但注册插件失败常见于装 VS 时跳过了 .NET 相关组件。解决办法是确认 VS2005 的 .NET 组件完整然后重新运行 RADE 的安装程序选修复让它重走一遍插件注册。修完重启 VSCAAV5Workspace 菜单应该就回来了。5.3 环境变量与多版本共存现象七机器上同时装过别的 CATIA 版本装完这套之后编译行为诡异。原因是环境变量里存在多个CATInstallPath或同类变量后写的覆盖了先写的导致 RADE 找错 CATIA。解决办法是在系统环境变量里逐个检查只保留指向D:\catia_v5r19的那一份其余删掉或改名然后重启 VS 让新环境生效。多版本共存不是不能做但必须靠独立的环境变量文件隔离不能指望默认那一套自己分清楚。这条坑值得多说一句尽量不要在同一台机器上装两套 CAA 环境给不同版本用除非你很清楚环境变量文件怎么切换。我见过为了省事把 V5R19 和另一个版本装在一起结果两个的工作空间互相串编译出来的东西运行时崩得莫名其妙最后只能重装系统。如果确实有并行需求用虚拟机做隔离成本远低于排查串环境的时间。6. 在 VS2005 里跑通 CAASysCallBack一次可复现的验收环境装完最后要做的是“验收”。验收不是看菜单有没有出现而是真的把示例工程编译一次、运行一次确认整条链路通。以CAASystem.edu里的CAASysCallBack为目标动作分三步。第一步在 VS 的解决方案视图里选中CAASysCallBack的框架节点右键看有没有 Build 相关选项。如果有直接编译如果菜单是灰的说明 Prerequisite 没配好回第 4.4 节重做Locate Prerequisite Workspaces。编译前顺手打开该框架下的IdentityCard.h确认里面声明的依赖框架名拼写正确——这是 CAA 里最容易被手滑改坏的文件一个字母错了编译报错会指向完全无关的头文件。第二步编译时打开输出窗口盯住三个阶段mkmk 解析 framework、逐个编译源文件、链接生成 DLL。三个阶段里任何一个失败报错的位置都直接对应前面某一章解析失败查 Prerequisite编译失败查 include 路径链接失败查许可和库版本。这种“报错位置反查配置层”的思路比逐条读错误信息有用得多。第三步编译成功后到输出目录确认 DLL 生成文件名和框架名对得上时间戳是刚才那一次。然后回到 CATIA 里加载这个 DLL 做一次最小功能验证——示例本身做的事情很简单能加载、能不崩就说明运行时库版本是对齐的。这一步过了整个环境才算真正可用。我自己的习惯是每搭好一台机器就把这台机器的最终验证结果记一行日期、各组件版本、编译通过的框架名、CATIA 加载是否正常。后面再遇到“同样的步骤为什么这台就不行”第一件事是把这一行拿出来对照往往差异就在某个被忽略的小版本上。从那以后我每次给新人配环境都强制走一遍这个三步验收绝不允许“装完看起来没问题”就算结束——这套环境里看起来没问题的机器通常只是还没到报错的时候。希望帮到你。本文还有配套的精品资源点击获取
