1.文件头

XML文件头有XML声明与DTD文件类型声明组成。其中DTD文件类型声明是可以缺少的，关于DTD声明这里不做介绍，而XML声明是必须要有的，以使文件符合XML的标准规格。

在PackageContents.XML文件中的第一行代码几位XML的声明：

代表的意识是：

““ 代表一条指令的结束；

“xml”代表此文件是XML文件；

“ version=”1.0” ”代表文件用的是XML1.0标准；

“ encoding=“utf-8” ”代表此文件所用的字符集。

注意： XML声明必须出现在文档的第一行。

2.文件体

文件体中包含的是XML文件的内容，XML元素是XML文件内容的基本单元。从语法上讲，一个元素包含一个起始标记、一个结束标记以及标记之间的数据内容。

XML元素与HTML元素的格式基本相同，其格式如下：

<标记名称 属性名1=“属性值1” 属性名2=“属性值2”……>内容</标记名称>

所有数据内容都必须在某个标记的开始和结束标记内，而每个标记又必须包含在另一个标记的开始于结束标记内，形成嵌套式的分布，只有最外层的标记不必被其他的标记所包含。最外层的是根元素（Root），又称文件（Document）元素，所有的元素都包含在根元素内。

在PackageContents.XML文件中，根元素就是，根元素必须而且只能有一个。SchemaVersion等元素为属性，CompanyDetails等元素为“内容”，每条内容又有自己的属性及内容，多层嵌套。

PackageContents.XML文件中各元素有些是必须具备的，有些是可选的。

大部分的属性，通过其名称就能知道其作用，例如Name，Description等，下面支队个别元素的注意事项进行解释：

RuntimeRequirements元素，虽然是可选元素，但作者建议保留，理由如下：属性Platform，SeriesMin，seriesMax可以指定插件的运行平台及版本。

例如在Civil 3D中运行相应的插件，可以通过设置Platform的值为Civil 3D实现，运行其他基于AutoCAD的产品时，该插件并不会被加载；如果所有基于AutoCAD的产品都加载此插件，可以通过设置Platform的值为AutoCAD*实现，即示例中所展示的状态。

SeriesMin，SeriesMax限制了插件支持的AutoCAD版本，不同的AutoCAD版本，需要加载不同版本的插件，可以通过指定这两项元素的值来实现。示例中，SeriesMin=“R19.1”，SeriesMax=“R22.0”，表示从AutoCAD 2014版至AutoCAD 2018版均能加载此插件。如何查询产品名称中版本与内部版本之间的关系，可以利用命令AcadVer来实现。

另外一个需要注意的问题是文件路径均为相对路径，均相对于根.bundle文件夹。

除了以上的实例，读者还可以研究其他的软件包，例如Civil3DSnoopDB.bundle来了解程序包的结构及XML文件中的元素。

3.示例文件

PackageContents.XML


<?xml version="1.0" encoding="utf-8" standalone="no"?>


<ApplicationPackage
   SchemaVersion="1.0"
   AppVersion="4.70.9"
   AutodeskProduct="AutoCAD"
   Description="Autodesk BIM 360 Glue AutoCAD 2019 Add-in"
   Author="Autodesk"
   ProductCode="{F4C628E2-41FF-5AAF-8985-DA26BBF5FCB2}"
   UpgradeCode="{D3A7FFB2-B829-4EA1-BD0C-E681847D1E92}"
   Name="Autodesk BIM 360 Glue AutoCAD 2019 Add-in">
   <RuntimeRequirements
      OS="Win32|Win64"
      Platform="AutoCAD|AutoCAD*"
      SeriesMin="23.0"
      SeriesMax="23.0" />
   <CompanyDetails
      Name="Autodesk"
      Email="andrew.gleadall@autodesk.com" />
   <Components
      Description="Win32 parts">
      <RuntimeRequirements
         OS="Win32"
         Platform="AutoCAD|AutoCAD*"
         SeriesMin="23.0"
         SeriesMax="23.0" />
      <ComponentEntry
         AppName="BIM360Glue"
         AppType=".Net"
         Version="4.70.9"
         ModuleName="./Contents/Win32/BIM360GlueAutoCAD2019Addin.dll"
         AppDescription="Main .NET Module"
         LoadOnAutoCADStartup="True">
         <Commands
            GroupName="ADESK_BIM360GLUE">
            <Command
               Local="ShowBIM360"
               Global="ShowBIM360"
               Description="Command to show BIM360 plugin" />
            <Command
               Local="HideBIM360"
               Global="HideBIM360"
               Description="Command to hide BIM360 plugin" />
            <Command
               Local="Glue"
               Global="Glue"
               Description="Glue" />
            <Command
               Local="ClashPinpoint"
               Global="ClashPinpoint"
               Description="ClashPinpoint" />
            <Command
               Local="BIM360_Attach"
               Global="BIM360_Attach"
               Description="Attach" />
         </Commands>
      </ComponentEntry>
      <ComponentEntry
         AppName="BIM360Glue"
         Version="4.70.9"
         ModuleName="./Contents/Win32/BIM360GlueAddinsCommon.dll"
         AppDescription="BIM360GlueAddinsCommon"
         AppType="Dependency" />

      <ComponentEntry
         AppName="BIM360Glue"
         Version="4.70.9"
         ModuleName="./bim360.cuix" />

   </Components>
   <Components
      Description="Win64 parts">
      <RuntimeRequirements
         OS="Win64"
         Platform="AutoCAD|AutoCAD*"
         SeriesMin="23.0"
         SeriesMax="23.0" />
      <ComponentEntry
         AppName="BIM360Glue"
         AppType=".Net"
         Version="4.70.9"
         ModuleName="./Contents/Win64/BIM360GlueAutoCAD2019Addin.dll"
         AppDescription="Main .NET Module"
         LoadOnAutoCADStartup="True">
         <Commands
            GroupName="ADESK_BIM360GLUE">
            <Command
               Local="addHorizontalRibbon"
               Global="addHorizontalRibbon"
               Description="addHorizontalRibbon" />
            <Command
               Local="removeHorizontalRibbon"
               Global="removeHorizontalRibbon"
               Description="removeHorizontalRibbon" />
            <Command
               Local="Glue"
               Global="Glue"
               Description="Glue" />
            <Command
               Local="ClashPinpoint"
               Global="ClashPinpoint"
               Description="ClashPinpoint" />
            <Command
               Local="BIM360_Attach"
               Global="BIM360_Attach"
               Description="Attach" />
         </Commands>
      </ComponentEntry>
      <ComponentEntry
         AppName="BIM360Glue"
         Version="4.70.9"
         ModuleName="./Contents/Win64/BIM360GlueAddinsCommon.dll"
         AppDescription="BIM360GlueAddinsCommon"
         AppType="Dependency" />

      <ComponentEntry
         AppName="BIM360Glue"
         Version="4.70.9"
         ModuleName="./bim360.cuix" />

   </Components>
</ApplicationPackage>