Personalização do SO de validação utilizando o Construtor de Imagens do SO de validação
É possível adicionar pacotes de driver e pacotes de personalização do SO de validação a fim de garantir que o SO de validação possa inicializar e oferecer suporte aos aplicativos em seus cenários. Você pode utilizar os pacotes de personalização para adicionar suporte a diversas funcionalidades sob demanda que serão abordadas posteriormente no documento.
O SO de validação não é fornecido com drivers de caixa de entrada, então você terá que adicionar os drivers para poder aplicar sua imagem ao seu computador.
Processo geral
O processo geral para a criação de uma imagem do SO de validação utilizando o Construtor de Imagens do SO de validação é o seguinte:
Monte o arquivo ISO do SO de validação em um local específico no sistema de arquivos do computador de técnico.
Inicie o ValidationOSImageBuilder.exe apropriado com base na arquitetura nativa do computador de técnico (x64 ou arm64).
Siga as etapas no Construtor de Imagens do SO de validação:
[Opcional] Selecione o local da imagem do SO de validação gerada.
[Opcional] Adicione os drivers à imagem montada do SO de validação.
[Opcional] Adicione um ou mais recursos sob demanda desejados.
[Opcional] Defina/substitua chaves do Registro na imagem do SO de validação.
[Opcional] Inclua binários/aplicativos personalizados na imagem do SO de validação.
[Opcional] Crie uma solução do Visual Studio com referências ao SDK correspondente à imagem gerada do SO de validação.
Introdução ao Construtor de Imagens do SO de validação
O Construtor de Imagens do SO de validação é uma ferramenta de GUI que facilita a geração de imagens personalizadas do SO de validação para cenários específicos. Ele permite que você adicione o seguinte:
- pacotes opcionais, como áudio, Bluetooth, câmera, multimídia, USB etc.;
- drivers para um hardware específico;
- outros aplicativos de software que você deseja incluir na imagem do SO de validação;
- chaves do Registro que você quer habilitar na imagem do SO de validação no momento da inicialização;
- comandos de inicialização que você quer executar no momento da inicialização do SO.
Ele também permite que você gere um SDK que pode ser utilizado para a imagem específica do SO de validação que está sendo gerada.
A lista de pacotes opcionais disponíveis pode ser encontrada aqui: Pacotes de recursos.
Uso do Construtor de Imagens do SO de validação
Veja a seguir um guia de uso passo a passo sobre o fluxo básico do Construtor de Imagens do SO de validação pelo pacote ISO do SO de validação.
Monte o pacote ISO do SO de validação e navegue até a pasta
<ISO_ROOT>:\ImageBuilder, em que<ISO_ROOT>:é a unidade em que o arquivo ISO foi montado.Execute o arquivo ValidationOSImageBuilder.exe para iniciar o Construtor de Imagens do SO de validação e aceite o prompt que pergunta se você quer executar o programa com privilégios de Administrador.
Clique em “Introdução” para acessar a tela Recursos.
Na tela Recursos, escolha os recursos que deseja adicionar à imagem do SO de validação e clique em Avançar para acessar a tela Drivers (consulte a lista de recursos disponíveis na seção acima).
Na tela Drivers opcional, escolha a pasta em que os drivers do seu dispositivo estão localizados.
Nessa tela, também é possível adicionar os seguintes componentes à sua imagem:
Pasta de software opcional: permite que você inclua uma pasta com os arquivos .EXE opcionais que serão incluídos na imagem do SO de validação.
Arquivo do Registro: permite que você carregue um arquivo .REG com as entradas do Registro que serão incluídas na imagem do SO de validação no momento da inicialização.
Comandos de inicialização: permite que você adicione um arquivo .EXE à imagem do SO de validação para execução no momento da inicialização.
Clique em Avançar para acessar a tela Saída.
Na tela Saída, você poderá:
escolher a pasta em que o arquivo WIM de saída e outros componentes serão gerados (o padrão é
C:\ValidationOS);especificar se a imagem do SO de validação (WIM) será inicializada de uma unidade USB ou de um disco rígido (o padrão é USB);
decidir se o Construtor de Imagens do SO de validação deve ou não gerar um SDK associado para a imagem personalizada do SO de validação;
salvar as configurações mais recentes do Construtor de Imagens do SO de validação em um arquivo de modelo para uso no futuro.
Clique em Avançar para acessar a tela Revisar e concluir, que mostrará uma última vez todas as configurações das telas Recursos, Drivers e Saída que você definiu.
Clique em Criar para gerar a imagem do SO de validação.
Depois que a imagem do SO de validação for gerada, você verá uma opção para navegar até a pasta de saída que conterá o arquivo ValidationOS.wim recém-gerado.
Observação
O arquivo ValidationOS-2.wim também é gerado na pasta GenImageOutput. Ele é uma imagem otimizada que contém somente a partição relevante para o tipo de inicialização selecionado na tela Drivers.
Uso da linha de comando do Construtor de Imagens do SO de validação
Toda a funcionalidade disponibilizada na GUI do Construtor de Imagens do SO de validação também está disponível por meio da linha de comando do Construtor de Imagens do SO de validação. Para usar a linha de comando do Construtor de Imagens do SO de validação, navegue até a pasta <ISO_ROOT>:\IBCLI, em que <ISO_ROOT>: é a unidade onde o arquivo ISO foi montado.
O utilitário da linha de comando do Construtor de Imagens do SO de validação é chamado ValidationOSImageBuilderCLI.exe.
Veja a seguir uma lista das opções disponíveis na linha de comando:
-l, --list List all features included in the ISO
-i, --info <info> Get the description of a specific feature
-rp, --resolve <resolve> List all packages included by a set of features
-f, --features <features> Specify features to include
-d, --drivers <drivers> Specify the driver folder path
-s, --software <software> Specify the software folder path
-r, --registry <registry> Specify the registry file path
-sc, --startup-command <startup-command> Specify the startup command file path
-o, --output <output> Specify the output folder path
-sdk, --generate-sdk Generate SDK solution
-st, --save-template Save settings to a template
-g, --generate-image Trigger image generation
-api, --generate-api Generate API Surface from features
-lt, --load-template <load-template> Load a template file
-bt, --boottype <boottype> Specify the boot type (USB/InternalDisk).
Default is USB
--version Show version information
-?, -h, --help Show help and usage information
Para exibir exemplos de como usar as opções da linha de comando, execute ValidationOSImageBuilderCLI -h.
Uso do SDK gerado
Para utilizar o SDK gerado, você precisará ter o Microsoft Visual Studio instalado em seu computador.
No Explorer, navegue até a pasta de saída (que geralmente é chamada C:\ValdationOS<Date-Time of image creation>), onde você verá uma pasta chamada sdk. Dentro desta pasta você verá um arquivo .sln.
Clique duas vezes nesse arquivo para abri-lo no Visual Studio.
Na exibição do Gerenciador de Soluções do Visual Studio, você verá um arquivo .cpp. Você pode editar esse arquivo com seu código ou adicionar seus próprios arquivos de código a esse projeto. Para exibir os pacotes NuGet aos quais seu projeto faz referência, clique com o botão direito do mouse em Referências na exibição do Gerenciador de Soluções e escolha Gerenciar pacotes NuGet.
Para compilar a solução, escolha Compilar no menu principal e selecione Compilar solução, o que gerará o arquivo .exe baseado nesse código para sua imagem personalizada do SO de validação.
Uso do APIValidator com o apisurface.xml
Além da imagem ValidationOS.wim, o Construtor de Imagens também gera um arquivo apisurface.xml na pasta api. Esse arquivo contém uma lista de referência com todas as funções de API com as quais a imagem personalizada ValidationOS.wim é compatível.
É possível utilizar uma ferramenta chamada APIValidator.exe com qualquer arquivo .exe e esse arquivo apisurface.xml como entradas a fim de determinar se há incompatibilidades entre o arquivo .exe e a imagem personalizada ValidationOS.wim.
Para instalar o APIValidator.exe, consulte as instruções no arquivo <ISO_ROOT>:\SDK\ValidationOS_System_Kit-APIValidator_Usage.txt. Será necessário instalar o WDK primeiro. Depois da instalação, um comando típico para analisar um arquivo .exe em relação ao arquivo de superfície da API será semelhante ao seguinte:
Apivalidator.exe -BinaryPath:"<Path to .exe file>" -SupportedApiXmlFiles:"<Path to apisurface.xml file>"
Na saída, você verá uma lista de erros, se houver, e os detalhes das dependências incompatíveis.
Exemplos de SDK do Construtor de Imagens do SO de validação
Veja exemplos de código que utilizam os diversos recursos fornecidos com o Construtor de Imagens do SO de validação aqui: https://github.com/microsoft/validation-OS