Génération de packages de métadonnées d’appareil

Cette rubrique fournit des instructions sur la création de packages de métadonnées d’appareil.

Noms de fichiers de package de métadonnées d’appareil

Avant de créer le fichier de package de métadonnées d’appareil, vous devez d’abord créer un identificateur global unique (GUID) pour le package de métadonnées. Pour ce faire, utilisez l’outil Guidgen (Guidgen.exe) qui est décrit dans le site web génération de GUID .

Le nom de fichier du package de métadonnées d’appareil doit utiliser la convention de nommage suivante :

<GUID>.devicemetadata-ms

Par exemple, si vous créez un GUID qui a la valeur {20f001a99-4675-8707-248ca-187dfd9}, vous utilisez ce GUID pour créer le fichier de package de métadonnées d’appareil suivant :

20f001a99-4675-8707-248ca-187dfd9.devicemetadata-ms

Note Le système d’exploitation reconnaît les packages de métadonnées d’appareil uniquement s’il a un suffixe de . devicemetadata-ms.

Les règles suivantes s’appliquent aux fichiers de package de métadonnées d’appareil :

• Le GUID de chaque nom de fichier de package de métadonnées doit être unique. Lorsque vous créez un package de métadonnées nouveau ou révisé, vous devez créer un NOUVEAU GUID, même si les modifications sont mineures.

• Chaque package de métadonnées ne peut prendre en charge qu’un seul paramètre régional. Si vous prenez en charge plusieurs paramètres régionaux pour votre appareil, vous devez créer des packages de métadonnées distincts pour chaque paramètre régional, chaque package de métadonnées ayant son propre GUID. Pour plus d’informations, consultez Élément XML des paramètres régionaux.

  Note Si vous avez besoin de plusieurs fichiers de package de métadonnées d’appareil spécifiques aux paramètres régionaux pour votre appareil, vous pouvez regrouper tous les fichiers en créant un identificateur indépendant de la langue. Cet identificateur est un GUID et le même GUID peut être spécifié dans l’élément XML LanguageNeutralIdentifier dans tous les packages de métadonnées pour le même appareil.

• Le <préfixe GUID> du nom du fichier de package de métadonnées d’appareil doit spécifier le GUID sans les délimiteurs « { » ou « } ».

Création d’un fichier de package de métadonnées d’appareil

Les composants d’un package de métadonnées d’appareil sont stockés dans un fichier compressé à l’aide de l’outil Cabarc (Cabarc.exe). Pour plus d’informations sur cet outil, consultez le site web Vue d’ensemble de Cabarc .

L’exemple de code suivant montre comment utiliser l’outil Cabarc pour créer un fichier de package de métadonnées d’appareil. Dans cet exemple, les composants du package de métadonnées se trouvent dans un répertoire local nommé MyMetadataPackage. La liste suivante présente les sous-répertoires et les fichiers dans le répertoire MyMetadataPackage :

.\MyMetadataPackages
.\MyMetadataPackage\PackageInfo.xml
.\MyMetadataPackage\DeviceInformation\DeviceInfo.xml
.\MyMetadataPackage\DeviceInformation\MyIcon.ico
.\MyMetadataPackage\WindowsInformation\WindowsInfo.xml

Tout d’abord, un GUID avec la valeur {f4ea2b40-77ff-443d-8212-be7e74a344ae} est créé pour le package de métadonnées d’appareil. L’illustration suivante montre comment utiliser l’outil Guidgen pour créer le GUID :

Ensuite, la commande suivante utilise l’outil Cabarc pour créer un fichier de package de métadonnées d’appareil dans un répertoire local nommé MyDeviceMetadataPackage :

Cabarc.exe -r -p -P .\MyMetadataPackage\ 
    N .\MyDeviceMetadataPackage\f4ea2b40-77ff-443d-8212-be7e74a344ae.devicemetadata-ms 
    .\MyMetadataPackage\PackageInfo.xml 
    .\MyMetadataPackage\DeviceInformation\DeviceInfo.xml 
    .\MyMetadataPackage\DeviceInformation\MyIcon.ico 
    .\MyMetadataPackage\WindowsInformation\WindowsInfo.xml

Note Chaque package de métadonnées ne peut prendre en charge qu’un seul paramètre régional. Si vous prenez en charge plusieurs paramètres régionaux pour votre appareil, vous devez créer des packages de métadonnées distincts pour chaque paramètre régional, chaque package de métadonnées ayant son propre GUID.