Partilhar via

/Build (devenv.exe)

  • Artigo

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, relativos 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 for 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.

  • /ProjectConfig ProjConfigName

    Opcional. O nome de uma configuração de compilação de projeto (como Debug ou Release) a ser usada ao criar 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.

Comentários

  • O switch /Build executa a mesma função que o comando de menu Build Solution dentro do ambiente de desenvolvimento integrado (IDE).

  • Inclua cadeias de caracteres que incluam espaços entre aspas duplas.

  • Informações de resumo para compilações, 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 cria 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 dizendo Configuração de projeto inválida, certifique-se de que especificou uma plataforma de solução ou plataforma de projeto (por exemplo, Debug|Win32).

Exemplos

O comando a seguir cria o projeto CSharpWinApp, usando a configuração de compilação do projeto Debug dentro 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 (arquivo.msi), você precisa de um projeto de instalação , que tem um arquivo de projeto .vdproj, mas para criá-lo você primeiro precisa aplicar uma solução alternativa que define uma chave do Registro específica. No prompt de comando do Visual Studio Developer, execute o DisableOutOfProcBuild.exe executável da 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 compilação, certifique-se de executá-lo a partir da mesma conta que executa a compilação. Para obter mais informações, consulte o arquivo README.txt na mesma pasta.

Além disso, no Visual Studio, você pode criar um novo de configuração, digamos Setup, com base na configuração 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 Setup definida, os comandos a seguir 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á foi criada com a configuração do Release, este comando apenas cria o projeto de instalação.

Ver também