Erstellen von Gerätemetadatenpaketen

Dieses Thema enthält Richtlinien zum Erstellen von Gerätemetadatenpaketen.

Dateinamen des Gerätemetadatenpakets

Bevor Sie die Gerätemetadatenpaketdatei erstellen, müssen Sie zunächst einen global eindeutigen Bezeichner (GUID) für das Metadatenpaket erstellen. Verwenden Sie hierzu das Guidgen-Tool (Guidgen.exe), das auf der Website zur GUID-Generierung beschrieben wird.

Der Dateiname des Gerätemetadatenpakets muss die folgende Benennungskonvention verwenden:

<GUID>.devicemetadata-ms

Wenn Sie beispielsweise eine GUID mit dem Wert {20f001a99-4675-8707-248ca-187dfd9} erstellen, verwenden Sie diese GUID, um die folgende Gerätemetadatenpaketdatei zu erstellen:

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

Hinweis Das Betriebssystem erkennt Gerätemetadatenpakete nur, wenn es über das Suffix verfügt. devicemetadata-ms.

Die folgenden Regeln gelten für Gerätemetadatenpaketdateien:

• Die GUID für jeden Metadatenpaketdateinamen muss eindeutig sein. Wenn Sie ein neues oder überarbeitetes Metadatenpaket erstellen, müssen Sie eine neue GUID erstellen, auch wenn die Änderungen geringfügig sind.

• Jedes Metadatenpaket kann nur ein Gebietsschema unterstützen. Wenn Sie mehrere Gebietsschemas für Ihr Gerät unterstützen, müssen Sie für jedes Gebietsschema separate Metadatenpakete erstellen, wobei jedes Metadatenpaket über eine eigene GUID verfügt. Weitere Informationen finden Sie unter Locale XML-Element.

  Hinweis Wenn Sie mehrere gebietsschemaspezifische Gerätemetadatenpaketdateien für Ihr Gerät benötigen, können Sie alle Dateien gruppieren, indem Sie einen sprachneutralen Bezeichner erstellen. Dieser Bezeichner ist eine GUID, und dieselbe GUID kann im LanguageNeutralIdentifier-XML-Element in allen Metadatenpaketen für dasselbe Gerät angegeben werden.

• Das <GUID-Präfix> des Gerätemetadatenpaketdateinamens muss die GUID ohne die Trennzeichen "{" oder "}" angeben.

Erstellen einer Gerätemetadatenpaketdatei

Die Komponenten eines Gerätemetadatenpakets werden in einer Datei gespeichert, die mithilfe des Tools Cabarc (Cabarc.exe) komprimiert wird. Weitere Informationen zu diesem Tool finden Sie auf der Cabarc-Übersichtswebsite .

Das folgende Codebeispiel zeigt, wie Sie mit dem Tool Cabarc eine Gerätemetadatenpaketdatei erstellen. In diesem Beispiel befinden sich die Komponenten des Metadatenpakets in einem lokalen Verzeichnis mit dem Namen MyMetadataPackage. Die folgende Liste zeigt die Unterverzeichnisse und Dateien im Verzeichnis MyMetadataPackage :

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

Zunächst wird eine GUID mit dem Wert {f4ea2b40-77ff-443d-8212-be7e74a34ae} für das Gerätemetadatenpaket erstellt. Die folgende Abbildung zeigt, wie Sie das Guidgen-Tool verwenden, um die GUID zu erstellen:

Anschließend erstellt der folgende Befehl mithilfe des Cabarc-Tools eine neue Gerätemetadatenpaketdatei in einem lokalen Verzeichnis namens 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

Hinweis Jedes Metadatenpaket kann nur ein Gebietsschema unterstützen. Wenn Sie mehrere Gebietsschemas für Ihr Gerät unterstützen, müssen Sie für jedes Gebietsschema separate Metadatenpakete erstellen, wobei jedes Metadatenpaket über eine eigene GUID verfügt.