Compilar paquetes de metadatos de dispositivo

En este tema se proporcionan instrucciones sobre cómo compilar paquetes de metadatos de dispositivo.

Nombres de archivo del paquete de metadatos de dispositivo

Antes de crear el archivo de paquete de metadatos del dispositivo, primero debe crear un identificador único global (GUID) para el paquete de metadatos. Para ello, use la herramienta Guidgen (Guidgen.exe) que se describe en el sitio web de generación de GUID .

El nombre de archivo del paquete de metadatos del dispositivo debe usar la siguiente convención de nomenclatura:

<GUID>.devicemetadata-ms

Por ejemplo, si crea un GUID que tenga el valor de {20f001a99-4675-8707-248ca-187dfd9}, use ese GUID para crear el siguiente archivo de paquete de metadatos de dispositivo:

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

Nota El sistema operativo reconoce los paquetes de metadatos del dispositivo solo si tiene un sufijo de . devicemetadata-ms.

Las reglas siguientes se aplican a los archivos de paquete de metadatos del dispositivo:

• El GUID de cada nombre de archivo de paquete de metadatos debe ser único. Al crear un paquete de metadatos nuevo o revisado, debe crear un NUEVO GUID, incluso si los cambios son menores.

• Cada paquete de metadatos solo puede admitir una configuración regional. Si admite más de una configuración regional para el dispositivo, debe crear paquetes de metadatos independientes para cada configuración regional, con cada paquete de metadatos que tenga su propio GUID. Para obtener más información, vea Elemento XML de configuración regional.

  Nota Si necesita varios archivos de paquete de metadatos de dispositivo específicos de la configuración regional para el dispositivo, puede agrupar todos los archivos mediante la creación de un identificador independiente del idioma. Este identificador es un GUID y el mismo GUID se puede especificar en el elemento XML LanguageNeutralIdentifier dentro de todos los paquetes de metadatos para el mismo dispositivo.

• El <prefijo GUID> del nombre del archivo del paquete de metadatos del dispositivo debe especificar el GUID sin los delimitadores '{' o '}'.

Creación de un archivo de paquete de metadatos de dispositivo

Los componentes de un paquete de metadatos de dispositivo se almacenan en un archivo comprimido mediante la herramienta Cabarc (Cabarc.exe). Para obtener más información sobre esta herramienta, consulte el sitio web información general de Cabarc .

En el ejemplo de código siguiente se muestra cómo usar la herramienta Cabarc para crear un archivo de paquete de metadatos de dispositivo. En este ejemplo, los componentes del paquete de metadatos se encuentran en un directorio local denominado MyMetadataPackage. En la lista siguiente se muestran los subdirectorios y archivos del directorio MyMetadataPackage :

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

En primer lugar, se crea un GUID con el valor de {f4ea2b40-77ff-443d-8212-be7e74a344ae} para el paquete de metadatos del dispositivo. En la ilustración siguiente se muestra cómo usar la herramienta Guidgen para crear el GUID:

A continuación, el siguiente comando usa la herramienta Cabarc para crear un nuevo archivo de paquete de metadatos de dispositivo en un directorio local denominado 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 Cada paquete de metadatos solo puede admitir una configuración regional. Si admite más de una configuración regional para el dispositivo, debe crear paquetes de metadatos independientes para cada configuración regional, con cada paquete de metadatos que tenga su propio GUID.