Validation OS-Anpassung mit Validation OS Image Builder

  • Artikel

Sie können Treiberpakete und Validation OS-Anpassungspakete hinzufügen, um sicherzustellen, dass Validation OS die Apps für Ihre Szenarien starten und unterstützen kann. Sie können Anpassungspakete verwenden, um Unterstützung für mehrere On-Demand-Funktionen hinzuzufügen, die später in diesem Dokument behandelt werden.

Validation OS wird ohne integrierte Treiber ausgeliefert. Sie müssen daher unbedingt Treiber hinzufügen, bevor Sie Ihr Image auf Ihren PC anwenden können.

Übersicht über den Prozess

Der allgemeine Prozess zum Erstellen eines Validation OS-Images mit Validation OS Image Builder lautet wie folgt:

  1. Stellen Sie die ISO-Datei von Validation OS in einem bestimmten Speicherort im Dateisystem des Techniker-PCs bereit.

  2. Starten Sie die entsprechende ValidationOSImageBuilder.exe basierend auf der nativen Architektur des Techniker-PCs (x64 oder arm64).

  3. Ausführen der Schritte in Validation OS ImageBuilder

    1. [Optional] Wählen Sie den Speicherort des generierten Validation OS-Images aus.

    2. [Optional] Fügen Sie die Treiber dem bereitgestellten Validation OS-Image hinzu.

    3. [Optional] Fügen Sie mindestens eine gewünschte On-Demand-Funktion hinzu.

    4. [Optional] Legen Sie Registrierungsschlüssel im Validation OS-Image fest bzw. setzen Sie sie außer Kraft.

    5. [Optional] Schließen Sie benutzerdefinierte Binärdateien/Anwendungen in das Validation OS-Image ein.

    6. [Optional] Erstellen Sie eine Visual Studio-Lösung mit Verweisen auf das SDK, das dem generierten Validation OS-Image entspricht.

Erste Schritte mit dem Validation OS Image Builder

Validation OS Image Builder ist ein GUI-Tool, mit dem Sie einfach ein benutzerdefiniertes Validation OS-Image für Ihr spezifisches Szenario erstellen können. Es ermöglicht Ihnen, Folgendes hinzuzufügen:

  • Optionale Pakete wie Audio, Bluetooth, Kamera, Multimedia, USB usw.
  • Treiber für Ihre spezifische Hardware
  • Andere Softwareanwendungen, die Sie in das Validation OS-Image aufnehmen möchten
  • Registrierungsschlüssel, die beim Start im Validation OS-Image aktiviert werden sollen
  • Startbefehle, die beim Betriebssystemstart ausgeführt werden sollen

Außerdem können Sie ein SDK generieren, das für das generierte spezifische Validation OS-Image verwendet werden kann.

Die Liste der verfügbaren optionalen Featurepakete finden Sie hier: Featurepakete

Verwenden von Validation OS Image Builder

Nachfolgend finden Sie eine schrittweise Anleitung zur Verwendung des grundlegenden Ablaufs des Validation OS Image Builder aus dem ISO-Paket von Validation OS.

  1. Stellen Sie das ISO-Paket von Validation OS bereit, und navigieren Sie zum <ISO_ROOT>:\ImageBuilder-Ordner, wobei <ISO_ROOT>: das Laufwerk ist, auf dem die ISO bereitgestellt wurde.

  2. Führen Sie ValidationOSImageBuilder.exe aus, um den Validation OS Image Builder zu starten, und akzeptieren Sie die Eingabeaufforderung, an der Sie aufgefordert werden, das Programm mit Administratorrechten auszuführen.

  3. Klicken Sie auf „Erste Schritte“, um zum Bildschirm „Features“ zu gelangen.

  4. Wählen Sie auf dem Bildschirm „Features“ die Features aus, die Sie dem Validation OS-Image hinzufügen möchten, und klicken Sie auf „Weiter“, um zum Bildschirm „Treiber“ zu gelangen (die Liste der verfügbaren Funktionen finden Sie im Abschnitt oben).

  5. Wählen Sie im Bildschirm „Optionale Treiber“ den Ordner aus, in dem sich die Treiber für Ihr Gerät befinden.

  6. Auf diesem Bildschirm können Sie optional auch die folgenden Komponenten zu Ihrem Image hinzufügen.

    1. Optionaler Softwareordner: Hiermit können Sie einen Ordner einschließen, der optionale EXE-Dateien enthält, die im Validation OS-Image enthalten sein werden.

    2. Registrierungsdatei: Hiermit können Sie eine REG-Datei mit Registrierungseinträgen hochladen, die beim Booten in das Validation OS-Image aufgenommen werden.

    3. Startbefehle: Damit können Sie dem Validation OS-Image eine EXE-Datei hinzufügen, die beim Booten ausgeführt wird.

  7. Klicken Sie auf „Weiter“, um zum Ausgabebildschirm zu gelangen.

  8. Im Ausgabebildschirm können Sie

    1. den Ordner auswählen, in dem die WIM-Ausgabedatei und andere Komponenten generiert werden (Standard ist C:\ValidationOS).

    2. angeben, ob das Validation OS-Image (WIM) von einem USB-Laufwerk oder einer Festplatte gestartet wird (Standard ist USB).

    3. auswählen, ob der Validation OS Image Builder ein zugeordnetes SDK für das generierte benutzerdefinierte Validation OS-Image generieren soll oder nicht.

    4. die zuletzt verwendeten Validation OS Image Builder-Einstellungen in einer Vorlagendatei zur zukünftigen Verwendung speichern.

  9. Klicken Sie auf „Weiter“, um zum Bildschirm „Überprüfen & Fertigstellen“ zu gelangen. Dort werden Ihnen alle von Ihnen ausgewählten Funktionen, Treiber und Ausgabeeinstellungen ein letztes Mal angezeigt.

  10. Klicken Sie auf „Erstellen“, um das Validation OS-Image zu generieren.

  11. Nachdem das Validation OS-Image generiert wurde, wird eine Option zum Navigieren zum Ausgabeordner angezeigt, in dem das neu generierte ValidationOS.wim angezeigt wird.

Hinweis

ValidationOS-2.wim wird auch im GenImageOutput-Ordner generiert. Dies ist ein optimiertes Image, das nur die Partition enthält, die für den Starttyp relevant ist, den Sie im Bildschirm „Treiber“ ausgewählt haben.

Verwenden der Befehlszeile für den Validation OS Image Builder

Alle in der GUI des Validation OS Image Builder verfügbaren Funktionen sind auch über die Befehlszeile des Validation OS Image Builder verfügbar. Um die Validation OS Image Builder-Befehlszeile zu verwenden, navigieren Sie zum <ISO_ROOT>:\IBCLI-Ordner, wobei <ISO_ROOT>: das Laufwerk ist, auf dem die ISO bereitgestellt wurde.

Das Validation OS Image Builder-Befehlszeilenprogramm heißt ValidationOSImageBuilderCLI.exe.

Nachfolgend finden Sie eine Liste der verfügbaren Befehlszeilenoptionen:

-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

Beispiele für die Verwendung der Befehlszeilenoptionen werden angezeigt, wenn Sie ValidationOSImageBuilderCLI -h ausführen.

Verwenden des generierten SDK

Um das generierte SDK zu verwenden, muss Microsoft Visual Studio auf Ihrem Computer installiert sein.

Navigieren Sie im Explorer zu dem Ausgabeordner (in der Regel mit dem Namen C:\ValdationOS<Date-Time of image creation>), in dem ein Ordner mit dem Namen sdk angezeigt wird. In diesem Ordner wird eine .sln-Datei angezeigt. Doppelklicken Sie auf diese Datei, um sie in Visual Studio zu öffnen.

In der Ansicht Projektmappen-Explorer in Visual Studio wird eine .cpp-Datei angezeigt. Sie können diese Datei mit Ihrem Code bearbeiten oder diesem Projekt Ihre eigenen Codedateien hinzufügen. Um die Nuget-Pakete anzuzeigen, auf die Ihr Projekt verweist, können Sie mit der rechten Maustaste auf Referenzen in der Ansicht „Projektmappen-Explorer“ klicken und Nuget-Pakete verwalten auswählen.

Um die Lösung zu erstellen, wählen Sie Erstellen aus dem Hauptmenü und dann Lösung erstellen aus. Dadurch wird die .exe-Datei aus diesem Code für Ihr benutzerdefiniertes Validation OS-Image generiert.

Verwenden von APIValidator mit apisurface.xml

Zusammen mit dem ValidationOS.wim-Image generiert der Image Builder auch eine apisurface.xml-Datei im API-Ordner. Diese Datei enthält eine Referenzliste aller API-Funktionen, die das benutzerdefinierte ValidationOS.wim-Image unterstützt.

Sie können ein Tool namens APIValidator.exe mit jeder .exe-Datei und dieser apisurface.xml-Datei als Eingaben verwenden, um zu ermitteln, ob Inkompatibilitäten zwischen Ihrer .exe-Datei und Ihrem benutzerdefinierten ValidationOS.wim-Image bestehen.

Informationen zum Installieren von APIValidator.exe finden Sie in den Anweisungen in der Datei <ISO_ROOT>:\SDK\ValidationOS_System_Kit-APIValidator_Usage.txt. Sie müssen WDK zuerst installieren. Nach der Installation würde ein typischer Befehl zum Analysieren einer .exe-Datei mit der API-Oberflächendatei wie folgt aussehen:

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

In der Ausgabe wird ggf. eine Liste der Fehler zusammen mit Details zu den inkompatiblen Abhängigkeiten angezeigt.

SDK-Beispiele für Validation OS Image Builder

Hier können Sie Codebeispiele anzeigen, die die verschiedenen Features verwenden, die mit dem Validation OS Image Builder bereitgestellt werden: https://github.com/microsoft/validation-OS