Freigeben über

XML-Referenz für Add-On-Paketschemas

  • Artikel

Aktualisiert: November 2007

Add-On-Pakete werden von RemoteAgent und DownloadPackage verwendet, um Dateien auf ein Gerät zu kopieren und optional eine ausführbare Datei zu starten. Allgemeine Informationen finden Sie unter Übersicht über Add-On-Pakete. Verwenden Sie das folgende Beispiel als Referenz zum Erstellen von Add-On-Paketen.

Code

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

Hinweise

Im Beispiel wird ein Add-On-Paket mit dem Namen Example erstellt. In der folgenden Tabelle werden die einzelnen Elemente im vorherigen Beispiel beschrieben.

Tags

Beschreibung

<ADDONCONATINER>

Enthält ein Add-On-Tag.

<ADDON>

Enthält ein PackageContainer-Tag.

<PACKAGECONTAINER>

Enthält mindestens ein Paket.

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

Definiert ein Paket und gibt den Namen und die ID des Pakets an. Die ID entspricht dem globalen eindeutigen Bezeichner (Globally Unique Identifier, GUID).

<PACKAGETYPECONTAINER>

Enthält mindestens einen Pakettyp. Durch jeden Pakettyp wird eine andere CPU-Architektur angegeben, unter der die Geräteanwendung ausgeführt werden kann.

<PACKAGETYPECONTAINER>

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

Definiert einen Pakettyp und gibt den Prozessortyp an, der von diesem Pakettyp unterstützt wird. Die folgenden Prozessortypen sind gültig:

  • ARMV4

  • ARMV4I

  • SH4

  • MIPSII

  • MIPSII_FP

  • MIPSIV

  • MIPSIV_FP

  • X86

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

Gibt eine der folgenden Eigenschaften an:

  • RootPath - Der Ordner der Dateien, die für das Gerät bereitgestellt werden. Alle Dateien, die als Teil dieses Pakets bereitgestellt werden sollen, müssen sich in diesem Ordner auf dem Desktopcomputer befinden. Der Pfad kann CSIDL-Makros (Constant Special Item ID List) enthalten.

    Hinweis:
    CSIDL-Werte bietet eine eindeutige systemunabhängige Möglichkeit zur Kennzeichnung spezieller Ordner, die zwar häufig von Anwendungen verwendet werden, auf einem bestimmten System möglicherweise aber nicht über denselben Namen oder Speicherort verfügen.

  • RemotePath - Der Ordner auf dem Gerät, in dem die Dateien bereitgestellt werden. Der Pfad kann CSIDL-Makros enthalten.

  • Host - Die Binärdatei, die ausgeführt wird, nachdem alle im Paket enthaltenen Dateien vom Desktop aus für das Gerät bereitgestellt wurden.

  • CommandLine - Die Befehlszeilenargumente, die angegeben werden sollten, wenn die Hostbinärdatei auf dem Gerät ausgeführt wird. Diese Eigenschaft ist optional.

<FILECONTAINER>

Enthält mindestens ein Dateitag.

<FILE ID="Trial1.exe" />

Gibt eine Datei an, die bereitgestellt werden soll. Das ID-Attribut gibt den Dateinamen an. Die Datei wird vom Ordner RootPath auf dem Desktop für den Ordner RemotePath auf dem Gerät bereitgestellt.

Wenn Sie das Paket mithilfe von Start oder DownloadPackage bereitstellen, kopiert die Smart Device Connectivity-API trial1.exe und trial2.exe aus dem Ordner Programme auf den Desktopcomputer in den Windows-Ordner auf dem Gerät. Anschließend wird trial1.exe /ServiceIds:F85E57BA-5AE9-4FF7-8433-6AB7D991D033 auf dem Gerät ausgeführt.

Siehe auch

Konzepte

Übersicht über Add-On-Pakete

Weitere Ressourcen

Smart Device Connectivity API Samples