Alterar o diretório de saída de build

Você pode especificar o local da saída produzida pelo seu projeto com base em cada configuração (para depuração, versão ou ambas). Com as configurações padrão, as pastas de saída variam de acordo com o tipo de projeto e o SDK, com alguns projetos usando subpastas específicas da plataforma ou específicas da estrutura.

O Visual Studio fornece propriedades que permitem colocar a saída intermediária e final em pastas personalizadas, especificando os caminhos relativos à pasta do projeto ou um caminho absoluto em qualquer lugar no sistema de arquivos. Além das configurações especificadas nas propriedades do projeto do Visual Studio, você também pode personalizar ainda mais a saída editando o arquivo de projeto e usando os recursos do MSBuild e do SDK do .NET para controle completo sobre todos os aspectos da saída do projeto, seja para projetos individuais ou no nível da solução para muitos projetos.

No Visual Studio 2022, há diferentes interfaces de usuário do Designer de Projeto, dependendo do tipo de projeto. Os projetos do .NET Framework usam o Designer de Projeto do .NET herdado, mas os projetos .NET Core (e .NET 5 e posterior) usam o Designer de Projeto do .NET atual. Os projetos do C++ usam sua própria interface de usuário de páginas de propriedades. As etapas nesta seção dependem do Designer de Projeto que você está usando.

Alterar o diretório de saída de build

.NET

Este procedimento se aplica a projetos no Visual Studio 2022 voltados para .NET Core ou .NET 5 e posterior.

1. Limpe o projeto ou a solução para remover todos os arquivos de saída existentes (Compilar>Limpar solução).

2. Clique com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e selecione Propriedades .

3. Para projetos em C#, expanda a seção Compilar e role para baixo até a subseção Saída. Para o Visual Basic, expanda a seção Compilar e verifique em Geral.

4. Encontre o Caminho de saída de base e digite o caminho para o qual gerar a saída (absoluto ou relativo ao diretório raiz do projeto), ou escolha Procurar para navegar até essa pasta. Observe que o nome da configuração é acrescentado ao caminho de saída base para gerar o caminho de saída real.

   C#:

   

   Visual Basic:

   

   Nota

   Alguns projetos (.NET e ASP.NET Core) incluirão, por padrão, a versão da estrutura ou o identificador de runtime no caminho de saída final. Para alterar isso, clique com o botão direito do mouse no nó do projeto no Gerenciador de Soluções, selecione Editar Arquivo do Projetoe adicione o seguinte:

   <PropertyGroup>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
     <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
   </PropertyGroup>
   

Compilar para um diretório de saída em comum

Por padrão, o Visual Studio cria cada projeto em uma solução em sua própria pasta dentro da solução. Você pode alterar os caminhos de saída de build de seus projetos para forçar que todas as saídas sejam colocadas na mesma pasta.

1. Limpe a solução para remover todos os arquivos de saída existentes (Compilar>Limpar solução).

2. Clique em um projeto na solução.

3. No menu Projeto, clique em Propriedades.

4. Em cada projeto, dependendo do tipo, selecione Compilar ou Build e defina o Caminho de saída ou o Caminho de saída de base como a pasta a ser usada para todos os projetos na solução.

5. Abra o arquivo de projeto do projeto e adicione a declaração de propriedade a seguir ao primeiro grupo de propriedades.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <UseCommonOutputDirectory>true</UseCommonOutputDirectory>
   </PropertyGroup>
   

   A configuração UseCommonOutputDirectory para true informa ao Visual Studio e ao mecanismo de build subjacente (MSBuild) que você está colocando várias saídas de projeto na mesma pasta e, portanto, o MSBuild omite a etapa de cópia que normalmente acontece quando os projetos dependem de outros projetos.

6. Repita as etapas 2 a 5 para todos os projetos na solução. Você pode ignorar alguns projetos se tiver alguns projetos excepcionais que não devem usar o diretório de saída comum.

Dica

Se a saída não está sendo gerada para o local que especificou, verifique se você está compilando a configuração correspondente (por exemplo, Depuração ou Versão), selecionando-a na barra de menus do Visual Studio.

.NET Framework

Esse procedimento se aplica a projetos do .NET Framework.

1. Limpe o projeto ou a solução para remover todos os arquivos de saída existentes (Compilar>Limpar solução).

2. Clique com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e selecione Propriedades.

3. Selecione a guia apropriada com base no tipo de projeto:

   • Para C#, selecione a guia Compilar.
   • Para o Visual Basic, selecione a guia Compilar.

4. Na lista suspensa de configuração na parte superior, escolha a configuração cujo local do arquivo de saída você deseja alterar (Depuração, Versão ou Todas as Configurações).

5. Localize a entrada do caminho de saída na página, ela é diferente dependendo do tipo de projeto:

   • caminho de saída para projetos C# e JavaScript
   • Caminho de saída de build para projetos Visual Basic

   Digite o caminho para o qual gerar a saída (absoluto ou relativo para o diretório raiz do projeto), ou escolha Procurar para, em vez disso, navegar até essa pasta.

   

Compilar para um diretório de saída em comum

Por padrão, o Visual Studio cria cada projeto em uma solução em sua própria pasta dentro da solução. Você pode alterar os caminhos de saída de build de seus projetos para forçar que todas as saídas sejam colocadas na mesma pasta.

1. Limpe a solução para remover todos os arquivos de saída existentes (Compilar>Limpar solução).

2. Clique em um projeto na solução.

3. No menu Projeto, clique em Propriedades.

4. Em cada projeto, dependendo de seu tipo, selecione Compilar ou Criare defina o caminho de saída ou o caminho de saída base para uma pasta a ser utilizada por todos os projetos na solução.

5. Abra o arquivo de projeto do projeto e adicione a declaração de propriedade a seguir ao primeiro grupo de propriedades.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <UseCommonOutputDirectory>true</UseCommonOutputDirectory>
   </PropertyGroup>
   

   A configuração UseCommonOutputDirectory para true informa ao Visual Studio e ao mecanismo de build subjacente (MSBuild) que você está colocando várias saídas de projeto na mesma pasta e, portanto, o MSBuild omite a etapa de cópia que normalmente acontece quando os projetos dependem de outros projetos.

6. Repita as etapas 2 a 5 para todos os projetos na solução. Você pode ignorar alguns projetos se tiver alguns projetos excepcionais que não devem usar o diretório de saída comum.

Dica

Se a saída não estiver sendo gerada para o local especificado, verifique se você está criando a configuração correspondente (por exemplo, Depuração ou Lançamento), selecionando-a na barra de menus do Visual Studio.

C++

Para alterar o diretório de saída de build para um único projeto C++:

1. Limpe o projeto para remover todos os arquivos de saída existentes (Compilar>Limpar solução).

2. Clique com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e selecione Propriedades.

3. Selecione a guia Geral.

4. Na lista suspensa de configuração na parte superior, escolha a configuração cujo local do arquivo de saída você deseja alterar (Depuração, Versão ou Todas as Configurações).

   Se você estiver exibindo Todas as Configurações ou Todas as Plataformas, poderá ver <different options> para algumas das propriedades. Os valores de propriedade podem ser diferentes para cada combinação de configuração e plataforma. Embora você possa defini-las individualmente, as configurações padrão usam a mesma expressão para todas as combinações, mas elas usam as macros $(Configuration) e $(Platform) para produzir um caminho de saída exclusivo para cada combinação.

5. Localize o caminho de saída no diretório de saída . A lista suspensa fornece opções para editar a expressão ou navegar até um caminho ou, se relevante, <herdar do padrão do pai ou do projeto>.

   Digite o caminho para o qual gerar a saída (absoluto ou relativo para o diretório raiz do projeto), ou escolha Procurar para, em vez disso, navegar até essa pasta.

   

   Para expressões que dependem de valores de macro, clique em Macros >> para exibir as macros disponíveis e seus valores. A caixa de diálogo também mostra o valor expandido final da propriedade com os valores de macro atuais.

   Todas as variáveis de ambiente são expostas no MSBuild como propriedades, portanto, se você precisar fazer referência a uma variável de ambiente, poderá referenciá-la usando a sintaxe $(VAR) para a variável de ambiente VAR. Ao criar um caminho usando macros e variáveis de ambiente, tenha cuidado ao considerar se uma barra invertida é necessária ou não.

Este procedimento define uma propriedade OutDir no arquivo de projeto (.vcxproj). Se você exibir o arquivo de projeto depois de definir essa propriedade, verá que o código semelhante ao seguinte foi adicionado:

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
    <OutDir>C:\MyOutputFolder</OutDir>
  </PropertyGroup>

Para obter mais informações, consulte Página de Propriedades Gerais e para ter certeza de que você está familiarizado com como trabalhar com páginas de propriedades C++ para entender como os valores de propriedade podem depender de configurações e plataformas, consulte Trabalhando com propriedades de projeto.

Definir o diretório de saída intermediário para um projeto

.NET

Este procedimento se aplica a projetos no Visual Studio 2022 voltados para .NET Core ou .NET 5 e posterior.

1. Limpe o projeto para remover todos os arquivos de saída existentes.

2. Abra o arquivo de projeto.

3. Adicione a declaração de propriedade a seguir ao primeiro grupo de propriedades.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <IntermediateOutputPath>path</IntermediateOutputPath>
   </PropertyGroup>
   

   O caminho é relativo ao arquivo de projeto ou você pode usar um caminho absoluto. Se você quiser colocar o nome do projeto no caminho, poderá referenciá-lo usando as propriedades do MSBuild $(MSBuildProjectName), $(MSBuildProjectDirectory). Para ver mais propriedades que você pode usar, consulte Propriedades reservadas e conhecidas do MSBuild.

4. O Visual Studio ainda cria a pasta obj na pasta do projeto quando você cria, mas ela está vazia. Você pode excluí-lo como parte do processo de build. Uma maneira de fazer isso é adicionar um evento pós-build para executar o seguinte comando:

   rd "$(ProjectDir)obj" /s /q
   

   Consulte Especificar eventos de build personalizados.

.NET Framework

Esse procedimento se aplica a projetos do .NET Framework.

1. Limpe o projeto para remover todos os arquivos de saída existentes.

2. Abra o arquivo de projeto.

3. Adicione a declaração de propriedade a seguir ao primeiro grupo de propriedades.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <IntermediateOutputPath>path</IntermediateOutputPath>
   </PropertyGroup>
   

   O caminho é relativo ao arquivo de projeto ou você pode usar um caminho absoluto. Se você quiser colocar o nome do projeto no caminho, poderá referenciá-lo usando as propriedades do MSBuild $(MSBuildProjectName), $(MSBuildProjectDirectory). Para ver mais propriedades que você pode usar, consulte Propriedades reservadas e conhecidas do MSBuild.

4. O Visual Studio ainda cria a pasta obj na pasta do projeto quando você cria, mas ela está vazia. Você pode excluí-lo como parte do processo de build. Uma maneira de fazer isso é adicionar um evento pós-build para executar o seguinte comando:

   rd "$(ProjectDir)obj" /s /q
   

   Consulte Especificar eventos de build personalizados.

C++

Use a propriedade Intermediate Directory para definir o diretório para saída intermediária, como arquivos .obj.

No arquivo de projeto, a propriedade é IntDir. Para definir os caminhos para a saída intermediária e final no arquivo de projeto, adicione um grupo de propriedades como o seguinte:

  <PropertyGroup>
    <OutDir>$(SolutionDir)out\$(Platform)\$(Configuration)\</OutDir>
    <IntDir>$(SolutionDir)int\$(MSBuildProjectName)\$(Platform)\$(Configuration)\</IntDir>
  </PropertyGroup>

Use Directory.Build.props para definir o diretório de saída

.NET

Se você tiver um grande número de projetos e quiser alterar a pasta de saída para todos eles, será entediante e propenso a erros alterar cada um usando os métodos descritos anteriormente neste artigo. Nesses casos, você pode criar um arquivo na pasta da solução, Directory.Build.props, para definir as propriedades apropriadas do MSBuild em um só lugar, para aplicar a todos os projetos na solução. Ao colocar um arquivo com esse nome específico na pasta pai de todos os projetos que você deseja que sejam afetados, você pode manter facilmente as personalizações em um único lugar e facilitar a alteração dos valores. Confira Personalizar o build por pasta.

.NET Framework

Se você tiver um grande número de projetos e quiser alterar a pasta de saída para todos eles, será entediante e propenso a erros alterar cada um usando os métodos descritos anteriormente neste artigo. Nesses casos, você pode criar um arquivo na pasta da solução, Directory.Build.props, para definir as propriedades apropriadas do MSBuild em um só lugar, para aplicar a todos os projetos na solução. Ao colocar um arquivo com esse nome específico na pasta pai de todos os projetos que você deseja que sejam afetados, você pode manter facilmente as personalizações em um único lugar e facilitar a alteração dos valores. Confira Personalizar o build por pasta.

C++

Se você tiver um grande número de projetos e quiser alterar a pasta de saída para todos eles, será entediante e propenso a erros alterar cada um usando os métodos descritos anteriormente neste artigo. Nesses casos, você pode criar um arquivo na pasta da solução, Directory.Build.props, para definir as propriedades apropriadas do MSBuild em um só lugar, para aplicar a todos os projetos na solução. Ao colocar um arquivo com esse nome específico na pasta pai de todos os projetos que você deseja que sejam afetados, você pode manter facilmente as personalizações em um único lugar e facilitar a alteração dos valores. Consulte Personalizar builds do C++.

Para definir os caminhos de saída intermediários e finais no Directory.build.props, é melhor usar $(MSBuildThisFileDirectory) em vez de $(SolutionDir) para dar suporte a builds de projeto de linha de comando, em que $(SolutionDir) não está definido. O código a seguir define ambos de uma maneira que funciona para builds do Visual Studio e builds de linha de comando de projetos individuais:

<Project>
<PropertyGroup>
    <SolutionDir Condition="'$(SolutionDir)' == ''">$(MSBuildThisFileDirectory)</SolutionDir>
    <OutDir>$(SolutionDir)out\$(Platform)\$(Configuration)\</OutDir>
    <IntDir>$(SolutionDir)int\$(MSBuildProjectName)\$(Platform)\$(Configuration)\</IntDir>
  </PropertyGroup>
</Project>

Usar artefatos para organizar a saída de build

Para projetos do .NET 8, você pode usar a funcionalidade de artefatos para organizar a saída de maneira altamente personalizável e flexível. Confira Layout da saída de artefatos.

Conteúdo relacionado

• Página de build, Designer de Projeto (C#)
• Página de Propriedade Geral (projeto)
• Compilação e build