Файл конфигурации образа (или OEMInput)

Статья
06/19/2023

Файл конфигурации образа (или OEMInput) — это XML-файл, который определяет пакеты и настройки, которые входят в структуру образа, включая конфигурацию оборудования и диска, заводской продукт ОС, языки, а также компоненты, приложения, драйверы и пакеты для конкретного продукта.

При создании изображения процесс создания образа создает изображение с помощью пакетов, которые сопоставляются со значениями и атрибутами, настроенными в OEMInput.xml. При настройке некоторых элементов OEMInput, таких как языки и продукт, пакеты из комплекта windows (WSK) добавляются непосредственно в образ без дополнительной настройки. Вы также можете настроить и добавить манифесты функций , которые определяют дополнительные расположения пакетов и позволяют включить дополнительные функции, приложения, драйверы и параметры.

Показывает, что манифест компонента можно добавить в файл конфигурации образа для добавления функциональных возможностей. После настройки файла конфигурации образа образ создается с помощью сопутствующих материалов из рабочей области WSK и OEM.

Расположение OEMInput

При подготовке рабочей области вы получите файл конфигурации начального образа в корне каталога рабочей области, который предварительно настроен с информацией об устройстве, манифестами функций, функциями и приложениями для выбранного продукта. Найдите файл со следующей схемой именования в каталоге рабочей области: <Product>_<architecture>_<boottype>_<hardware or VM>_<imagetype>.xml

Вы можете получить путь и имя файла OEMInput.xml, выполнив команду echo %WSKOEMInputFileName% из среды WSK.

Описание схемы

Ниже приведен пустой файл 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) должна находиться в этом поле. Если architecure отсутствует в этом поле, это может привести к сбою сборки.

Пример

<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>

Тип сборки

Указывает, что используется рабочая сборка.

Параметры	Описание
Fre	Это значение по умолчанию. Не меняйте это значение.

Пример

<BuildType>fre</BuildType>

Языки

Указывает, какие языки доступны в изображении.

Языки указываются в элементах <Language> .
Язык по умолчанию указывается с помощью атрибута Default для языка. Необходимо указать один язык в качестве языка по умолчанию. Укажите только один язык по умолчанию.

Сведения о добавлении языков см. в разделе Добавление языков.

Пример (для en-us задано значение по умолчанию):

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

Дополнительные виртуальные машины

Список манифестов функций, используемых в структуре устройства. Манифесты функций перечисляют приложения, драйверы и другие компоненты, которые можно добавить в образ. Некоторые из них предопределяются при создании новой рабочей области и набора примеров файлов, например:

Пример предопределенных манифестов функций:

<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> element: добавление или изменение необязательных компонентов , относящихся к заводским продуктам ОС.
- Доступные функции, относящиеся к фабричному ОС, см. в разделе Фабричные ОС .
<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</Product>

TestContent

Используется для добавления папки тестового обеспечения в образы. Сведения о добавлении тестового содержимого см. в разделе Тестирование содержимого.

Пример

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

Пример файла конфигурации образа для виртуальной машины UEFI фабрики AMD64 с поддержкой пробелов

<?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>

Поделиться через

Файл конфигурации образа (или OEMInput)

Расположение OEMInput

Описание схемы

Описание

DeviceLayoutType

Устройство

Тип выпуска

Тип сборки

Языки

Дополнительные виртуальные машины

Компоненты

AppXOptionalPackages

DevicePlatformIDs

Продукт

TestContent

Пример файла конфигурации образа для виртуальной машины UEFI фабрики AMD64 с поддержкой пробелов

Дополнительные ресурсы