通过

生成工厂 OS 映像

  • 项目

为设备类型（计划为其生成映像）配置工作区后，使用 BuildWSKImage 生成映像（约 15-35 分钟）。

生成映像

  1. 以管理员身份启动 Windows 系统工具包生成环境（例如 E:\SetImagGenEnv.cmd）。

  2. 更新 WSKWorkspaceRoot 环境变量，使其指向要生成的映像的工作区。

    %WSKWorkspaceRoot%\SetWSKWorkspaceRoot.cmd

    注意

    你将在整个实验中看到的 %WSKWorkspaceRoot% 变量是在运行 prepwskworkspace 时自动设置的。 如果关闭再重新打开 Windows 系统工具包环境，可以通过导航到工作区文件夹并运行 SetWSKWorkspaceRoot.cmd 来设置工作区根目录。

  3. 生成映像（15-35 分钟）。 你将获得 .ffu 或虚拟硬盘文件，具体取决于你准备的工作区。

    BuildWSKImage %WSKWorkspaceRoot%\FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.xml

    注意

    你在此步骤中指定的 .xml 文件的名称可能会有所不同，具体取决于你在创建工作区时选择的选项。 可以从 WSK 环境运行 echo %WSKOEMInputFileName，以查看 OEMInput.xml 文件的完整路径和文件名。

默认情况下，输出放置在与工作区相同的位置并追加了“.output”，例如，如果工作区位于 C:\Workspace，则输出位于 C:\Workspace.output\FactoryOS_AMD64_UEFI_VM_ValidationImage.vhdx。

重要

如果尝试在已包含同名 .FFU 映像或虚拟硬盘的目标文件夹中生成映像，映像创建操作将失败并出现以下错误：

imageapp : ERROR : ThreadId18164 OutputFile C:\FactoryOS.Output\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.ffu already exists.

生成映像之前，请执行以下操作之一：

  • 在 BuildWSKImage 命令中指定 Overwrite 参数，以自动覆盖输出文件夹中的映像
  • 确保输出文件夹尚未包含已生成的同名映像。

BuildWSKImage 语法

BuildWSKImage [OEMInput] [Destination] [Overwrite]
参数 说明
OEMInput 可选。 映像配置文件的路径。
目标 可选。 输出的目标目录。 默认情况下，该脚本会在 WSKWorkspace 文件夹之外创建一个文件夹，并在名称后面追加“.output”。
Overwrite 可选。 覆盖输出文件。 如果不指定此参数，并且输出文件夹中已存在映像文件，映像创建将失败。

部署映像