Compartilhar via

Usar o WSK para criar uma imagem básica de VM

  • Artigo

Neste passo a passo, mostraremos como usar os diferentes componentes do Windows System Kit para criar uma imagem do sistema operacional factory de linha de base em uma VM. Mostraremos como usar manifestos de recursos e arquivos de configuração de imagem para configurar sua imagem.

Para executar este laboratório, você precisará de:

  • Computador técnico com:
    • O Kit do Sistema windows instalado
    • Gerenciador do Hyper-V instalado
  • Um driver de exemplo (opcional)
  • Um aplicativo UWP de exemplo (opcional)

  1. Monte seu ISO do Windows System Kit.

  2. Abra o ambiente de criação de imagens executando SetImagGenEnv.cmd como administrador. SetImagGenEnv.cmd está na raiz do WSK montado.

  3. Criar um workspace

    Começaremos criando um Workspace. Workspaces são uma coleção de arquivos que você precisa fazer imagem. Ao criar um Workspace, você precisará escolher qual arquitetura, produto, layout, tipo de inicialização e tipo de imagem. Com base em suas seleções, o Kit do Sistema windows criará um Workspace com um arquivo OEMInput que serve como ponto de partida para a configuração da imagem. Neste laboratório, criaremos uma imagem do sistema operacional de fábrica que podemos implantar em uma VM:

    PrepWSKWorkspace "C:\Workspace" -Product FactoryOS -VM

    Observação

    A variável %WSKWorkspaceRoot% que você verá em todo esse laboratório é definida automaticamente quando você executa prepwskworkspaceo . Se você fechar e reabrir o ambiente do Windows System Kit, poderá definir a raiz do workspace navegando até a pasta do workspace e executando SetWSKWorkspaceRoot.cmd.

  4. Adicionar um driver à imagem (opcional)

    Quando você criou seu Workspace, o Kit do Sistema windows criou um arquivo chamado OEMDriversFM.xml. Esse arquivo permite que você defina os drivers que deseja incluir em sua imagem. O OEMDrivers.xml arquivo gerado pelo Windows System Kit não contém nenhuma informação sobre drivers adicionais. Se você tiver um driver de exemplo, gostaria de adicionar:

    1. Copie os arquivos .inf do driver e todos os arquivos de suporte associados (.cab, .sys etc.) para C:\Workspace\DCHUDrivers.

    2. Execute um script para atualizar automaticamente o OEMDriversFM.xml:

      UpdateWSKDriversFM

    Confira o manifesto do recurso Driver para saber mais sobre como adicionar drivers, incluindo como marcar drivers como opcionais e como gerar um novo Apps FM.

  5. Adicionar um aplicativo à sua imagem

    Quando você criou seu Workspace, o Kit do Sistema windows criou um arquivo chamado OEMAppsFM.xml. Esse arquivo define o que é necessário para adicionar um aplicativo específico à sua imagem. O arquivo de exemplo é configurado para adicionar o aplicativo Calculadora como um recurso opcional à sua imagem. Seu arquivo de configuração de imagem já tem o aplicativo Calculadora incluído, bem como suas dependências. Veja como adicionar um aplicativo adicional:

    1. Copie um pacote .appx, seu arquivo de licença e quaisquer dependências na %WSKWorkspaceRoot%\Apps pasta.

    2. No Ambiente de Build, execute:

      UpdateWSKAppsFM

    3. Você terá um arquivo de OEMAppsFM.xml atualizado que inclui os aplicativos que estão na Apps pasta. Quando você executou UpdateWSKAppsFM, os aplicativos adicionados não são marcados como opcionais. Se você quiser que eles sejam opcionais, edite o arquivo XML e defina Optional = True para os aplicativos que você deseja opcionais.

    4. Os aplicativos que não são definidos como opcionais serão incluídos em sua imagem (desde que o arquivo FM seja incluído no arquivo de configuração de imagem). Se você definiu um aplicativo como opcional e deseja adicioná-lo ao arquivo de configuração de imagem, será necessário adicioná-lo à AppXOptionalPackages seção. Veja como é a aparência da adição do aplicativo Calculadora (já que ele foi definido como opcional quando você criou seu workspace).

      Examine a Entrada em OEMAppsFM.xml:

      <PackageFile Optional="true" ID="Microsoft.WindowsCalculator_8wekyb3d8bbwe" LicenseFile="Microsoft.WindowsCalculator_8wekyb3d8bbwe.xml" Name="Microsoft.WindowsCalculator_8wekyb3d8bbwe.appxbundle" Path="$(mspackageroot)\Appx\Calculator"/>

      Observe que ID (Microsoft.WindowsCalculator_8wekyb3d8bbwe), usaremos isso para adicionar o aplicativo.

      Copie e ID cole-o no arquivo de configuração de imagem. Ele terá a seguinte aparência:

      <AppXOptionalPackages>
<!-- Add optional APPX packages here. -->
    <AppXID>Microsoft.WindowsCalculator_8wekyb3d8bbwe</AppXID>
</AppXOptionalPackages>

    5. Salve o arquivo de configuração de imagem.

    Se você quiser disponibilizar mais aplicativos em sua imagem, consulte Manifesto do recurso de aplicativo.

  6. Incluir manifestos de recurso no arquivo de configuração de imagem

    Quando você criou seu workspace, o Windows System Kit criou um arquivo de configuração de imagem que inclui OEMAppsFM.xml automaticamente e OEMDriversFM.xml. Se você criar manifestos de recursos adicionais, precisará adicioná-los sob o AdditionalFMs elemento no arquivo de configuração de imagem. Isso disponibiliza os recursos definidos nos manifestos do recurso para adicionar à imagem. Todos os recursos que estão no arquivo de configuração de imagem são definidos em manifestos de recurso. Adicionar um manifesto de recurso ao arquivo de configuração de imagem disponibiliza todos os recursos definidos nesse manifesto de recurso para adicionar à sua imagem.

    Abra o arquivo de Configuração de Imagem em um editor XML e verifique se OEMAppsFM.xml e OEMDriversFM.xml estão listados. Os aplicativos e drivers incluídos nessas FMs serão incluídos automaticamente em sua imagem, a menos que especificados como optional. Você pode saber mais sobre como marcar um recurso como opcional em Manifestos de recursos.

    Abra o arquivo de configuração de imagem. Você deverá ver as FMs a seguir listadas em seu arquivo. Se os manifestos de recursos para seus aplicativos e drivers não estiverem listados, adicione-os para que ele tenha esta aparência:

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

  7. Criar uma imagem

    Execute o comando a seguir para criar sua imagem. Quando configuramos nosso workspace, definimos a imagem como uma VM. Isso criará uma VM em uma pasta chamada Workspace.Output.

    BuildWSKImage %WSKWorkspaceRoot%\FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.xml

    Observação

    O arquivo xml referenciado aqui pode ser diferente dependendo das opções escolhidas quando você criou o workspace. Se você receber um erro ao executar este comando, verifique se o nome do arquivo está correto.

    Importante

    Se você tentar gerar uma imagem na pasta de destino que já inclui um . Imagens FFU ou discos rígidos virtuais com o mesmo nome, a criação da imagem falhará com o seguinte erro:

    imageapp : ERROR : ThreadId18164 OutputFile C:\FactoryOS.Output\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.ffu already exists.

    Antes de gerar uma imagem, verifique se a pasta de saída ainda não contém uma imagem gerada com o mesmo nome.

  8. Crie uma Máquina Virtual que use o disco rígido virtual que você criou. Depois de inicializar, você pode se conectar ao dispositivo usando o Portal de Dispositivos, SSH ou TShell.