为了支持多平台,AutoCAD实现了大分离,我们两年前已经介绍了这个概念,但是很多人对怎么实现大分离还是不甚了解。我们的Autodesk开发部Spiderman团队的吴忠写下了这篇教程,我只是负责发表一下,方便大家阅读。
附带有经典例子Polysamp的移植录像,在本文的最后提供了下载链接。
目录
1 概要
2 开发前提
3 Dbx/Arx 模块移植步骤
4 附录
Bundle 格式和简单说明
概要
AutoCAD易只支持Dbx 和 Crx模块,不支持Arx 模块,第三方应用需要把他们的应用程序先拆分成Dbx/Crx/Arx模块或者Crx/Arx 模块
Dbx模块中一般是包含 database相关的,比如自定义实体。该模块会链接到acdb**.dll。Crx模块中一般是包含一些 In-Canvas相关的 UI,比如command等等。当然,所有Dbx 中的内容也可以包含在Crx中。该模块会链接到accore.dll。
Arx
模块一般是包含一些 Out-Canvas相关的UI,比如dialog,菜单等。该模块会链接到acad.exe。 同样的,所有Dbx,Crx中的内容也同样可以包含在Arx模块中。但是如果第三方应用需要能被AutoCAD易支持,那么第三方应用需要把Out-Canvas UI相关的代码都拆分到 Arx模块中,因为在 AutoCAD易中,所有Out-Canvas UI相关的内容都需要用JavaScript重新来实现。
开发前提
2013 版本的 ObjectArx。
Dbx/Arx 模块移植步骤
1.
对于Dbx模块,我们不需要做任何处理。对于Arx模块,首先,需要更新工程文件中的 设置:把Target Extension从”.arx”改成”.crx”,添加accore.lib模块作为Additional Dependencies,同时把acad.lib从 AdditionalDependencies中删除。
2.
然后需要把原 Arx 模块中所有Out-Canvas UI相关的内容都移植到一个新的Arx模块中。 可以通过编译该工程来发现所有链接错误,然后把这些错误链接都移植到新的Arx模块 中(在 Polysamp 例子中,原Arx 中有一些菜单相关的UI,这些都需要被移植到新的Arx 模块 中,因为该例子只需要支持AutoCAD易,所以这些都被直接注释掉,详见polymnu.cpp文件。 对于只需要支持AutoCAD易的应用,第三方也可以这样去快速处理)。
3.
利用 JavaScript 来重新改写Out-Canvas UI,Autodesk正在提供更多的支持使用户今后能 方便的重写这些 UI。
4.
创建一个Bundle来描述您的模块,可以参考Ploysamp例子中的asdkpolyui.bundle。关于Bundle,可以查看附录中的简要描述。
5.
把applicationboudle放在指定的目录下面folder(\\ProgramFiles\Autodesk\ApplicationPlugins或者\\User RoamingFolder\Autodesk\ApplicationPlugins),AutoCAD易会自动搜索这两个目录下面的bundle,并 且自动去加载它们。
附录
Bundle:
Bundle 格式和简单说明
Bundle 就是一个文件包,里面包含一些简单的文件结构。第三方开发可以按照自己意愿去创建任意的子文件夹,但是Xml文件(PackageContents.xml)必须放在根目录下,而且文件夹必须以”.bundle”结尾。
下面是 Polysamp 的文件结构例子(蓝色是文件夹,黑色是文件),该例子非常简单,只描述了dbx和 crx 模块,后面我们还会加入UI的部分,包括 cuix, icon等等。
- asdkpolyui.bundle
- PackageContents.xml
- Contents
- Win32
- Asdkpolyobj.dbx
- asdkpolyui.crx
- Win64
- Asdkpolyobj.dbx
- asdkpolyui.crx
- PackageContents.xml的内容如下:
- <?xmlversion="1.0" encoding="utf-8" ?>
- <ApplicationPackageSchedmaVersion="1.0" ProductCode="{60E86427-9C47-4882-B3A5-
- 2D2ACC05FD75}"
- Name="Polysamp"NameEnu="Polysamp" NameDeu="PolySamp"
- Version="1.0"
- Description="CADRenSample packageXml" DescriptionEnu="Poly samp for CADRen"
- DescriptionDeu="CADRenSample packageXml"
- Author="WilliamWu"
- >
- <CompanyDetails
- Name="WilliamSoft"
- Phone="02138653768"
- Url="www.cadren.com"
- Email="zhong.wu@autodesk.com"
- />
- <Components>
- <RuntimeRequirementsOS="Win32|Win64" Platform="AutoCAD" SeriesMin="R18"
- SeriesMax="R18.2"/>
- <ComponentEntry
- AppName="AsdkPolyCAD"
- ModuleNameWin32="./Contents/Win32/asdkpolyui.crx"
- ModuleNameWin64="./Contents/Win64/asdkpolyui.crx"
- AppDescription="PolySample UI for CADRen"
- LoadOnAutoCADStartup="True"
- LoadOnCommandInvocation="True"
- >
- <CommandsGroupName="ASDK_POLYGON">
- <CommandGlobal="ASDK_POLY" Local="POLY" />
- <CommandGlobal="PPOLY" Local="PPOLY" />
- <CommandGlobal="ASDK_DRAGPOLY" Local="DRAGPOLY" />
- <CommandGlobal="ASDK_POLYEDIT" Local="POLYEDIT" />
- <CommandGlobal="ASDK_TRANSACT" Local="TRANSACT" />
- <CommandGlobal="ASDK_HILITPOLY" Local="HILITPOLY" />
- <CommandGlobal="ASDK_HILITSOLID" Local="HILITSOLID" />
- <CommandGlobal="ASDK_CREATEINSERT" Local="CREATEINSERT" />
- <CommandGlobal="ASDK_HILITINSERT" Local="HILITINSERT" />
- <CommandGlobal="ASDK_USEDRAGDATA" Local="USEDRAGDATA" />
- <CommandGlobal="ASDK_POLYCLEANUI" Local="POLYCLEANUI" />
- </Commands>
- </ComponentEntry>
- <ComponentEntry
- AppName="AsdkPolyCAD_DBX"
- ModuleNameWin32="./Contents/Win32/asdkpolyobj.dbx"
- ModuleNameWin64="./Contents/Win64/asdkpolyobj.dbx"
- AppDescription="CustomPoly Object"
- LoadOnAutoCADStartup="True"
- >
- </ComponentEntry>
- </Components>
- </ApplicationPackage>
复制代码 下载Polysamp移植录像 |