Partilhar via

/Build (devenv.exe)

  • Artigo

Compila uma solução ou um projeto usando um arquivo de configuração de solução especificado.

Sintaxe

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

Argumentos

  • SolutionName

    Obrigatórios. O caminho e o nome do arquivo de solução, em relação ao diretório da solução.

  • SolnConfigName

    Opcional. O nome da configuração da solução (por exemplo, Debug ou Release) que será usado para compilar a solução nomeada em SolutionName. Se várias plataformas de solução estiverem disponíveis, você também precisará especificar a plataforma (por exemplo, Debug|Win32). Se esse argumento não for especificado ou for uma cadeia de caracteres vazia (""), a ferramenta usará a configuração ativa da solução.

  • /ProjectProjName

    Opcional. O caminho e o nome de um arquivo de projeto na solução. Insira um caminho relativo da pasta SolutionName para o arquivo de projeto, o nome de exibição do projeto ou o caminho completo e o nome do arquivo de projeto.

  • /ProjectConfigProjConfigName

    Opcional. Nome de uma configuração de build do projeto (por exemplo, Debug ou Release) que será usado ao compilar o projeto nomeado. Se mais de uma plataforma de solução estiver disponível, também será preciso especificar a plataforma (por exemplo, Debug|Win32). Se esta opção for especificada, ela substituirá o argumento SolnConfigName.

  • /OutNome do arquivo de saída

    Opcional. O nome de um arquivo para o qual você deseja enviar a saída da ferramenta. Se o arquivo já existir, a ferramenta anexará a saída ao final do arquivo.

Comentários

  • A opção /Build realiza a mesma função que o comando de menu Compilar Solução dentro do ambiente de desenvolvimento integrado (IDE).

  • Coloque as cadeias de caracteres que incluem espaços entre aspas duplas.

  • As informações de resumo para builds, incluindo erros, podem ser exibidas na janela Comando ou em qualquer arquivo de log especificado com a opção /Out.

  • A opção /Build compila somente os projetos que foram alterados desde o último build. Para compilar todos os projetos de uma solução, use /rebuild.

  • Se você receber uma mensagem de erro informando Configuração de projeto inválida, verifique se especificou a plataforma de solução ou a plataforma de projeto (por exemplo, Debug|Win32).

Exemplos

O comando a seguir compila o projeto CSharpWinApp, usando a configuração de build do projeto Debug dentro de MySolution.

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

E para limpar todos os arquivos de compilação:

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

Criar um projeto de configuração

Para criar um instalador (.msi arquivo), você precisa de um projeto de instalação, que tenha um arquivo de .vdproj projeto, mas para compilá-lo, primeiro você precisa aplicar uma solução alternativa que defina uma chave de registro específica. No prompt de comando do Visual Studio Developer, execute o executável DisableOutOfProcBuild.exe na pasta Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild. Sem essa solução alternativa, você pode obter o erro: ERROR: An error occurred while validating. HRESULT = '8000000A'. O comando afeta o usuário atual, portanto, para cenários de agente de build, certifique-se de executá-lo na mesma conta que executa o build. Para obter mais informações, consulte o arquivo README.txt na mesma pasta.

Além disso, no Visual Studio, você pode criar uma nova configuração, digamosSetup, com base na Release configuração, e selecionar o projeto de instalação como um projeto a ser compilado. Por padrão, os projetos de instalação não são incluídos nas configurações Debug padrão e Releaseo . Com a Setup configuração definida, os seguintes comandos criam um projeto WindowsFormsApp1 e seu projeto de instalação associado para gerar o .msi arquivo:

devenv WindowsFormsApp1.sln /build Setup

Se a solução já tiver sido criada com a configuração de versão , esse comando apenas compilará o projeto de instalação.

Confira também