共用方式為


附加套件結構描述 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 標記。

<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>

指定下列任何一個屬性 (Property):

  • RootPath - 將部署至裝置的檔案資料夾。所有要部署為此套件之一部分的檔案,都必須存在於桌上型電腦上的此資料夾中。此路徑可以包含常數特殊項目 ID 清單 (Constant Special Item ID List,CSIDL) 巨集。

    注意事項:

    CSIDL 值可提供與系統無關的獨特方式,以識別應用程式經常使用的特殊資料夾,但在任何指定的系統中,這些資料夾的相同名稱或位置可能都不相同。

  • RemotePath - 裝置上將部署檔案的資料夾。此路徑可以包含 CSIDL 巨集。

  • Host - 在套件內所有檔案都已從桌上型電腦部署至裝置後,所執行的二進位檔。

  • CommandLine - 在裝置上執行主應用程式 (Host) 二進位檔時,提供的命令列引數。這是選擇性屬性 (Property)。

<FILECONTAINER>

包含一個或多個檔案標記。

<FILE ID="Trial1.exe" />

指定要部署的檔案。ID 屬性 (Attribute) 表示檔案名稱。檔案會從桌上型電腦的 RootPath 資料夾部署至裝置的 RemotePath 資料夾。

當您使用 StartDownloadPackage 部署套件時,智慧型裝置連接 API 會將 trial1.exetrial2.exe 從桌上型電腦的 Program Files 資料夾複製到裝置的 Windows 資料夾。接著,它會在裝置上執行 trial1.exe /ServiceIds:F85E57BA-5AE9-4FF7-8433-6AB7D991D033

請參閱

概念

附加套件的概觀

其他資源

智慧型裝置連接 API 範例