Bundle是整个清单文件的根节点。该节点用于定义模块的特征名称（唯一标识）、 名称、版本号、模块在平台启动后的初始状态、启动级别、宿主模块标识、宿主模块版本 和命名空间属性。模块的特征名称是必须填写的属性，命名空间用于在编写XML文件时获得 智能提示。该节点的结构如图4-3所示。

图4-3 Manifest.xml文件Bundle节点定义

Bundle节点的属性的详细描述如下：

1. xmlns：定义了清单文件的名字空间，其值固定为"urn:uiosp-bundle-manifest-2.0"。
2. SymbolicName：插件的唯一名称，必填属性。
3. Version：插件的版本，比如1.2.0.3，默认为1.0.0.0，可选属性。
4. Name：插件的名称，可选属性。
5. InitializedState：平台加载插件后，插件处于的默认状态，其默认值为Active，可选属性。
6. StartLevel：插件的启动级别，启动级别越小优先级越高，越先被启动，普通插件的启动级别一般大于等于2，可选属性。
7. HostBundleSymbolicName：插件的宿主唯一名称，一旦声明了该属性，则当前插件便是一个片段插件。片段插件不能被当成宿主插件来使用，它仅是作为宿主的一部分而存在，在宿主解析时，会自动将片段插件的定义附加到宿主。 因此片段插件不能定义StartLevel、InitializedState和Activator，且不能从片段加载类或者资源。如果需要加载，必须通过其宿主来实现。
8. HostBundleVersion：宿主插件版本约束，可以不填写（版本无关）、固定的版本（1.0.0.0）或者某一范围版本（[1.0, 2.0)）。

Bundle节点还包含：至多一个Activator节点、一个Runtime节点、至多一个Services节点 、若干ExtensionPoint节点、若干Extension节点和至多一个BundleInfo节点。

该节点定义一个模块启动和停止的入口。Activator节点的XML结构如图4-4所示。

图4-4 Manifest.xml文件Activator节点定义

该节点由Type和Policy属性组成。它们的描述如下：

1. Type：插件激活器类型全名称，比如ConsolePlugin1.Activator，该类型必须实现IBundleActivator接口，必填属性。
2. Policy：激活策略，Immediate或者Lazy，分别为立即激活或者晚激活。立即激活是指一旦插件执行启动，激活器的Start(IBundleContext context)会被调用并进入Active状态；而晚激活则是一旦插件执行启动，只是将状态变为Starting，而激活器的Start(IBundleContext context)方法会推迟到直到从该插件加载一个类型时才调用，从而进入Active状态。该属性为可选属性。

该节点定义了模块的类型空间。模块类型空间是指模块可访问的类型的集合，它 决定了一个模块向外提供的功能。UIOSP平台中，每一个模块都具有其独立的类型空间和 类加载器，类加载器用于从其类型空间中加载类型。模块类型空间由本地程序集和依赖 的其它模块的程序集构成。Runtime节点的XML结构如图4-5所示。

图4-5 Manifest.xml文件Runtime节点定义

该节点由Assembly和Dependency节点组成，分别表示模块本地程序集和依赖程序集。 它们的描述如下。

Assembly节点

Dependency节点

Services节点用于声明一个模块向外暴露的服务，这些服务在模块启动时自动注册到UIOSP 平台，并在模块停止时从平台卸载。模块可以通过两种方式向平台注册服务，一种方法是通过激活器 的Start方法中的IBundleContent类型参数的AddService来注册，另一种方法是通过Manifest.xml 的文件Services节点来注册服务。Services节点的结构如图4-6所示。

图4-6 Manifest.xml文件Services节点定义

Services节点由若干个Service节点组成，Service节点用于表示一个具体的服务， 该节点由Interface和Type属性组成，它们的描述如下：

1. Interface：服务的接口全名称，即该服务的契约，使用“,”分割多个接口，如ConsolePlugin1.IMyService1,ConsolePlugin1.IMyService2。
2. Type：服务的实现类型全名称，如ConsolePlugin1.MyService。

该节点用于定义一个模块向其它模块暴露的扩展功能，这样其它模块可以通过定义 Extension节点来注入相应的扩展功能实现。UIOSP通过ExtensionPoint和Extension这一对 XML配置节点来实现模块的扩展。一般而言，插件扩展需要通过2个步骤实现：（1）在 Manifest.xml定义一个扩展点；（2）在插件通过IBundleContext.ExtensionChanged 事件和IBundleContext.GetExtensions获取其它插件对其扩展并进行处理。该平台 所有的扩展信息都具备动态性，即当模块被启动时扩展点和扩展会注册到平台，相反，当 模块被卸载时，它们会被卸载掉。该节点的结构如图4-7所示。

图4-7 Manifest.xml文件ExtensionPoint节点定义

该节点由Point和Schema属性组成，它们的描述如下：

1. Point：扩展点名称。
2. Schema：扩展信息的XML定义需要遵守的架构。

该节点用于定义一个模块对另一个模块的扩展。其结构如图4-8所示

图4-8 Manifest.xml文件Extension节点定义

该通过Point属性指定其对应的扩展点的名称，它包含的所有子节点就是注册到 扩展点的内容的信息，子节点必须通过扩展点定义的Schema的验证。以下是Extension 定义的示例。该示例定义的扩展其对应的扩展点是UIShell.SiteMap。当该模块启动时， 它会把Extension包含的信息注册到平台，暴露出UIShell.SiteMap扩展点的模块可以 通过模块上下文获取这个定义，然后在导航栏上创建相应的节点。

CopyXML

<Extension Point="UIShell.SiteMap">
  <siteMapNode path="/" title="Home" description="Home">
    <siteMapNode title="Home" description="Home" url="~/default.aspx"/>
    <siteMapNode title="Introduction" url="~/Plugins/ReportPlugin/default.aspx"/>
    <siteMapNode title="Report Demo" url="~/Plugins/ReportPlugin/test.aspx"/>
  </siteMapNode>
  <siteMapNode path="/Products" title="Products" description="Our products"
    url="~/Products.aspx">
    <siteMapNode title="Hardware" description="Hardware choices"
        url="~/Hardware.aspx" />
    <siteMapNode title="Software" description="Software choices"
        url="~/Software.aspx" />
  </siteMapNode>
</Extension>

该节点用于定义模块的详细信息，为可选节点，其结构如图4-9所示。

图4-9 Manifest.xml文件BundleInfo节点定义

该节点包含的属性的详细描述如下：

1. ManifestVersion：清单版本，为2。
2. DocumentLocation：文档位置。
3. UpdateLocation：插件更新时下载新插件的地址。
4. Category：类别。
5. Description：详细描述。
6. Author：作者。
7. ContactAddress：联系方式称。
8. Copyright：版权声明。