Настройка ОС проверки с помощью построителя образов ОС проверки

Статья
05/30/2024

Вы можете добавить пакеты драйверов и пакеты настройки ОС проверки, чтобы убедиться, что ОС проверки может загружать и поддерживать приложения для ваших сценариев. Пакеты настройки можно использовать для добавления поддержки нескольких функциональных возможностей по запросу, описанных далее в документе.

Операционная система проверки не отправляется с драйверами папки "Входящие", поэтому необходимо убедиться, что вы добавите драйверы, прежде чем применить образ к компьютеру.

Общий процесс

Общий процесс создания образа операционной системы проверки с помощью построителя образов ОС проверки приведен ниже.

Подключите ISO-файл ОПЕРАЦИОННОй системы проверки к определенному расположению в файловой системе технического компьютера;
Запустите соответствующую ValidationOSImageBuilder.exe на основе собственной архитектуры технического компьютера (x64 или arm64);
Выполните действия, описанные в разделе "Проверка образа ОС ImageBuilder"
1. [Необязательно] Выберите расположение созданного образа ОС проверки;
2. [Необязательно] Добавьте драйверы в подключенный образ ОС проверки;
3. [Необязательно] Добавьте одну или несколько необходимых функций по запросу;
4. [Необязательно] Установка и переопределение разделов реестра в образе ОС проверки;
5. [Необязательно] Включите пользовательские двоичные файлы и приложения в образ ОС проверки;
6. [Необязательно] Создайте решение Visual Studio со ссылками на пакет SDK, соответствующий созданному образу ОС проверки.

Начало работы с построителем образов ОС проверки

Построитель образов ОС проверки — это средство графического интерфейса, которое позволяет легко создавать пользовательский образ ОС проверки для конкретного сценария. Он позволяет добавлять

необязательные пакеты, такие как Audio, Bluetooth, Камера, Мультимедиа, USB и т. д.
драйверы для конкретного оборудования
другие программные приложения, которые необходимо включить в образ ОС проверки
Разделы реестра, которые необходимо включить в образе ОС проверки при запуске
команды запуска, которые требуется запустить при запуске ОС

Он также позволяет создать пакет SDK, который можно использовать для конкретного создаваемого образа ОС проверки.

Список доступных необязательных пакетов featuire можно найти здесь: пакеты компонентов

Использование построителя образов ОС проверки

Ниже приведены пошаговые инструкции по использованию базового потока построителя образов ОС проверки из пакета ISO для проверки ОС.

Подключите пакет ISO ОС проверки и перейдите в <ISO_ROOT>:\ImageBuilder папку, где <ISO_ROOT>: находится диск, на котором был подключен ISO.
Запустите ValidationOSImageBuilder.exe, чтобы запустить построителе образов ОС проверки и примите запрос на запуск программы с правами Администратор istrator
Нажмите кнопку "Начать работу", чтобы перейти на экран "Функции"
На экране "Компоненты" выберите компоненты, которые вы хотите добавить в образ ОС проверки, и нажмите кнопку "Далее", чтобы перейти на экран "Драйверы" (см. список доступных функций в приведенном выше разделе).
На экране необязательных драйверов выберите папку, в которой находятся драйверы для устройства.
На этом экране можно также добавить следующие компоненты в изображение.
1. Необязательная папка программного обеспечения: это позволяет включить папку, содержащую необязательные .EXE файлы, которые будут включены в образ операционной системы проверки
2. Файл реестра: это позволяет отправить файл. REG-файл, содержащий записи реестра, которые будут включены в образ ОС проверки во время загрузки
3. Команды запуска: это позволяет добавить .EXE файл в образ ОС проверки, который будет выполняться во время загрузки.
Нажмите кнопку "Далее", чтобы перейти к экрану вывода
На экране вывода можно
1. Выберите папку, в которой будет создан выходной WIM-файл и другие компоненты (по умолчанию )C:\ValidationOS
2. укажите, будет ли образ ОПЕРАЦИОННОй системы проверки (WIM) загружаться с USB-диска или жесткого диска (по умолчанию — USB)
3. выберите, должен ли построитель образов ПРОВЕРКИ ОС создать связанный пакет SDK для пользовательского образа проверки ОС, созданного или нет
4. Сохраните последние используемые параметры построителя образов ОС проверки в файл шаблона для использования в будущем
Нажмите кнопку "Далее", чтобы перейти к экрану "Просмотр" и "Готово", в котором отображаются все параметры функций, драйверов и выходных данных, которые вы выбрали один последний раз.
Нажмите кнопку "Создать", чтобы создать образ ОС проверки.
После создания образа операционной системы проверки вы увидите возможность перейти к выходной папке, где будет отображаться только что созданный файл ValidationOS.wim.

Примечание.

ValidationOS-2.wim также создается в папке GenImageOutput. Это оптимизированный образ, содержащий только секцию, соответствующую типу загрузки, выбранному на экране "Драйверы".

Использование командной строки построителя образов ОС проверки

Все функциональные возможности, доступные в графическом интерфейсе построителя образов операционной системы проверки ОС, также доступны в командной строке конструктора образов проверки. Чтобы использовать команду конструктора образов операционной системы проверки, перейдите в <ISO_ROOT>:\IBCLI папку, где <ISO_ROOT>: находится диск, на котором был подключен ISO.

Вызывается 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.

В Обозреватель перейдите в выходную папку (которая обычно называетсяC:\ValdationOS<Date-Time of image creation>), где появится папка с именем sdk. В этой папке появится файл .sln . Дважды щелкните этот файл, чтобы открыть его в Visual Studio.

В представлении Обозреватель решений в Visual Studio отобразится файл .cpp. Этот файл можно изменить с помощью кода или добавить собственные файлы кода в этот проект. Чтобы просмотреть ссылки на проекты в пакетах Nuget, щелкните правой кнопкой мыши ссылки в представлении Обозреватель решений и выберите "Управление пакетами Nuget"

Чтобы создать решение, выберите "Сборка" в главном меню и выберите "Создать решение", которое создаст файл .exe из этого кода для пользовательского образа ОС проверки.

Использование APIValidator с apisurface.xml

Наряду с изображением ValidationOS.wim построитель образов также создает файл apisurface.xml в папке API. Этот файл содержит список ссылок всех функций API, поддерживаемых пользовательским образом ValidationOS.wim.

Вы можете использовать средство с именем APIValidator.exe с любым файлом .exe и этим apisurface.xml файлом в качестве входных данных, чтобы определить, существуют ли несовместимости между файлом .exe и пользовательским образом ValidationOS.wim.

Чтобы установить APIValidator.exe, ознакомьтесь с инструкциями в файле <ISO_ROOT>:\SDK\ValidationOS_System_Kit-APIValidator_Usage.txt. Сначала необходимо установить WDK. После установки типичная команда для анализа .exe файла в файле поверхности API будет выглядеть следующим образом:

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

В выходных данных отобразится список ошибок, если таковые имеются, а также сведения о несовместимых зависимостях.

Примеры пакета SDK для построителя образов ОС

Вы можете просмотреть примеры кода, которые используют различные функции, предоставляемые с помощью построителя образов ОС проверки: https://github.com/microsoft/validation-OS

Поделиться через