Alterar o diretório de saída do build

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.

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.

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.

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.

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.

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>

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.

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.

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>