Personalización del sistema operativo de validación con Image Builder del sistema operativo de validación
Puede agregar paquetes de controladores y paquetes de personalización del sistema operativo de validación para asegurarse de que el sistema operativo de validación puede arrancar y admitir las aplicaciones para sus escenarios. Puede usar paquetes de personalización para agregar compatibilidad con varias funcionalidades a petición que se tratan más adelante en el documento.
El sistema operativo de validación no se distribuye con controladores de bandeja de entrada, por lo que tendrá que asegurarse de agregar controladores antes de poder aplicar la imagen a su PC.
Proceso general
El proceso general para crear una imagen del sistema operativo de validación con Image Builder del sistema operativo de validación es el siguiente:
Monte el archivo ISO del sistema operativo de validación en una ubicación específica en el sistema de archivos del equipo técnico.
Inicie el ValidationOSImageBuilder.exe adecuado basado en la arquitectura nativa del equipo técnico (x64 o arm64).
Siga los pasos descritos en ImageBuilder del sistema operativo de validación.
[Opcional] Seleccione la ubicación de la imagen del sistema operativo de validación generada.
[Opcional] Agregue los controladores a la imagen montada del sistema operativo de validación.
[Opcional] Agregue una o varias características a petición deseadas.
[Opcional] Establezca o invalide las claves del Registro en la imagen del sistema operativo de validación.
[Opcional] Incluya archivos binarios o aplicaciones personalizadas en la imagen del sistema operativo de validación.
[Opcional] Cree una solución de Visual Studio con referencias al SDK que coincida con la imagen del sistema operativo de validación generada.
Introducción a Image Builder del sistema operativo de validación
Image Builder del sistema operativo de validación es una herramienta de GUI que permite generar fácilmente una imagen personalizada del sistema operativo de validación para su escenario específico. Le permite agregar lo siguiente:
- Paquetes opcionales, como audio, Bluetooth, cámara, multimedia, USB, etc.
- Controladores para el hardware específico.
- Otras aplicaciones de software que desee incluir en la imagen del sistema operativo de validación.
- Claves del Registro que desee habilitar en la imagen del sistema operativo de validación al iniciarse.
- Comandos de inicio que desee ejecutar en el inicio del sistema operativo.
También permite generar un SDK que se puede usar para la imagen específica del sistema operativo de validación que se va a generar.
La lista de paquetes de características opcionales disponibles se puede encontrar aquí: Paquetes de características
Uso de Image Builder del sistema operativo de validación
A continuación se muestra una guía de uso paso a paso para el flujo básico de Image Builder del sistema operativo de validación desde el paquete ISO del sistema operativo de validación.
Monte el paquete ISO del sistema operativo de validación y vaya a la carpeta
<ISO_ROOT>:\ImageBuilderdonde<ISO_ROOT>:es la unidad donde se montó la ISO.Ejecute ValidationOSImageBuilder.exe para iniciar Image Builder del sistema operativo de validación y acepte el mensaje donde se le pide que ejecute el programa con privilegios de administrador.
Haga clic en "Comenzar" para ir a la pantalla Características.
En la pantalla Características, seleccione las características que desee agregar a la imagen del sistema operativo de validación y haga clic en Siguiente para ir a la pantalla Controladores (consulte la lista de características disponibles en la sección anterior).
En la pantalla Controladores opcionales, seleccione la carpeta donde se encuentran los controladores del dispositivo.
En esta pantalla, también puede agregar opcionalmente los siguientes componentes a la imagen.
Carpeta de software opcional: le permite incluir una carpeta que contenga archivos opcionales .EXE que se incluirán en la imagen del sistema operativo de validación.
Archivo del Registro: le permite cargar un archivo .REG que contenga entradas del Registro que se incluirán en la imagen del sistema operativo de validación en tiempo de arranque.
Comandos de inicio: le permite agregar un archivo .EXE a la imagen del sistema operativo de validación que se ejecutará en tiempo de arranque.
.Haga clic en Siguiente para ir a la pantalla Salida.
En la pantalla Salida, puede:
Elegir la carpeta donde se generará el archivo WIM de salida y otros componentes (el valor predeterminado es
C:\ValidationOS).Especificar si la imagen del sistema operativo de validación (WIM) arrancará desde una unidad USB o una unidad de disco duro (el valor predeterminado es USB).
Elegir si Image Builder del sistema operativo de validación debe generar o no un SDK asociado para la imagen del sistema operativo de validación personalizada generada.
Guardar la configuración de Image Builder del sistema operativo de validación usada más recientemente en un archivo de plantilla para su uso en el futuro.
Haga clic en Siguiente para ir a la pantalla Revisar y finalizar, que le mostrará todas las características, controladores y configuración de salida que eligió una última vez.
Haga clic en Crear para generar la imagen del sistema operativo de validación.
Una vez generada la imagen del sistema operativo de validación, verá una opción para navegar a la carpeta de salida, donde verá el ValidationOS.wim recién generado.
Nota:
ValidationOS-2.wim también se genera en la carpeta GenImageOutput. Se trata de una imagen optimizada que contiene solo la partición pertinente para el tipo de arranque seleccionado en la pantalla Controladores.
Uso de la línea de comandos de Image Builder del sistema operativo de validación
Toda la funcionalidad que está disponible en la GUI de Image Builder del sistema operativo de validación también está disponible a través de la línea de comandos de Image Builder del sistema operativo de validación. Para usar la línea de comandos de Image Builder del sistema operativo de validación, vaya a la carpeta <ISO_ROOT>:\IBCLI donde <ISO_ROOT>: es la unidad donde se montó la ISO.
La utilidad de línea de comandos de Image Builder del sistema operativo de validación se denomina ValidationOSImageBuilderCLI.exe.
A continuación se muestra una lista de las opciones de la línea de comandos disponibles:
-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
Se muestran ejemplos de cómo usar las opciones de la línea de comandos al ejecutar ValidationOSImageBuilderCLI -h
Uso del SDK generado
Para usar el SDK generado, necesitará tener Microsoft Visual Studio instalado en el equipo.
En el Explorador, vaya a la carpeta de salida (que normalmente se denomina C:\ValdationOS<Date-Time of image creation>) donde verá una carpeta denominada sdk. Dentro de esta carpeta verá un archivo .sln.
Haga doble clic en este para abrirlo en Visual Studio.
En la vista del Explorador de soluciones de Visual Studio, verá un archivo .cpp. Puede editar este archivo con el código o agregar sus propios archivos de código a este proyecto. Para ver los paquetes Nuget a los que hace referencia el proyecto, puede hacer clic con el botón derecho en Referencias en la vista del Explorador de soluciones y seleccionar Administrar paquetes Nuget.
Para compilar la solución, seleccione Compilar en el menú principal y seleccione Compilar solución que generará el archivo .exe a partir de este código para la imagen del sistema operativo de validación personalizada.
Uso de APIValidator con apisurface.xml
Junto con la imagen ValidationOS.wim, Image Builder también genera un archivo apisurface.xml en la carpeta api. Este archivo contiene una lista de referencia de todas las funciones de API que admite la imagen ValidationOS.wim personalizada.
Puede usar una herramienta denominada APIValidator.exe con cualquier archivo .exe y este archivo apisurface.xml como entradas para determinar si hay incompatibilidades entre el archivo .exe y la imagen ValidationOS.wim personalizada.
Para instalar APIValidator.exe, consulte las instrucciones del archivo <ISO_ROOT>:\SDK\ValidationOS_System_Kit-APIValidator_Usage.txt. Primero tendrá que instalar WDK. Una vez instalado, un comando típico para analizar un archivo .exe en el archivo de superficie de API tendría este aspecto:
Apivalidator.exe -BinaryPath:"<Path to .exe file>" -SupportedApiXmlFiles:"<Path to apisurface.xml file>"
En la salida verá una lista de errores, si los hay, junto con los detalles de las dependencias incompatibles.
Ejemplos del SDK de Image Builder del sistema operativo de validación
Puede ver ejemplos de código que usan las distintas características proporcionadas con Image Builder del sistema operativo de validación aquí: https://github.com/microsoft/validation-OS