Référence XML du schéma de package de composant additionnel

Mise à jour : novembre 2007

Les packages complémentaires sont utilisés par RemoteAgent et DownloadPackage pour copier des fichiers vers un appareil et, facultativement, démarrer un fichier exécutable. Pour obtenir des informations générales, consultez Vue d'ensemble des packages de composants additionnels. Utilisez l'exemple suivant en guise de référence pour créer des packages complémentaires.

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

Notes

L'exemple crée un package complémentaire nommé Example. Le tableau suivant décrit chaque élément de l'exemple de code précédent.

Contient une balise addon.

<ADDON>

Contient une balise PackageContainer.

Contient un ou plusieurs packages.

Définit un package et spécifie le nom et l'ID du package. L'ID est un identificateur global unique (GUID).

Contient un ou plusieurs types de package. Chaque type de package spécifie une architecture UC différente sur laquelle l'application Smart Device peut s'exécuter.

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

Définit un type de package et spécifie le type de processeur pris en charge par ce type de package. Les types de processeur valides sont les suivants :

ARMV4
ARMV4I
SH4
MIPSII
MIPSII_FP
MIPSIV
MIPSIV_FP
X86

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

Spécifie l'une des propriétés suivantes :

RootPath - Dossier des fichiers qui seront déployés sur l'appareil. Tous les fichiers à déployer dans le cadre de ce package doivent être présents dans ce dossier sur l'ordinateur de bureau. Le chemin d'accès peut contenir des macros CSIDL (Constant Special Item ID List).

Remarque :
Les valeurs CSIDL offrent un moyen unique indépendant des systèmes pour identifier les dossiers spéciaux utilisé fréquemment par les applications, mais qui ne peuvent pas avoir le même nom ou emplacement sur un système donné.

RemotePath - Dossier sur l'appareil où les fichiers seront déployés. Le chemin d'accès peut comprendre des macros CSIDL.
Host - Le fichier binaire exécuté une fois que tous les fichiers dans le package ont été déployés de l'ordinateur de bureau vers l'appareil.
CommandLine - Les arguments de ligne de commande à fournir lorsque le fichier binaire hôte est exécuté sur l'appareil. Cette propriété est facultative.

Contient une ou plusieurs balises de fichier.

Spécifie un fichier à déployer. L'attribut ID indique le nom de fichier. Le fichier est déployé à partir du dossier RootPath sur l'ordinateur de bureau vers le dossier RemotePath sur l'appareil.

Lorsque vous déployez le package en utilisant Start ou DownloadPackage, l'API de connectivité Smart Device copie trial1.exe et trial2.exe du dossier Program Files sur l'ordinateur de bureau vers le dossier Windows de l'appareil. Il exécute ensuite trial1.exe /ServiceIds:F85E57BA-5AE9-4FF7-8433-6AB7D991D033 sur l'appareil.

Voir aussi

Concepts

Vue d'ensemble des packages de composants additionnels

Autres ressources

Exemples d'API de connectivité Smart Device

Last updated on 2008-08-21