Arquivo de configuração de imagem (ou OEMInput)

  • Artigo

O arquivo de configuração de imagem (ou OEMInput) é um arquivo XML que define os pacotes e personalizações que entram no design de uma imagem, incluindo a configuração de hardware e unidade, Produto do sistema operacional de fábrica, idiomas e quais recursos, aplicativos, drivers e pacotes específicos do produto estão incluídos.

Quando você gera uma imagem, o processo de geração de imagem cria uma imagem usando pacotes que são mapeados para os valores e atributos configurados em OEMInput.xml. Configurar alguns elementos OEMInput, como idiomas e produtos, adiciona pacotes do WSK (Windows System Kit) diretamente à sua imagem sem configuração adicional. Você também pode configurar e adicionar manifestos de recursos que definem locais de pacote adicionais e habilitam recursos, aplicativos, drivers e configurações adicionais.

Mostra que o manifesto do recurso pode ser adicionado a um arquivo de configuração de imagem para adicionar funcionalidade. Depois que um arquivo de configuração de imagem é personalizado, uma imagem é criada usando a garantia do WSK e do workspace OEM.

Local de OEMInput

Ao preparar um workspace, você obterá um arquivo de configuração de imagem inicial na raiz do diretório do workspace pré-configurado com informações do dispositivo, manifestos de recursos, recursos e aplicativos para o produto escolhido. Procure um arquivo com o seguinte esquema de nomenclatura no diretório do workspace: <Product>_<architecture>_<boottype>_<hardware or VM>_<imagetype>.xml

Você pode obter o caminho e o nome do arquivo do arquivo OEMInput.xml executando echo %WSKOEMInputFileName% no ambiente WSK.

Descrição do esquema

Veja a seguir um arquivo de OEMInput.xml vazio. Esta seção descreve a finalidade e o uso de cada elemento.

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

Descrição

Descrição da imagem e arquitetura da imagem. A arquitetura (AMD64, x86) deve estar nesse campo. Se o architecure não estiver nesse campo, isso poderá causar falha no build.

Exemplo:

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

DeviceLayoutType

Define as propriedades de layout de disco para a imagem.

Opções Descrição
GPT Use para dispositivos baseados em UEFI e máquinas virtuais Hyper-V Geração 2.
GPT_SPACES_512 Use para dispositivos baseados em UEFI e máquinas virtuais Hyper-V Geração 2 com o layout de espaços. Quando você cria novos arquivos de exemplo com PrepWSKWorkspace, esse é o padrão.
GPT_SPACES_4096 Use para dispositivos baseados em UEFI e máquinas virtuais Hyper-V Geração 2 com o layout de espaços que usam discos do setor 4096.
GPT_SPACES_SPLIT Use quando estiver usando um layout de dispositivo dividido.

Exemplo:

<DeviceLayoutType>GPT_SPACES_512</DeviceLayoutType>

Dispositivo

Define se a imagem é para dispositivos baseados em UEFI.

Opções Descrição
GenericUEFIDevice Use para dispositivos baseados em UEFI e máquinas virtuais Hyper-V Geração 2. Quando você cria novos arquivos de exemplo com PrepWSKWorkspace, esse é o padrão.

Exemplo:

<Device>GenericUEFIDevice</Device>

ReleaseType

Determina se aplicativos de teste, drivers e outros pacotes podem ser usados.

Opções Descrição
Test Use isso para identificar uma imagem como uma imagem de teste, haverá menos restrições de imagem nesse tipo de imagem. 
<ReleaseType>Test</ReleaseType>

Buildtype

Especifica o uso de um build de produção.

Opções Descrição
Fre Esse é o padrão. Não altere esse valor.

Exemplo:

<BuildType>fre</BuildType>

Idiomas

Especifica quais idiomas estão disponíveis em uma imagem.

  • Os idiomas são especificados nos <Language> elementos .
  • O idioma padrão é especificado usando o Default atributo para um idioma. Você deve especificar um idioma como o padrão. Especifique apenas um idioma padrão.

Consulte Adicionar idiomas para obter informações sobre como adicionar idiomas.

Exemplo (en-us definido como padrão):

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

AdditionalFMs

Lista os manifestos de recurso usados no design do dispositivo. Os manifestos de recursos listam os aplicativos, drivers e outros componentes que você pode adicionar à sua imagem. Algumas delas são predefinidas quando você cria um novo workspace e um conjunto de arquivos de exemplo, por exemplo:

Exemplo de manifestos de recursos predefinidos:

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

Recursos

O <Features> elemento permite que você adicione recursos opcionais à sua imagem.

Exemplo:

<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

Adicione a ID do aplicativo de aplicativos opcionais a serem incluídos na imagem.

Exemplo:

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

DevicePlatformIDs

Um DevicePlatofrmID é uma cadeia de caracteres que consiste em valores da estrutura de informações do sistema SMBIOS, concatenada com cada valor separado por um período. Seu arquivo OEMInput.xml pode incluir vários DevicePlaformIDs.

Ao criar um workspace, o arquivo OEMInput incluirá <DevicePlatformID>Manufacturer.Family.Product.Version</DevicePlatformID>. Atualize a cadeia <DevicePlatformID> de caracteres para refletir seu hardware. Consulte DevicePlatformID para obter mais informações.

Se o arquivo OEMInput.xml não incluir o elemento , adicione-o <DevicePlatformIDs> . Você não poderá exibir sua imagem no hardware se esse elemento não estiver no arquivo OEMInput.xml.

Exemplo:

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

Produto

[O produto define o manifesto principal do recurso usado em uma imagem.

Opções Descrição
Factory OS Usar para o sistema operacional de fábrica

Exemplo:

<Product>Factory OS</Product>

TestContent

Usado para adicionar uma pasta de teste-colateral às imagens. Consulte Testar conteúdo para obter informações sobre como adicionar conteúdo de teste.

Exemplo:

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

Arquivo de configuração de imagem de exemplo para uma VM AMD64 UEFI do sistema operacional de fábrica habilitada para espaços

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