Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Important
Device metadata is deprecated and will be removed in a future release of Windows. For information about the replacement for this functionality, see Driver Package Container Metadata.
This article describes how you can test device metadata for your UWP device app locally before you submit it to the Windows Dev Center Dashboard.
A UWP device app is a special UWP app that device manufacturers create to serve as a companion to their internal or peripheral device. By using device metadata, device apps can run privileged operations and automatically install when a device is plugged in. For more info about UWP device apps, see Meet UWP device apps.
This article is part of a step-by-step series. See Build a UWP device app step-by-step for the introduction.
Before you begin
You can deploy device metadata to the local device metadata store on a local computer so you can test that your device works properly with it. Once device metadata is deployed, it should act the same way as it would if it were submitted to the Windows Dev Center Dashboard. For example, if AutoPlay is enabled for a device in the device metadata, the AutoPlay handler should work when the device is plugged in. If you change the model or publisher name, you can make sure those changes show up too.
Before you test your device metadata, the Microsoft Store app should be installed on the computer where you'll be deploying the device metadata.
Deploy your device metadata locally
Before you can test your device metadata, you must deploy it to the local device metadata store. You can deploy it by selecting the Copy the device metadata package to the metadata store on the local computer check box when you're creating the device metadata or by using the Device Metadata Authoring Wizard after the device metadata is created.
To deploy the device metadata by using the Device Metadata Authoring Wizard
Open the Device Metadata Authoring Wizard from %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86.
On the Tools menu, select Deploy Metadata Package.
Browse to the .devicemetadata-ms file, and then select Open.
If the User Account Control dialog box appears, select Yes.
After the device metadata is deployed, you'll see a message that says The device metadata package was successfully copied to the local metadata store on this computer. Your device metadata is ready to be tested.
Validate your device metadata
You can validate your device metadata against a UWP device app or a device by using the Device Metadata Authoring Wizard.
To validate your device metadata by using the Device Metadata Authoring Wizard
Open the Device Metadata Authoring Wizard from %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86.
Select Validate Metadata.
On the Select metadata package to validate page, do the following:
Under the Device metadata package heading, select Browse to select your .devicemanifest-ms file, or select Select from local metadata store if you've already deployed your device metadata locally.
If you want to validate against a UWP app, select the Validate the device metadata package against a UWP device app check box, and then select Browse to choose the Microsoft Store app package (.appx).
If you want to validate against a device, select the Validate the device metadata package against a device check box, select Select from devices, choose your device, and then select OK.
Select Validate.
After validation is done, you can save the report. Select Close.
Caution
You might get an error in the validation report saying "The experience ID doesn't match between storeManifest.xml in the app package and packageInfo.xml in the device metadata file." You can safely ignore this message.