ファクトリ OS イメージにアプリを追加する
Windows システム キットには、ユニバーサル Windows アプリをファクトリ OS イメージに追加しやすくなるスクリプトが含まれています。 これらのスクリプトは、ワークスペースに追加したアプリに基づいて機能マニフェスト ファイルを自動的に作成または更新します。
すでに実行されているイメージにアプリを追加するには、「デバイス ポータルを使用して接続する」を参照してください。
前提条件
- WSK ワークスペース
- 1 つ以上の適切にパッケージ化されたユニバーサル Windows アプリ
アプリを収集する
アプリがサポートするすべてのアーキテクチャ (x64、x86、およびARM) をテクニシャン PC に提供するために、すべての依存関係ファイルとライセンス ファイルを含む 、.msix、.msixbundles、.appx、および .appxbundle ファイルをすべて収集します。
ワークスペースの既定のアプリ フォルダーにアプリを保存します (
C:\Workspace\Apps\など)。 アプリがそれぞれ独自のフォルダーにある場合は、サブフォルダーを使用しても問題ありません。 スクリプトでアプリを検索できます。また、同じ依存関係ファイルを含む複数のアプリがあっても問題ありません。 依存関係ファイルは、最終イメージに 1 回だけ追加されます。
サンプルでは、Microsoft が提供するユニバーサル Windows プラットフォーム (UWP) アプリとして WSK にバンドルされている電卓アプリを使用しています。 UWP アプリ サンプルのアプリを使用することも、独自のアプリに置き換えることもできます。
ワークスペースに含まれる AppFM にアプリを追加する
ワークスペースには、OEMInput.xml ファイルに既に含まれている空のアプリ FM が含まれています。 イメージにアプリを追加するには、WSK のスクリプトを使用してアプリ FM にアプリを追加します。 この FM を使用せず、新しいアプリ FM を作成してそれを OEMInput.xml ファイルに含める方法については、「新しいアプリ FM の作成」をご覧ください。
ワークスペースのアプリ FM にアプリを追加します。
管理者として Windows システム キット ビルド環境を開始します (たとえば、マウントした WSK ISO から
E:\SetImagGenEnv.cmdを右クリックし、[管理者として実行] をクリックします)。Windows システム キット ビルド環境からワークスペース フォルダーに移動します。
cd c:\Workspaceワークスペース ルート変数を Update the WSKWorkspaceRoot 環境変数をポイントするように設定し、workspace をポイントします。
C:\Workspace\SetWSKWorkspaceRoot.cmd含まれているアプリ FM にワークスペースのアプリを追加する: WSK のスクリプトを使用してアプリ FM を更新し、ワークスペースにアプリが含まれるようにします。
UpdateWSKAppsFMスクリプトを実行して、ワークスペース アプリ フォルダー (%WSKWorkspaceRoot%\Apps) にあるすべてのアプリをOEMAppsFM.xmlに追加します。 この FM に一覧表示されているアプリは、すべてイメージに含まれています。UpdateWSKAppsFMどのオプションも指定しない場合、スクリプトは
%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xmlファイルを更新して、ワークスペースのアプリ フォルダー内にあるすべてのアプリを含めます。 スクリプトのオプションについては、以下の UpdateWSKAppsFM 構文を参照してください。既定では、アプリはすべてのイメージ デザインに含まれていますが、一元化された付帯品セットを使用して複数のイメージ デザインを作成する場合は、アプリ識別子を追加してアプリをオプションとしてマークできます。
アプリを追加、削除、または更新する場合は、
UpdateWSKAppsFMを再実行して変更を機能マニフェストに追加します。 アプリをオプションとして設定するなど、機能マニフェストに他の編集を加えても問題ありません。 スクリプトはこれらの変更には影響しません。
新しいアプリの FM 作成
Windows システム キットのスクリプトを使用して、新しい アプリ FM を作成できます。
Windows システム キット環境から以下を実行します。
フォルダーに含めるアプリを配置します。
CreateWSKAppsFMスクリプトを実行してすべてのアプリをアプリ フォルダーに含めます。 新しい AppFM の名前とアプリ フォルダーを指定します。CreateWSKAppsFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml -AppsFolder C:\NewAppsスクリプトのオプションについては、以下の CreateWSKAppsFM 構文を参照してください。
このスクリプトにより、各アプリの場所を含む
%WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xmlなどの新しい機能マニフェスト ファイルが作成されます。既定では、アプリはすべてのイメージ デザインに含まれていますが、一元化された付帯品セットを使用して複数のイメージ デザインを作成する場合は、アプリ識別子を追加してアプリをオプションとしてマークできます。
新しいアプリ FM を
<AdditionalFM>として OEMInput.xml ファイルに追加します。<AdditionalFM>%WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml</AdditionalFM>アプリを追加、削除、または更新する場合は、
UpdateWSKAppsFMを実行してアプリを機能マニフェストに追加します。 アプリをオプションとして設定するなど、機能マニフェストに他の編集を加えても問題ありません。 スクリプトはこれらの変更には影響しません。UpdateWSKAppsFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml -AppsFolder C:\NewApps
アプリ FM スクリプトの構文
CreateWSKAppsFM 構文
CreateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}
| パラメーター | 説明 |
|---|---|
| -FMFile [Path] | 作成する FM ファイルのパス。 既定では、%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml が更新されます。 |
| -AppsFolder [Path] | アプリを検索するフォルダーのパス。 既定では、%WSKWorkspaceRoot%\Apps を検索します。 |
| -IncludeWow | amd64 イメージでの x86 のサポートと、arm64 イメージでの arm のサポートが追加されます。 |
UpdateWSKAppsFM の構文
UpdateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}
| パラメーター | 説明 |
|---|---|
| -FMFile [Path] | 更新する FM ファイルのパス。 既定では、%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml が作成されるか、または置き換えられます。 |
| -AppsFolder [Path] | アプリを検索するフォルダーのパス。 既定では、%WSKWorkspaceRoot%\Apps を検索します。 |
| -IncludeWow | 設定すると、x86 から amd64、arm から arm64 のイメージに追加されます。 |