Criando pacotes de metadados de dispositivo

Este tópico fornece diretrizes sobre como criar pacotes de metadados do dispositivo.

Nomes de arquivo do pacote de metadados do dispositivo

Antes de criar o arquivo de pacote de metadados do dispositivo, primeiro você deve criar um GUID (identificador global exclusivo) para o pacote de metadados. Para fazer isso, use a ferramenta Guidgen (Guidgen.exe) descrita no site geração guid.

O nome do arquivo do pacote de metadados do dispositivo deve usar a seguinte convenção de nomenclatura:

<GUID>.devicemetadata-ms

Por exemplo, se você criar um GUID que tenha o valor de {20f001a99-4675-8707-248ca-187dfd9}, use esse GUID para criar o seguinte arquivo de pacote de metadados do dispositivo:

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

Nota O sistema operacional reconhecerá os pacotes de metadados do dispositivo somente se ele tiver um sufixo de . devicemetadata-ms.

As seguintes regras se aplicam aos arquivos de pacote de metadados do dispositivo:

• O GUID para cada nome de arquivo do pacote de metadados deve ser exclusivo. Ao criar um pacote de metadados novo ou revisado, você deve criar um novo GUID, mesmo que as alterações sejam secundárias.

• Cada pacote de metadados pode dar suporte apenas a uma localidade. Se você der suporte a mais de uma localidade para seu dispositivo, deverá criar pacotes de metadados separados para cada localidade, com cada pacote de metadados tendo seu próprio GUID. Para obter mais informações, consulte Elemento XML locale.

  Nota Se você precisar de vários arquivos de pacote de metadados de dispositivo específicos da localidade para seu dispositivo, poderá agrupar todos os arquivos criando um identificador neutro de idioma. Esse identificador é um GUID e o mesmo GUID pode ser especificado no elemento XML LanguageNeutralIdentifier em todos os pacotes de metadados para o mesmo dispositivo.

• O <prefixo GUID> do nome do arquivo do pacote de metadados do dispositivo deve especificar o GUID sem os delimitadores '{' ou '}'.

Criando um arquivo de pacote de metadados do dispositivo

Os componentes de um pacote de metadados de dispositivo são armazenados em um arquivo compactado usando a ferramenta Cabarc (Cabarc.exe). Para obter mais informações sobre essa ferramenta, consulte o site De visão geral do Cabarc .

O exemplo de código a seguir mostra como usar a ferramenta Cabarc para criar um arquivo de pacote de metadados do dispositivo. Neste exemplo, os componentes do pacote de metadados estão localizados em um diretório local chamado MyMetadataPackage. A lista a seguir mostra os subdiretórios e arquivos no diretório MyMetadataPackage :

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

Primeiro, um GUID com o valor de {f4ea2b40-77ff-443d-8212-be7e74a344ae} é criado para o pacote de metadados do dispositivo. A figura a seguir mostra como usar a ferramenta Guidgen para criar o GUID:

Em seguida, o comando a seguir usa a ferramenta Cabarc para criar um novo arquivo de pacote de metadados do dispositivo em um diretório local chamado 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 pacote de metadados pode dar suporte apenas a uma localidade. Se você der suporte a mais de uma localidade para seu dispositivo, deverá criar pacotes de metadados separados para cada localidade, com cada pacote de metadados tendo seu próprio GUID.