次の方法で共有

Validation OS Image Builder を使用した Validation OS のカスタマイズ

  • [アーティクル]

ドライバー パッケージと検証 OS カスタマイズ パッケージを追加して、検証 OS が起動し、シナリオのアプリをサポートできるようにすることができます。 カスタマイズ パッケージを使用すると、このドキュメントの後半で説明するいくつかのオンデマンド機能のサポートを追加できます。

検証 OS には同梱のドライバーが付属していないため、イメージを PC に適用する前に必ずドライバーを追加する必要があります。

全体的なプロセス

Validation OS Image Builder を使用して Validation OS イメージを作成する全体的なプロセスは次のとおりです。

  1. 検証 OS ISO ファイルをテクニシャン PC ファイルシステム上の特定の場所にマウントします。

  2. 技術者の PC のネイティブ アーキテクチャ (x64 または arm64) に基づいて適切な ValidationOSImageBuilder.exe を起動します。

  3. 検証OS ImageBuilderの手順に従ってください

    1. [オプション] 生成された検証OSイメージの場所を選択します。

    2. [オプション] マウントされた検証OSイメージにドライバーを追加します。

    3. [オプション] 必要なオンデマンド機能を1つ以上追加します。

    4. [オプション] 検証OSイメージ内のレジストリキーを設定/上書きします。

    5. [オプション] 検証 OS イメージにカスタム バイナリ/アプリケーションを含めます。

    6. [オプション] 生成された検証 OS イメージに一致する SDK への参照を含む Visual Studio ソリューションを作成します。

検証OSImage Builder の概要

検証 OS Image Builder は、特定のシナリオに合わせてカスタム検証 OS イメージを簡単に生成できる GUI ツールです。 追加することができます

  • オーディオ、Bluetooth、カメラ、マルチメディア、USB などのオプション パッケージ。
  • 特定のハードウェア用のドライバー
  • 検証OSイメージに含めるその他のソフトウェアアプリケーション
  • 起動時に検証 OS イメージで有効にするレジストリ キー
  • OS起動時に実行する起動コマンド

また、生成される特定の検証 OS イメージに使用できる SDK を生成することもできます。

利用可能なオプションの機能パッケージのリストは、次の場所にあります: 機能パッケージ

検証OS Image Builder の使用

以下は、Validation OS ISO パッケージからの Validation OS Image Builder の基本的なフローのステップバイステップの使用ガイドです。

  1. 検証 OS ISO パッケージをマウントし、 <ISO_ROOT>:\ImageBuilder フォルダーに移動します。 <ISO_ROOT>: は ISO がマウントされたドライブです。

  2. ValidationOSImageBuilder.exe を実行してValidation OS Image Builderを起動し、管理者権限でプログラムを実行するように求められるプロンプトを受け入れます。

  3. 「概要」をクリックして機能画面に進みます

  4. 機能画面で、検証 OS イメージに追加する機能を選択し、[次へ] をクリックしてドライバー画面に進みます (上記のセクションで利用可能な機能のリストを参照してください)。

  5. オプションのドライバー画面で、デバイスのドライバーが保存されているフォルダを選択します。

  6. この画面では、オプションで次のコンポーネントをイメージに追加することもできます。

    1. オプションのソフトウェア フォルダ: 検証 OS イメージに含まれるオプションの .EXE ファイルを含むフォルダを含めることができます。

    2. レジストリ ファイル: 起動時に検証 OS イメージに含まれるレジストリ エントリを含む .REG ファイルをアップロードできます。

    3. 起動コマンド: 起動時に実行される .EXE ファイルを検証 OS イメージに追加できます。

  7. 次へをクリックして出力画面に進みます

  8. 出力画面では、次のことができます。

    1. 出力WIMファイルとその他のコンポーネントが生成されるフォルダを選択します（デフォルトは C:\ValidationOS）

    2. 検証 OS イメージ (WIM) を USB ドライブから起動するか、ハード ドライブから起動するかを指定します (デフォルトは USB)

    3. Validation OS Image Builder が、生成されたカスタム Validation OS イメージに関連付けられた SDK を生成するかどうかを選択します。

    4. 最近使用した検証OS Image Builder の設定をテンプレートファイルに保存し、将来使用できるようにします。

  9. 「次へ」をクリックして「レビュー & 終了」画面に進みます。この画面には、最後にもう一度選択したすべての機能、ドライバー、および出力設定が表示されます。

  10. [作成] をクリックして検証 OS イメージを生成します。

  11. 検証 OS イメージが生成されると、新しく生成された ValidationOS.wim.が表示される出力フォルダーに移動するオプションが表示されます。

Note

ValidationOS-2.wim も GenImageOutput フォルダーに生成されます。 これは、ドライバー画面で選択したブート タイプに関連するパーティションのみを含む最適化されたイメージです。

検証 OS Image Builder コマンド ラインの使用

Validation OS Image Builder GUI で利用できるすべての機能は、Validation OS Image Builder コマンド ラインでも利用できます。 検証 OS Image Builderのコマンド ラインを使用するには、 <ISO_ROOT>:\IBCLI フォルダーに移動します。 <ISO_ROOT>: は ISO がマウントされたドライブです。

Validation OS Image Builder コマンド ライン ユーティリティは ValidationOSImageBuilderCLI.exeと呼ばれます。

使用可能なコマンドライン オプションの一覧は次のとおりです。

-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

コマンドラインオプションの使用方法の例は、 ValidationOSImageBuilderCLI -hを実行すると表示されます。

生成されたSDKの使用

生成された SDK を使用するには、コンピューターに Microsoft Visual Studio がインストールされている必要があります。

Explorer で、出力フォルダー (通常は C:\ValdationOS<Date-Time of image creation>という名前) に移動すると、 sdk というフォルダーが表示されます。 このフォルダ内には .sln ファイルがあります。 このファイルをダブルクリックして Visual Studio で開きます。

Visual Studio の ソリューション Explorer ビューに、 .cpp ファイルが表示されます。 このファイルを自分のコードで編集したり、このプロジェクトに独自のコード ファイルを追加したりできます。 プロジェクトが参照するNugetパッケージを表示するには、ソリューションExplorer ビューで 参照 を右クリックし、 Nugetパッケージの管理を選択します。

ソリューションをビルドするには、メイン メニューから ビルド を選択し、 ソリューションのビルド を選択します。これにより、カスタム検証 OS イメージ用のこのコードから .exe ファイルが生成されます。

apisurface.xml で APIValidator を使用する

ValidationOS.wim イメージとともに、Image Builder は api フォルダーに apisurface.xml ファイルも生成します。 このファイルには、カスタム ValidationOS.wim イメージがサポートするすべての API 関数の参照リストが含まれています。

APIValidator.exe というツールを任意の .exe ファイルとこの apisurface.xml ファイルを入力として使用して、.exe ファイルとカスタム ValidationOS.wim イメージの間に非互換性があるかどうかを判断できます。

APIValidator.exe をインストールするには、ファイル <ISO_ROOT>:\SDK\ValidationOS_System_Kit-APIValidator_Usage.txtの手順を参照してください。 まずWDKをインストールする必要があります。 インストールが完了すると、API サーフェス ファイルに対して .exe ファイルを分析する一般的なコマンドは次のようになります。

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

出力には、エラーがある場合はそのリストと、互換性のない依存関係の詳細が表示されます。

検証 OS Image Builder SDK サンプル

Validation OS Image Builder に付属するさまざまな機能を活用したコードサンプルは、こちらでご覧いただけます: https://github.com/microsoft/validation-OS