Compilazione di pacchetti di metadati del dispositivo

Questo argomento fornisce linee guida su come creare pacchetti di metadati del dispositivo.

Nomi di file dei pacchetti di metadati del dispositivo

Prima di creare il file del pacchetto di metadati del dispositivo, è necessario creare un identificatore univoco globale (GUID) per il pacchetto di metadati. A tale scopo, usare lo strumento Guidgen (Guidgen.exe) descritto nel sito Web di generazione GUID .

Il nome file del pacchetto di metadati del dispositivo deve usare la convenzione di denominazione seguente:

<GUID>.devicemetadata-ms

Ad esempio, se si crea un GUID con il valore {20f001a99-4675-8707-248ca-187dfd9}, si usa tale GUID per creare il seguente file del pacchetto di metadati del dispositivo:

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

Nota Il sistema operativo riconosce i pacchetti di metadati del dispositivo solo se ha un suffisso . devicemetadata-ms.

Le regole seguenti si applicano ai file del pacchetto di metadati del dispositivo:

• Il GUID per ogni nome file del pacchetto di metadati deve essere univoco. Quando si crea un pacchetto di metadati nuovo o modificato, è necessario creare un nuovo GUID, anche se le modifiche sono minori.

• Ogni pacchetto di metadati può supportare una sola impostazione locale. Se si supportano più impostazioni locali per il dispositivo, è necessario creare pacchetti di metadati separati per ogni impostazione locale, con ogni pacchetto di metadati con il proprio GUID. Per altre informazioni, vedere Elemento XML delle impostazioni locali.

  Nota Se sono necessari più file di pacchetto di metadati del dispositivo specifici delle impostazioni locali per il dispositivo, è possibile raggruppare tutti i file creando un identificatore indipendente dalla lingua. Questo identificatore è un GUID e lo stesso GUID può essere specificato nell'elemento XML LanguageNeutralIdentifier all'interno di tutti i pacchetti di metadati per lo stesso dispositivo.

• Il <prefisso GUID> del nome del file del pacchetto di metadati del dispositivo deve specificare il GUID senza i delimitatori '{' o '}'.

Creazione di un file di pacchetto di metadati del dispositivo

I componenti di un pacchetto di metadati del dispositivo vengono archiviati in un file compresso usando lo strumento Cabarc (Cabarc.exe). Per ulteriori informazioni su questo strumento, vedere il sito Web Di panoramica di Cabarc .

L'esempio di codice seguente illustra come usare lo strumento Cabarc per creare un file di pacchetto di metadati del dispositivo. In questo esempio i componenti del pacchetto di metadati si trovano in una directory locale denominata MyMetadataPackage. L'elenco seguente mostra le sottodirectory e i file all'interno della directory MyMetadataPackage :

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

Prima di tutto, viene creato un GUID con il valore {f4ea2b40-77ff-443d-8212-be7e74a344ae} per il pacchetto di metadati del dispositivo. La figura seguente illustra come usare lo strumento Guidgen per creare il GUID:

Il comando seguente usa quindi lo strumento Cabarc per creare un nuovo file di pacchetto di metadati del dispositivo in una directory locale denominata 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

Nota Ogni pacchetto di metadati può supportare una sola impostazione locale. Se si supportano più impostazioni locali per il dispositivo, è necessario creare pacchetti di metadati separati per ogni impostazione locale, con ogni pacchetto di metadati con il proprio GUID.