Alterar o diretório de saída do build

Você pode especificar o local de saída gerado pelo seu projeto por 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 SDK, e alguns projetos usam subpastas específicas da plataforma ou 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 ter controle total 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 do usuário do Designer de Projeto, dependendo do tipo de projeto. O .NET Framework do C# e todos os projetos do Visual Basic usam o Designer de Projeto do .NET herdado, mas os projetos .NET Core do C# (e .NET 5 e posteriores) usam o Designer de Projeto do .NET atual. Os projetos de C++ usam a própria interface do 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 do build

C# .NET Core

Este procedimento é aplicável a projetos C# no Visual Studio 2022 visando o .NET Core ou o .NET 5 e posterior.

1. Limpe o projeto ou a solução para remover todos os arquivos de saída existentes (Build>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. Expanda a seção Compilar e role até a subseção Saída.

4. Encontre o Caminho de saída de base do C# 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 de base para gerar o caminho de saída real.

   

   Observação

   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 de Projeto e 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 compila cada projeto de uma solução em sua própria pasta dentro da solução. É possível alterar os caminhos de saída do build dos seus projetos para forçar todas as saídas a serem colocadas na mesma pasta.

1. Limpe ou a solução para remover todos os arquivos de saída existentes (Build>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 seguinte declaração de propriedade ao primeiro grupo de propriedades.

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

   A configuração de UseCommonOutputDirectory como 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 omitirá a etapa de cópia que normalmente acontece quando os projetos dependem de outros projetos.

6. Repita as etapas de 2 a 5 para todos os projetos na solução. Você poderá ignorar alguns projetos se tiver alguns projetos excepcionais que não devam 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.

VB e .NET Framework

Este procedimento é aplicável a projetos do .NET Framework e projetos do Visual Basic.

1. Limpe o projeto ou a solução para remover todos os arquivos de saída existentes (Build>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 Build.
   • 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 compila cada projeto de uma solução em sua própria pasta dentro da solução. É possível alterar os caminhos de saída do build dos seus projetos para forçar todas as saídas a serem colocadas na mesma pasta.

1. Limpe ou a solução para remover todos os arquivos de saída existentes (Build>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 seguinte declaração de propriedade ao primeiro grupo de propriedades.

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

   A configuração de UseCommonOutputDirectory como 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 omitirá a etapa de cópia que normalmente acontece quando os projetos dependem de outros projetos.

6. Repita as etapas de 2 a 5 para todos os projetos na solução. Você poderá ignorar alguns projetos se tiver alguns projetos excepcionais que não devam 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.

C++

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

1. Limpe o projeto para remover todos os arquivos de saída existentes (Build>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 estiver exibindo Todas as configurações ou Todas as plataformas, você 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 seja possível defini-los individualmente, as configurações padrão usam a mesma expressão para todas as combinações, mas 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, navegar até um caminho ou (se relevante) <herdar do pai ou do padrão 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 macros, 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á fazer isso usando a sintaxe $(VAR) da variável de ambiente VAR. Ao criar um caminho usando macros e variáveis de ambiente, tenha cuidado para considerar se uma barra invertida é ou não necessária.

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 projetos.

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

C# .NET Core

Este procedimento é aplicável a projetos C# no Visual Studio 2022 visando o .NET Core ou o .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) e $(MSBuildProjectDirectory). Para ver mais propriedades que você pode usar, consulte Propriedades reservadas e conhecidas do MSBuild.

4. O Visual Studio continua criando a pasta obj na pasta do projeto quando você compila, mas ela fica vazia. Você pode excluí-la como parte do processo de build. Uma forma 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.

VB e .NET Framework

Este procedimento é aplicável a projetos do .NET Framework e projetos do Visual Basic.

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) e $(MSBuildProjectDirectory). Para ver mais propriedades que você pode usar, consulte Propriedades reservadas e conhecidas do MSBuild.

4. O Visual Studio continua criando a pasta obj na pasta do projeto quando você compila, mas ela fica vazia. Você pode excluí-la como parte do processo de build. Uma forma 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 Diretório intermediário 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 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

C# .NET Core

Se houvesse um grande número de projetos e você quisesse alterar a pasta de saída de todos eles, seria tedioso e propenso a erros alterar cada um usando os métodos descritos anteriormente neste artigo. Nesses casos, é possível criar um arquivo na pasta da solução, Directory.Build.props, para definir as propriedades apropriadas do MSBuild em um só lugar para aplicação 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 afetar, é simples manter personalizações em um único lugar e facilitar a alteração dos valores. Consulte Personalizar o build por pasta.

VB e .NET Framework

Se houvesse um grande número de projetos e você quisesse alterar a pasta de saída de todos eles, seria tedioso e propenso a erros alterar cada um usando os métodos descritos anteriormente neste artigo. Nesses casos, é possível criar um arquivo na pasta da solução, Directory.Build.props, para definir as propriedades apropriadas do MSBuild em um só lugar para aplicação 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 afetar, é simples manter personalizações em um único lugar e facilitar a alteração dos valores. Consulte Personalizar o build por pasta.

C++

Se houvesse um grande número de projetos e você quisesse alterar a pasta de saída de todos eles, seria tedioso e propenso a erros alterar cada um usando os métodos descritos anteriormente neste artigo. Nesses casos, é possível criar um arquivo na pasta da solução, Directory.Build.props, para definir as propriedades apropriadas do MSBuild em um só lugar para aplicação 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 afetar, é simples manter 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ário e final em Directory.build.props, é melhor usar $(MSBuildThisFileDirectory) em vez de $(SolutionDir) para oferecer 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 forma que funciona para builds do Visual Studio e compilações 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 do build

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

Conteúdo relacionado

• Página de build, Designer de Projeto (C#)
• Página de propriedades gerais (projeto)
• Compilar e criar