共用方式為


建置裝置中繼資料套件

本主題提供如何建置裝置中繼資料套件的指導方針。

裝置中繼資料套件檔案名

建立裝置中繼資料套件檔案之前,您必須先建立中繼資料套件的全域唯一識別碼 (GUID) 。 若要這樣做,請使用GUID 產生網站中所述的 Guidgen 工具 (Guidgen.exe) 。

裝置中繼資料套件的檔案名必須使用下列命名慣例:

<GUID>.devicemetadata-ms

例如,如果您建立的 GUID 值為 {20f001a99-4675-8707-248ca-187dfd9},您可以使用該 GUID 來建立下列裝置中繼資料套件檔案:

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

注意 只有在作業系統的尾碼為 時,作業系統才會辨識裝置中繼資料套件。devicemetadata-ms.

下列規則適用于裝置中繼資料套件檔案:

  • 每個中繼資料套件檔案名的 GUID 必須是唯一的。 當您建立新的或修訂的中繼資料套件時,即使變更是次要的,您也必須建立新的 GUID。

  • 每個中繼資料套件只能支援一個地區設定。 如果您為裝置支援多個地區設定,則必須為每個地區設定建立個別的中繼資料套件,每個中繼資料套件都有自己的 GUID。 如需詳細資訊,請參閱 Locale XML 元素

    注意 如果您需要裝置的多個地區設定特定裝置中繼資料套件檔案,您可以建立語言中性識別碼來分組所有檔案。 此識別碼是 GUID,而且相同的 GUID 可以在相同裝置的所有中繼資料套件內的 LanguageNeutralIdentifier XML 元素中指定。

  • 裝置中繼資料套件檔案名的GUID > 前置詞必須指定不含 '{' 或 '}' 分隔符號的 GUID。 <

建立裝置中繼資料套件檔案

裝置中繼資料套件的元件會儲存在壓縮的檔案中,方法是使用 Cabarc (Cabarc.exe) 工具。 如需此工具的詳細資訊,請參閱 Cabarc 概觀 網站。

下列程式碼範例示範如何使用 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:

[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

注意 每個中繼資料套件只能支援一個地區設定。 如果您為裝置支援多個地區設定,則必須為每個地區設定建立個別的中繼資料套件,每個中繼資料套件都有自己的 GUID。