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

/Build (devenv.exe)

  • Статья

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

Синтаксис

devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]

Аргументы

  • SolutionName

    Обязательный. Имя файла решения и путь к нему относительно каталога решения.

  • SolnConfigName

    Необязательно. Имя конфигурации решения (например, Debug или Release) для использования при сборке решения, указанного в SolutionName. Если доступно несколько платформ решений, необходимо также указать платформу (например, Debug|Win32). Если этот аргумент не определен или является пустой строкой (""), используется действующая конфигурация решения.

  • /Project ProjName

    Необязательно. Путь и имя для файла проекта в решении. Можно ввести относительный путь из папки SolutionName к файлу проекта, отображаемое имя проекта или полный путь и имя для файла проекта.

  • /ProjectConfig ProjConfigName

    Необязательно. Имя конфигурации сборки проекта (например, Debug или Release) для использования при сборке указанного проекта. Если доступно несколько платформ решений, необходимо также указать платформу (например, Debug|Win32). Если этот параметр задан, он переопределяет аргумент SolnConfigName.

  • /Out OutputFilename

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

Замечания

  • Параметр /Build выполняет те же функции, что и команда меню Выполнить сборку решения в интегрированной среде разработки (IDE).

  • Строки с пробелами заключаются в двойные кавычки.

  • Сводные данные по сборкам, включая ошибки, могут отображаться в окне команд или в любом файле журнала, указанном с помощью параметра /Out.

  • Параметр /Build выполняет сборку только тех проектов, которые изменились с момента последней сборки. Чтобы выполнить сборку всех проектов в решении, используйте /rebuild.

  • Если возникает сообщение об ошибке Недопустимая конфигурация проекта, убедитесь, что вы указали платформу решения или проекта (например, Debug|Win32).

Примеры

Следующая команда выполняет сборку проекта CSharpWinApp с использованием конфигурации сборки проекта Debug в решении MySolution.

devenv "%USERPROFILE%\source\repos\MySolution.sln" /build Debug /project "CSharpWinApp\CSharpWinApp.csproj" /projectconfig Debug

Чтобы очистить все файлы сборки, выполните следующие действия.

devenv "%USERPROFILE%\source\repos\MySolution.sln" /clean

Создание проекта установки

Чтобы создать установщик (.msi файл), вам потребуется проект установки, имеющий .vdproj файл проекта, но для его сборки сначала необходимо применить обходное решение, которое задает определенный раздел реестра. В командной строке разработчика Visual Studio запустите исполняемый файл DisableOutOfProcBuild.exe из папки Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild. Без этого обходного решения может возникнуть ошибка: ERROR: An error occurred while validating. HRESULT = '8000000A' Команда влияет на текущего пользователя, поэтому для сценариев агента сборки обязательно запустите ее из той же учетной записи, которая выполняет сборку. Дополнительные сведения см . в файле README.txt в той же папке.

Кроме того, в Visual Studio можно создать новую конфигурацию, например Setupна Release основе конфигурации, и выбрать проект установки в качестве проекта для сборки. По умолчанию проекты установки не включаются в конфигурации Debug по умолчанию и Release. Setup Определяя конфигурацию, следующие команды создают проект WindowsFormsApp1 и связанный с ним проект установки для создания .msi файла:

devenv WindowsFormsApp1.sln /build Setup

Если решение уже создано с конфигурацией выпуска , эта команда просто создает проект установки.

См. также