- 在官网上申请生成插件开发标识PluginID。
- 编写Plugin配置文件(.plugin),详见第一章“plugin文件配置1-4”。
标签说明:Name
:插件名称。标签不可缺少,值不可为空,Name + PluginId 作为唯一标识。插件名称要小于128字符。Description
:插件描述。标签不可缺少,值可以为空。EntryAssembly
:入口DLL。标签不可缺少,值不可为空。AssemblyList
:专业的其他模块列表。标签可以没有,值可以为空。AssemblyPathList
:插件其他模块的列表所在的路径。相当于添加运行环境变量,标签可以没有,值可以为空。SchemaPath
:Schema的路径。标签不可缺少,值可以为空。填写schema文件所在的文件夹路径,若所填写的路径为无效路径,则插件加载失败。SchemaVersion
:Schema的版本。标签不可缺少,值可以为空。格式要求x.x,若是不符合规则,插件则加载信息失败。注意SchemaPath与SchemaVersion要么同时填写,要么同时为空,否则也会导致插件加载失败。Ribbon
:加载菜单。标签可缺少,值可以为空。填写菜单dll的全路径ActionChDomainKeys
:插件作用的专业,对应MajorConfig中的NAME标签。多个专业使用”,”隔开,如ActionChDomainKeys电气,BIMBase ActionChDomainKeys。标签不可缺少,值可以为空,若是为空,则默认作用专业BIMBase,若为All(区分大小写),则作用当前程序中的所有专业。MajorConfig
:界面配置文件加载路径。标签可缺少,值可以为空。若需要在软件启动界面配置新模块,则需要配置MajorConfig文件(SDK中有模板),并在此指定全路径。MajorConfig文件命名格式要求:MajorConfig_XXX.xml,前缀MajorConfig+自定义名称PluginSDKVersion
:插件研发基于BIMBase的版本。标签不可缺少,值不可为空。格式要求x.x.x。PluginVersion
:插件的版本记录。标签不可缺少,值不可为空。格式要求x.x.x。PluginiD
:插件开发标识。由平台工具生成的32个字符。标签不可缺少,值不可为空。VendorId
:开发者标识。标签不可缺少,值可为空。LoadStatus
:加载状态。标签不可缺少,值可为空,空则为false。 - Plugin配置文件放置位置见第一章图1-4。
- 入口插件dll注册
在入口DLL的dllmain.cpp文件中继承BPPluginFactory
类,实现onLoadPlugin
、onUnLoadPlugin
、initPluginInformation
、loadPluginAssembly
,并通过BPPluginManager
类进行注册、卸载,详见第一章代码示例1-4所示。
展开