デバイス メタデータ パッケージの構築

このトピックでは、デバイス メタデータ パッケージを構築する方法に関するガイドラインを示します。

デバイス メタデータ パッケージ ファイル名

デバイス メタデータ パッケージ ファイルを作成する前に、まずメタデータ パッケージのグローバル一意識別子 (GUID) を作成する必要があります。 これを行うには、「GUID 生成」 Web サイトで説明されている Guidgen ツール (Guidgen.exe) を使用します。

デバイス メタデータ パッケージのファイル名では、次の名前付け規則を使用する必要があります。

<GUID>.devicemetadata-ms

たとえば、{{20f001a99-4675-8707-248ca-187dfd9}} の値を持つ GUID を作成する場合、その GUID を使用して、次のデバイス メタデータ パッケージ ファイルを作成します。

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

注: オペレーティング システムは、devicemetadata-ms サフィックスが付いている場合のみ、デバイス メタデータ パッケージを認識します。

デバイス メタデータ パッケージ ファイルには、次の規則が適用されます。

• 各メタデータ パッケージ ファイル名の GUID は一意である必要があります。 新規または改訂版のメタデータ パッケージを作成するときには、些細な変更であっても、新しい GUID を作成する必要があります。

• 各メタデータ パッケージでサポートできるロケールは 1 つだけです。 デバイスで複数のロケールをサポートする場合は、ロケールごとに個別のメタデータ パッケージを作成し、各メタデータ パッケージに独自の GUID を設定する必要があります。 詳細については、「ロケール XML 要素」を参照してください。

  注: デバイスに複数のロケール固有のデバイス メタデータ パッケージ ファイルが必要な場合は、言語に依存しない識別子を作成することで、すべてのファイルをグループ化できます。 この識別子は GUID であり、同じデバイスのすべてのメタデータ パッケージ内の LanguageNeutralIdentifier XML 要素で同じ GUID を指定できます。

• デバイス メタデータ パッケージ ファイル名の <GUID> プレフィックスは、'{{' または '}}' 区切り記号なしで GUID を指定する必要があります。

デバイス メタデータ パッケージ ファイルの作成

デバイス メタデータ パッケージの コンポーネントは、Cabarc (Cabarc.exe) ツールを使用して圧縮されたファイルに保存されます。 このツールの詳細については、「Cabarc の概要」Web サイトを参照してください。

次のコード例は、Cabarc ツールを使用してデバイス メタデータ パッケージ ファイルを作成する方法を示しています。 この例では、メタデータ パッケージのコンポーネントは、MyMetadataPackage という名前のローカル ディレクトリにあります。 次の一覧は、MyMetadataPackage ディレクトリ内のサブディレクトリとファイルを示しています。

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

まず、デバイス メタデータ パッケージの値が {{f4ea2b40-77ff-443d-8212-be7e74a344ae}} の GUID が作成されます。 次の図は、Guidgen ツールを使用して GUID を作成する方法を示しています。

次に、次のコマンドは Cabarc ツールを使用して新しいデバイス メタデータ パッケージ ファイルを 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

注: 各メタデータ パッケージは 1 つのロケールのみをサポートできます。 デバイスで複数のロケールをサポートする場合は、ロケールごとに個別のメタデータ パッケージを作成し、各メタデータ パッケージに独自の GUID を設定する必要があります。