Задание событий сборки

  • Статья

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

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

Если отсутствуют файлы для сборки, события сборки не возникают.

Общие сведения о событиях сборки см. в разделе Сведения об этапах настраиваемой сборки и событиях сборки.

Чтобы указать событие сборки

  1. В обозревателе решений выберите проект, для которого необходимо задать событие сборки.

  2. Откройте диалоговое окно Страницы свойств проекта. Подробнее см. в статье Настройка компилятора C++ и свойств сборки в Visual Studio.

  3. В папке События сборки выберите страницу свойств события сборки.

  4. Укажите свойства, связанные с событием сборки:

    • В поле Командная строка укажите команду так, как использовали бы ее в командной строке. Укажите допустимую команду или пакетный файл, а также все нужные входные или выходные файлы. Укажите пакетную команду call перед именем пакетного файла, чтобы обеспечить выполнение всех последующих команд.

      Несколько входных и выходных файлов можно указать символьно с помощью макросов MSBuild. Сведения о том, как указать расположение файлов и имена наборов файлов, см. в разделе Стандартные макросы для команд и свойств сборки.

      Так как символ "%" зарезервирован MSBuild, при указании переменной среды замените каждый escape-символ % шестнадцатеричной escape-последовательностью %25. Например, замените %WINDIR% на %25WINDIR%25. MSBuild заменяет каждую последовательность %25 на символ % перед обращением к переменной среды.

    • В поле Описание введите описание события. Это описание выводится в окне Вывод при возникновении данного события.

    • В поле Исключено из сборки укажите Да, если запускать событие не нужно.

См. также

Сведения об этапах настраиваемой сборки и событиях сборки
Стандартные макросы для команд и свойств сборки
Устранение неполадок настроек сборки