Compartilhar via

/Build (devenv.exe)

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

Sintaxe

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

Argumentos

  • SolutionName

    Necessário. 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 (como Debug ou Release) a ser usado para criar a solução nomeada em SolutionName. Se várias plataformas de solução estiverem disponíveis, você também deverá especificar a plataforma (por exemplo, Debug|Win32). Se esse argumento não for especificado ou uma cadeia de caracteres vazia (""), a ferramenta usará a configuração ativa da solução.

  • /Project ProjName

    Opcional. O caminho e o nome de um arquivo de projeto dentro da solução. Você pode inserir um caminho relativo da pasta SolutionName para o arquivo de projeto ou o nome de exibição do projeto ou o caminho completo e o nome do arquivo de projeto.

  • projConfigName /ProjectConfig

    Opcional. O nome de uma configuração de build de projeto (como Debug ou Release) a ser usado ao compilar o projeto nomeado. Se mais de uma plataforma de solução estiver disponível, você também deverá especificar a plataforma (por exemplo, Debug|Win32). Se essa opção for especificada, ela substituirá o argumento SolnConfigName.

  • /Out OutputFilename

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

Observações

  • A opção /Build executa a mesma função que o comando de menu Build Solution no IDE (ambiente de desenvolvimento integrado).

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

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

  • A opção /Build compila apenas projetos que foram alterados desde a última compilação. Para criar todos os projetos em uma solução, use /rebuild em vez disso.

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

Exemplos

O comando a seguir cria 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 build:

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

Criar um projeto de instalação

Para criar um instalador (.msi arquivo), você precisa de uma de projeto de instalação, que tem um arquivo de projeto .vdproj, mas para compilá-lo, primeiro você precisa aplicar uma solução alternativa que define uma chave do Registro específica. No prompt de comando do Desenvolvedor do Visual Studio, execute o DisableOutOfProcBuild.exe executável na pasta Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild. Sem essa solução alternativa, você pode receber 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, execute-o 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 , digamos Setup, com base na configuração de Release 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 padrão, Debug e Release. Com a configuração de Setup definida, os seguintes comandos criam um projeto WindowsFormsApp1 e seu projeto de instalação associado para gerar o arquivo .msi:

devenv WindowsFormsApp1.sln /build Setup

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

Consulte também

  • Last updated on