Convalida della personalizzazione del sistema operativo con Validation OS Image Builder

Articolo
05/30/2024

È possibile aggiungere pacchetti driver e pacchetti di personalizzazione del sistema operativo di convalida per assicurarsi che il sistema operativo di convalida possa avviare e supportare le app per gli scenari in uso. È possibile usare i pacchetti di personalizzazione per aggiungere il supporto per diverse funzionalità su richiesta illustrate più avanti nel documento.

Il sistema operativo di convalida non viene fornito con i driver posta in arrivo, quindi è necessario assicurarsi di aggiungere driver prima di poter applicare l'immagine al PC.

Processo generale

Il processo complessivo per creare un'immagine del sistema operativo di convalida usando Validation OS Image Builder è la seguente:

Montare il file ISO del sistema operativo di convalida in una posizione specifica nel file system PC tecnico;
Avviare il ValidationOSImageBuilder.exe appropriato in base all'architettura nativa del PC tecnico (x64 o arm64);
Seguire la procedura descritta in Validation OS ImageBuilder
1. [Facoltativo] Selezionare il percorso dell'immagine del sistema operativo di convalida generata;
2. [Facoltativo] Aggiungere i driver all'immagine del sistema operativo di convalida montata;
3. [Facoltativo] Aggiungere una o più funzionalità on demand desiderate;
4. [Facoltativo] Impostare/eseguire l'override delle chiavi del Registro di sistema nell'immagine del sistema operativo di convalida;
5. [Facoltativo] Includere file binari/applicazioni personalizzati nell'immagine del sistema operativo di convalida;
6. [Facoltativo] Creare una soluzione di Visual Studio con riferimenti all'SDK corrispondente all'immagine del sistema operativo di convalida generata.

Introduzione a Validation OS Image Builder

Validation OS Image Builder è uno strumento GUI che consente di generare facilmente un'immagine personalizzata del sistema operativo di convalida per lo scenario specifico. Consente di aggiungere

pacchetti facoltativi come Audio, Bluetooth, Fotocamera, Multimedia, USB e così via.
driver per l'hardware specifico
altre applicazioni software da includere nell'immagine del sistema operativo di convalida
Chiavi del Registro di sistema che si desidera abilitare nell'immagine del sistema operativo di convalida all'avvio
comandi di avvio da eseguire all'avvio del sistema operativo

Consente anche di generare un SDK che può essere usato per l'immagine specifica del sistema operativo di convalida generata.

L'elenco dei pacchetti featuire facoltativi disponibili è disponibile qui: Pacchetti di funzionalità

Uso di Validation OS Image Builder

Di seguito è riportata una guida dettagliata all'utilizzo del flusso di base di Validation OS Image Builder dal pacchetto ISO del sistema operativo di convalida.

Montare il pacchetto ISO del sistema operativo di convalida e passare alla <ISO_ROOT>:\ImageBuilder cartella in cui <ISO_ROOT>: è stata montata l'unità ISO.
Eseguire ValidationOSImageBuilder.exe per avviare Validation OS Image Builder e accettare la richiesta di esecuzione del programma con privilegi di Amministrazione istrator
Fare clic su "Introduzione" per passare alla schermata Funzionalità
Nella schermata Funzionalità selezionare le funzionalità da aggiungere all'immagine del sistema operativo di convalida e fare clic su Avanti per passare alla schermata Driver (vedere l'elenco delle funzionalità disponibili nella sezione precedente)
Nella schermata Driver facoltativi selezionare la cartella in cui si trovano i driver per il dispositivo
In questa schermata, è anche possibile aggiungere i componenti seguenti all'immagine
1. Cartella software facoltativa: consente di includere una cartella che contiene file facoltativi .EXE che verranno inclusi nell'immagine del sistema operativo di convalida
2. File del Registro di sistema: consente di caricare un oggetto . File REG contenente le voci del Registro di sistema che verranno incluse nell'immagine del sistema operativo di convalida in fase di avvio
3. Comandi di avvio: consente di aggiungere un file .EXE all'immagine del sistema operativo di convalida che verrà eseguita in fase di avvio
Fare clic su Avanti per passare alla schermata Output
Nella schermata Output è possibile
1. scegliere la cartella in cui verrà generato il file WIM di output e altri componenti (il valore predefinito è C:\ValidationOS)
2. specificare se l'immagine del sistema operativo di convalida verrà avviata da un'unità USB o da un disco rigido (l'impostazione predefinita è USB)
3. scegliere se Validation OS Image Builder deve generare un SDK associato per l'immagine del sistema operativo di convalida personalizzata generata o meno
4. salvare le impostazioni di Validation OS Image Builder usate più di recente in un file modello da usare in futuro
Fare clic su Avanti per passare alla schermata Rivedi e fine che mostrerà tutte le impostazioni Funzionalità, Driver e Output scelte una volta finale.
Fare clic su Crea per generare l'immagine del sistema operativo di convalida.
Dopo aver generato l'immagine del sistema operativo di convalida, verrà visualizzata un'opzione per passare alla cartella di output in cui verrà visualizzato il file ValidationOS.wim appena generato .

Nota

Anche ValidationOS-2.wim viene generato nella cartella GenImageOutput. Si tratta di un'immagine ottimizzata contenente solo la partizione relativa al tipo di avvio selezionato nella schermata Driver

Uso della riga di comando di Validation OS Image Builder

Tutte le funzionalità disponibili nell'interfaccia utente grafica di Validation OS Image Builder sono disponibili anche tramite la riga di comando Validation OS Image Builder. Per usare il comando Validation OS Image Builder ine, passare alla <ISO_ROOT>:\IBCLI cartella in cui <ISO_ROOT>: è stata montata l'unità ISO.

L'utilità della riga di comando Validation OS Image Builder è denominata ValidationOSImageBuilderCLI.exe.

Di seguito è riportato un elenco di opzioni della riga di comando disponibili:

-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

Esempi di come usare le opzioni della riga di comando vengono visualizzati durante l'esecuzione ValidationOSImageBuilderCLI -h

Uso dell'SDK generato

Per usare l'SDK generato, è necessario che Nel computer sia installato Microsoft Visual Studio.

In Esplora risorse passare alla cartella di output (in genere denominata C:\ValdationOS<Date-Time of image creation>) in cui verrà visualizzata una cartella denominata sdk. All'interno di questa cartella verrà visualizzato un file .sln . Fare doppio clic su questo file per aprirlo in Visual Studio.

Nella visualizzazione Esplora soluzioni in Visual Studio verrà visualizzato un file .cpp. È possibile modificare questo file con il codice o aggiungere file di codice personalizzati a questo progetto. Per visualizzare i pacchetti NuGet a cui si fa riferimento al progetto, è possibile fare clic con il pulsante destro del mouse su Riferimenti nella visualizzazione Esplora soluzioni e scegliere Gestisci pacchetti NuGet

Per compilare la soluzione, selezionare Compila dal menu principale e selezionare Compila soluzione che genererà il file .exe da questo codice per l'immagine personalizzata del sistema operativo di convalida.

Uso di APIValidator con apisurface.xml

Insieme all'immagine ValidationOS.wim, Image Builder genera anche un file apisurface.xml nella cartella api. Questo file contiene un elenco di riferimenti di tutte le funzioni API supportate dall'immagine ValidationOS.wim personalizzata.

È possibile usare uno strumento denominato APIValidator.exe con qualsiasi file .exe e questo file apisurface.xml come input per determinare se sono presenti incompatibilità tra il file .exe e l'immagine ValidationOS.wim personalizzata.

Per installare APIValidator.exe, vedere le istruzioni nel file <ISO_ROOT>:\SDK\ValidationOS_System_Kit-APIValidator_Usage.txt. Sarà prima necessario installare WDK. Dopo l'installazione, un comando tipico per analizzare un .exe file in base al file surface dell'API sarà simile al seguente:

Apivalidator.exe -BinaryPath:"<Path to .exe file>" -SupportedApiXmlFiles:"<Path to apisurface.xml file>"

Nell'output verrà visualizzato un elenco di errori, se presenti, insieme ai dettagli delle dipendenze incompatibili.

Esempi di Sdk di Image Builder del sistema operativo di convalida

È possibile visualizzare esempi di codice che usano le varie funzionalità fornite con Validation OS Image Builder qui: https://github.com/microsoft/validation-OS

Condividi tramite