映射組態檔 (或 OEMInput)

發行項
06/19/2023

映射組態檔 (或 OEMInput) 是 XML 檔案，可定義進入映射設計的套件和自訂專案，包括硬體和磁片磁碟機組態、Factory OS 產品、語言，以及哪些產品特定功能、應用程式、驅動程式和套件都包含在內。

當您產生映射時，映射產生程式會使用對應至您在 OEMInput.xml 中設定的值和屬性的套件來建置映射。設定某些 OEMInput 元素，例如語言和產品，會直接從 Windows System Kit (WSK) 新增套件到您的映射中，而不需要額外的設定。您也可以設定和新增功能資訊清單，以定義其他套件位置，並啟用其他功能、應用程式、驅動程式和設定。

顯示功能資訊清單可以新增至映射組態檔，以新增功能。自訂映射組態檔之後，會使用 WSK 和 OEM 工作區中的附隨品來建置映射。

OEMInput 位置

當您準備工作區時，您會在工作區目錄的根目錄中取得起始映射設定檔，該目錄已預先設定裝置資訊、功能資訊清單、功能，以及您選擇的產品的應用程式。在工作區目錄中尋找具有下列命名配置的檔案： <Product>_<architecture>_<boottype>_<hardware or VM>_<imagetype>.xml

您可以從 WSK 環境執行 echo %WSKOEMInputFileName% ，以取得OEMInput.xml檔案的路徑和檔案名。

架構描述

以下是空白OEMInput.xml檔案。本節說明每個元素的用途和使用方式。

<OEMInput>
  <Description></Description>
  <DeviceLayoutType></DeviceLayoutType>
  <Device></Device>
  <ReleaseType></ReleaseType>
  <BuildType></BuildType>
  <Languages>
    <Language></Language>
  </Languages>
  <AdditionalFMs>
    <AdditionalFM></AdditionalFM>
  </AdditionalFMs>
  <Features>
    <Microsoft>
      <Feature></Feature>
    </Microsoft>
    <OEM>
      <Feature></Feature>
    </OEM>
  </Features>
  <AppXOptionalPackages>
    <AppXID></AppXID>
  </AppXOptionalPackages>
  <DevicePlatformIDs>
    <DevicePlatformID></DevicePlatformID>
  </DevicePlatformIDs>
  <Product></Product>
  <TestContent></TestContent>
  <UserInstallableFeatures>
      <Feature></Feature>
  </UserInstallableFeatures>
</OEMInput>

描述

映射的映射描述和架構。此欄位中必須有 AMD64、x86) 架構 (。如果此欄位中沒有原型，可能會導致建置失敗。

範例：

<Description>Factory OS Hardware Validation image. UEFI Hardware OEMInput for AMD64</Description>

DeviceLayoutType

定義映射的磁片配置屬性。

選項	描述
Gpt	用於 UEFI 型裝置和 Hyper-V 第 2 代虛擬機器。
GPT_SPACES_512	使用 UEFI 型裝置和具有空間配置的Hyper-V 第 2 代虛擬機器。當您使用 PrepWSKWorkspace 建立新的範例檔案時，這是預設值。
GPT_SPACES_4096	使用 UEFI 型裝置和 Hyper-V 第 2 代虛擬機器，以及使用 4096 磁區磁片的空間配置。
GPT_SPACES_SPLIT	當您使用分割裝置配置時，請使用。

範例：

<DeviceLayoutType>GPT_SPACES_512</DeviceLayoutType>

裝置

定義映射是否適用于以 UEFI 為基礎的裝置。

選項	描述
GenericUEFIDevice	用於 UEFI 型裝置和 Hyper-V 第 2 代虛擬機器。當您使用 PrepWSKWorkspace 建立新的範例檔案時，這是預設值。

範例：

<Device>GenericUEFIDevice</Device>

ReleaseType

判斷是否可以使用測試應用程式、驅動程式和其他套件。

選項	描述
Test	使用此專案將影像識別為測試影像，此映射類型會有較少的映射限制。

<ReleaseType>Test</ReleaseType>

BuildType

指定使用生產組建。

選項	描述
fre	此為預設值。請勿變更此值。

範例：

<BuildType>fre</BuildType>

語言

指定影像中可用的語言。

語言是在元素中 <Language> 指定。
預設語言是使用 Default 語言的屬性來指定。您必須將一種語言指定為預設值。只指定一種預設語言。

如需如何新增語言的資訊，請參閱新增語言。

(en-us 設定為預設) 範例：

<Languages>
    <Language Default="true">en-us</Language>
    <Language>zh-cn</Language>
</Languages>

AdditionalFM

列出裝置設計中使用的功能資訊清單。功能資訊清單會列出您可以新增至映射的應用程式、驅動程式和其他元件。當您建立新的工作區和一組範例檔案時，其中有些是預先定義的，例如：

預先定義功能資訊清單的範例：

<AdditionalFMs> 
    <!-- You MUST include GenericDeviceFM.xml and FOSNonProductionFM.xml! -->
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\FOSNonProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreNonProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\GenericDeviceFM.xml</AdditionalFM>
    <!-- Add OEM FMs here. -->
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
</AdditionalFMs>

功能

元素 <Features> 可讓您將選擇性功能新增至影像。

<Microsoft> 元素：新增或修改 Factory OS 產品特有的選擇性功能。
- 如需 Factory OS 特有的可用功能，請參閱Factory OS
<OEM> element：如果您已定義選擇性驅動程式，請在這個專案中新增它們。

範例：

<Features>
    <Microsoft>
        <Feature>WCOS_EVENTLOG_SERVICE</Feature>        
        <Feature>WCOS_PNP_RUNTIMEDEVICEINSTALL</Feature>
        <Feature>FONTSIZE_15</Feature>
        <Feature>DEVICEPORTAL_OPTIONAL_MONITORCONFIG</Feature>
        <Feature>SERVICING_STACK</Feature>
        <Feature>ALLOW_CONNECTEDSTANDBY</Feature>
        <Feature>MICROSOFT_EDGE</Feature>
        <Feature>OEM_IMAGE</Feature>
        <Feature>SHELL_BOOT</Feature>
        <Feature>DEVSHELL_MFG</Feature>
        <Feature>MANUFACTURING_TOOLS</Feature>
        <Feature>STATESEPARATION_ON</Feature>
        <Feature>TESTSIGNING_ON</Feature>
        <Feature>ENABLE_WOW</Feature>
        <Feature>WCOS_DEVICEPORTAL</Feature>
        <Feature>WCOS_DEVICEPORTAL_WOW</Feature>
        <Feature>WCOS_POWERSHELLCORE</Feature>
        <Feature>FACTORY_ORCHESTRATOR_SERVICE</Feature>
        <Feature>STORAGESPACES_LAYOUT</Feature>
        <Feature>KDNETUSB_ON</Feature>
    </Microsoft>
    <OEM>
        <Feature>OEMDriver</Feature>
    </OEM>
</Features>

AppXOptionalPackages

新增要包含在影像中的選用應用程式的應用程式識別碼。

範例：

<AppXOptionalPackages>
    <AppXID>Microsoft.WindowsCalculator_8wekyb3d8bbwe</AppXID>
    <AppXID>Microsoft.FactoryTestFrameworkUWP_8wekyb3d8bbwe</AppXID>
</AppXOptionalPackages>

DevicePlatformIDs

DevicePlatofrmID 是由 SMBIOS 系統資訊結構中的值所組成，與以句號分隔的每個值串連在一起。您的OEMInput.xml檔案可以包含多個 DevicePlaformID。

當您建立工作區時，OEMInput 檔案會包含 <DevicePlatformID>Manufacturer.Family.Product.Version</DevicePlatformID> 。 <DevicePlatformID>更新字串以反映您的硬體。如需詳細資訊，請參閱 DevicePlatformID 。

如果您的OEMInput.xml檔案不包含 <DevicePlatformIDs> 元素，請務必新增它。如果此元素不在OEMInput.xml檔案中，您將無法將映射刷新到硬體上。

範例：

<DevicePlatformIDs>
    <DevicePlatformID>Manufacturer.FamilyName.ProductName.ProductVersion</DevicePlatformID>
    <DevicePlatformID>Contoso.Laptops.ContosoBook.V1</DevicePlatformID>
    <DevicePlatformID>Contoso.ContosoLaptop.*.1</DevicePlatformID>
</DevicePlatformIDs>

產品

[Product 會定義映射中使用的核心功能資訊清單。

選項	描述
Factory OS	用於處理站 OS

範例：

<Product>Factory OS</Product>

TestContent

用來將測試附隨品的資料夾新增至影像。如需新增測試內容的相關資訊，請參閱測試內容。

範例：

<TestContent>%WSKWorkspaceRoot%\TestContent</TestContent>

已啟用空格的 Factory OS AMD64 UEFI VM 的範例映射組態檔

<?xml version="1.0" encoding="utf-8"?>
<OEMInput xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/embedded/2019/06/ImageUpdate">
  <Description>FactoryOS Test en-us image. VM2 OEMInput for VMGen2 on amd64</Description>
  <DeviceLayoutType>GPT_SPACES_512</DeviceLayoutType>
  <Device>GenericUEFIDevice</Device>
  <ReleaseType>Test</ReleaseType>
  <BuildType>fre</BuildType>
  <Languages>
    <Language Default="true">en-us</Language>
  </Languages>
  <AdditionalFMs> 
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreNonProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\MobileDeviceSpaceFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\FOSNonProductionFM.xml</AdditionalFM>
    <!-- Add OEM FMs here. -->
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
  </AdditionalFMs> 
  <Features>
    <Microsoft>
        <Feature>STATESEPARATION_ON</Feature>
        <Feature>STORAGESPACES_LAYOUT</Feature>
        <Feature>UEFI_VM</Feature>
        <Feature>WCOS_EVENTLOG_SERVICE</Feature>        
        <Feature>FONTSIZE_15</Feature>
        <Feature>DEVICEPORTAL_OPTIONAL_MONITORCONFIG</Feature>
        <Feature>WCOS_STORAGE_CDDVD</Feature>        
        <Feature>WCOS_POWERSHELL</Feature>
        <Feature>TESTSIGNING_ON</Feature>
        <Feature>SHELL_BOOT</Feature>
        <Feature>MANUFACTURING_TOOLS</Feature>
        <Feature>ENABLE_WOW</Feature>
        <Feature>WCOS_DEVICEPORTAL</Feature>
        <Feature>WCOS_DEVICEPORTAL_WOW</Feature>
        <Feature>FACTORY_ORCHESTRATOR_SERVICE</Feature>
        <Feature>MANUFACTURING_POWER_SCHEME</Feature>
        <Feature>MANUFACTURING_MODE_EMPTY_PROFILE</Feature>
        <Feature>RESOLUTION_1080X1920</Feature>
        <Feature>OEM_IMAGE</Feature>
        <Feature>KDNETUSB_ON</Feature>        
        <Feature>WCOS_HYPERV_GUEST_UEFI</Feature>
    </Microsoft>
  </Features>
  <AppXOptionalPackages>
    <AppXID>Microsoft.FactoryTestFrameworkUWP_8wekyb3d8bbwe</AppXID>
  </AppXOptionalPackages>
      <DevicePlatformIDs>
      <DevicePlatformID>*.*.*.**</DevicePlatformID>
    </DevicePlatformIDs>
  <Product>Factory OS</Product>
  <TestContent>%WSKWorkspaceRoot%\TestContent</TestContent>
</OEMInput>

共用方式為