的配置文件都采用标准的 XML 语法编写,插件配置内容包含在 <plugin>…</plugin> 标签之间,如下所示:
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<plugin xmlns="http://www.supermap.com.cn/desktop/config" author="SuperMap" description="MapView" name="SuperMap.Desktop.MapView" url="www.supermap.com.cn">
<runtime packageName="MapView.jar" pluginClassName="com.supermap.desktop.mapview.MapViewPlugin" enabled="True" level="5"/>
</plugin>
其中:<?xml version=“1.0” encoding=“utf-8” standalone=“no”?> 是 XML 文件的文件头,用以说明版本信息和采用的字符编码方式,下面详细介绍 <plugin>…</plugin> 标签的各个属性的含义与作用。
- xmlns:为插件配置文件的命名空间,值必须为 http://www.supermap.com.cn/desktop/config。
- author:插件开发者的相关信息。
- description:插件的描述信息。
- name:插件的名称。
- url:插件开发者可以提供一个 URL,供使用者访问或了解相关信息。
<runtime> 标签用于提供插件运行库的信息,其中:
- assemblyName:实现插件的程序集文件名称,可以是相对于可执行程序的相对路径,也可以是绝对路径,该属性的值必须正确设置。
- pluginClassName:实现插件的类名称,该类必须从 Plugin 类继承。这里给定的实现插件的类名称必须是全名,即需要指定其命名空间。该属性的值必须正确设置。
- loadOrder:插件的加载顺序,使用整数来标识插件的加载顺序,该值越小,插件越先加载,该属性的值必须正确设置。注意:当用户新建的插件依赖于系统提供的插件时,必须保证先启动系统提供的插件。
- enabled:用于控制该插件的可见性。true 表示可见;false 表示不可见。
- level:用于控制是否加载该插件。true 表示加载,可以使用该插件;false 表示不加载,禁用该插件。