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


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

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

События построения выполняются, только если в процессе построения успешно выполняются эти этапы. Если во время построения возникает ошибка, событие post-build не происходит; если ошибка возникает до фазы компоновки, не происходят события pre-link и post-build. Кроме того, если не требуется выполнять связывание файлов, событие pre-link также не происходит. Событие pre-link также недоступно в проектах, в которых отсутствует этап компоновки.

Если нет файлов, для которых необходимо выполнить построение, то не происходит никаких событий построения.

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

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

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

  2. Откройте диалоговое окно Страницы свойств проекта. Для получения дополнительной информации см. Работа со свойствами проектов.

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

  4. Задайте свойства для этого события построения.

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

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

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

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

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

См. также

Ссылки

Сведения об этапах настраиваемого построения и событиях построения.

Устранение неполадок настроек построения

Другие ресурсы

Макросы для команд и свойств построения