加载项包架构 XML 参考

更新:2007 年 11 月

RemoteAgentDownloadPackage 使用加载项包将文件复制到设备并选择性地启动可执行文件。有关常规信息,请参见加载项包概述。可将下面的示例作为创作加载项包的参考。

代码

<?xml version="1.0" standalone="no"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:template match="/">
    <ADDONCONTAINER>
      <ADDON>
        <PACKAGECONTAINER>
          <PACKAGE ID="F85E57BA-5AE9-4FF7-8433-6AB7D991D033" NAME="Example">
            <PROPERTYCONTAINER />
            <PACKAGETYPECONTAINER>
              <PACKAGETYPE Name="ARMV4I" ID="ARMV4I" Protected="True">
                <PROPERTYCONTAINER>
                  <PROPERTY ID="RemotePath" Protected="True">%CSIDL_WINDOWS%</PROPERTY>
                  <PROPERTY ID="RootPath" Protected="True"> %CSIDL_PROGRAM_FILES% </PROPERTY>
                  <PROPERTY ID="CommandLine" Protected="True">/ServiceIds:F85E57BA-5AE9-4FF7-8433-6AB7D991D033</PROPERTY>
                  <PROPERTY ID="Host" Protected="True">Trial1.exe</PROPERTY>
                </PROPERTYCONTAINER>
                <FILECONTAINER>
                  <FILE ID="Trial1.exe" />
                  <FILE ID="Trial2.exe" />
                </FILECONTAINER>
              </PACKAGETYPE>
            </PACKAGETYPECONTAINER>
          </PACKAGE>
        </PACKAGECONTAINER>
      </ADDON>
    </ADDONCONTAINER>
  </xsl:template>
</xsl:stylesheet>
<?xml version="1.0" encoding="ISO-8859-1"?>

备注

该示例会创建一个名为 Example 的加载项包。下表描述了上面这个示例中的每一个元素。

标记

说明

<ADDONCONATINER>

包含一个加载项标记。

<ADDON>

包含一个 PackageContainer 标记。

<PACKAGECONTAINER>

包含一个或多个包。

<PACKAGE ID="F85E57BA-5AE9-4FF7-8433-6AB7D991D033" NAME="Example">

定义包并指定包的名称和 ID。该 ID 是一个全局唯一标识符 (GUID)。

<PACKAGETYPECONTAINER>

包含一个或多个包类型。每个包类型都指定了一个可以运行设备应用程序的不同的 CPU 体系结构。

<PACKAGETYPECONTAINER>

PACKAGETYPE Name="ARMV4I" ID="ARMV4I" Protected="True">

定义包类型并指定此包类型支持的处理器类型。下面是有效的处理器类型:

  • ARMV4

  • ARMV4I

  • SH4

  • MIPSII

  • MIPSII_FP

  • MIPSIV

  • MIPSIV_FP

  • X86

<PROPERTY ID="RemotePath" Protected="True">%CSIDL_WINDOWS%</PROPERTY>

指定下列属性之一:

  • RootPath - 将部署到设备上的文件所在的文件夹。所有要作为此包的组成部分来部署的文件都必须存在于台式计算机上的此文件夹中。该路径可以包含常数特殊项 ID 列表 (CSIDL) 宏。

    说明:

    CSIDL 值提供了唯一一种独立于系统的方式来标识应用程序常用的特殊文件夹,但根据任何给定的系统,这些文件夹的名称或位置可能不同。

  • RemotePath - 将文件部署到设备上时要使用的文件夹。该路径可包含 CSIDL 宏。

  • Host - 在将包中的所有文件都从台式机部署到设备后要执行的二进制文件。

  • CommandLine - 当在设备上执行 Host 二进制文件时要提供的命令行参数。此属性是可选的。

<FILECONTAINER>

包含一个或多个文件标志。

<FILE ID="Trial1.exe" />

指定要部署的文件。指示文件名的 ID 属性。该文件将从台式机上的 RootPath 文件夹部署到设备上的 RemotePath 文件夹中。

在使用 StartDownloadPackage 部署包时,智能设备连接 API 会将 trial1.exetrial2.exe 从桌面计算机上的 Program Files 文件夹复制到设备上的 Windows 文件夹中。随后,它将在设备上执行 trial1.exe /ServiceIds:F85E57BA-5AE9-4FF7-8433-6AB7D991D033

请参见

概念

加载项包概述

其他资源

Smart Device Connectivity API Samples(智能设备连接 API 示例)