Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Você precisa de configurações de build quando precisa criar seus projetos com configurações diferentes. Por exemplo, Depurar e Versão são configurações de build, e diferentes opções de compilador são usadas adequadamente ao compilá-las. Uma configuração está ativa e é indicada na barra de comandos na parte superior do IDE.
A configuração e o controle de plataforma em que os arquivos de saída criados são armazenados. Normalmente, quando o Visual Studio cria seu projeto, a saída é colocada em uma subpasta de projeto nomeada com a configuração ativa (por exemplo, bin/Debug/x86), mas você pode alterá-la.
Você pode criar suas próprias configurações de build no nível da solução e do projeto. A configuração da solução determina quais projetos são incluídos no build quando essa configuração está ativa. Somente os projetos especificados na configuração da solução ativa serão criados. Se várias plataformas de destino forem selecionadas no Configuration Manager, todos os projetos que se aplicam a essa plataforma serão criados. A configuração do projeto determina quais configurações de build e opções do compilador são usadas quando você cria o projeto.
Para criar, selecionar, modificar ou excluir uma configuração, você pode usar o Configuration Manager. Para abri-lo, na barra de menus, escolha Build>Configuration Manager ou apenas digite Configuração na caixa de pesquisa. Também é possível usar a lista Configurações de Solução na barra de ferramentas Standard para selecionar uma configuração ou para abrir o Configuration Manager.
Nota
Se você não encontrar as configurações de solução na barra de ferramentas e não puder acessar o Configuration Manager, pode ser porque você está usando as configurações de desenvolvimento do Visual Basic. Para obter mais informações, consulte Como: Gerenciar configurações com as configurações de desenvolvedor do Visual Basic aplicadas.
Por padrão, as configurações de Depuração () e de Versão () são incluídas em projetos criados com o uso dos modelos do Visual Studio. Uma configuração de Depurar dá suporte à depuração de um aplicativo, e uma configuração de Versão cria uma versão do aplicativo que pode ser implantada. Para obter mais informações, confira Como definir configurações de depuração e versão. Você também pode criar configurações de solução personalizadas e configurações de projeto. Para obter mais informações, consulte Como criar e editar configurações.
Configurações da solução
Uma configuração de solução especifica como os projetos na solução devem ser criados e implantados. Para modificar uma configuração de solução ou definir uma nova, no Gerenciador de Configuração, em Configuração de Solução Ativa, escolha Editar ou Novo.
Cada entrada na caixa de contextos do projeto em uma configuração de solução representa um projeto na solução. Para cada combinação de Configuração da solução ativa e Plataforma da solução ativa, é possível definir como cada projeto é usado.
Quando você define uma nova configuração de solução e seleciona o Criar novas configurações de projeto caixa de seleção, o Visual Studio cria uma nova configuração de projeto em todos os projetos. Da mesma forma, quando você define uma nova plataforma de solução e seleciona a caixa de seleção Criar novas plataformas de projeto, o Visual Studio cria a nova opção de plataforma em todos os projetos. Além disso, se você adicionar um projeto direcionado a uma nova plataforma, o Visual Studio adicionará essa plataforma à lista de plataformas de solução e disponibilizará a plataforma como uma opção em todos os projetos. Você pode modificar as configurações de cada projeto, para casos em que as plataformas não são necessárias ou suportadas por alguns projetos.
A configuração da solução ativa também fornece contexto para o IDE. Por exemplo, se você estiver trabalhando em um projeto e a configuração especificar que ele será criado para um dispositivo móvel, a caixa de ferramentas exibirá apenas itens que podem ser usados em um projeto de dispositivo móvel.
Configurações do projeto
A configuração e a plataforma que um projeto direciona são usadas em conjunto para especificar as configurações de build e as opções do compilador a serem usadas quando ele for criado. Um projeto pode ter configurações diferentes para cada combinação de configuração e plataforma. Para modificar as propriedades de um projeto, abra o menu de contexto do projeto no Gerenciador de Soluçõese escolha Propriedades. Na parte superior da guia Compilar do designer de projeto, escolha uma configuração ativa para editar as configurações de build correspondentes.
Como o Visual Studio associa configurações de projeto a configurações de solução
Quando você define uma nova configuração de solução e não copia as configurações de uma existente, o Visual Studio usa os critérios a seguir para associar as configurações de projeto existentes à nova configuração de solução. Os critérios são avaliados na ordem mostrada.
Se um projeto tiver um nome de configuração (<nome de configuração><nome da plataforma>) que corresponda ao nome da nova configuração da solução, essa configuração será usada. Nomes de configuração não diferenciam maiúsculas de minúsculas.
Se o projeto tiver um nome de configuração no qual a parte nome da configuração corresponde à nova configuração da solução, essa configuração será usada, quer a parte da plataforma corresponda ou não.
Se ainda não houver correspondência, a primeira configuração listada no projeto será usada.
Como o Visual Studio associa configurações de solução a novas configurações de projeto
Quando você cria uma configuração de projeto (no Configuration Manager, escolhendo Novo no menu suspenso na coluna Configuração desse projeto) e marca a caixa de seleção Criar novas configurações de solução o Visual Studio procura uma configuração de solução com nome semelhante para compilar o projeto em cada plataforma à que ele dá suporte. Em alguns casos, o Visual Studio renomeia as configurações de solução existentes ou define as novas.
O Visual Studio usa os seguintes critérios para associar configurações de solução a configurações de projeto:
Se uma configuração de projeto não especificar uma plataforma ou especificar apenas uma plataforma, uma configuração de solução cujo nome corresponde à da nova configuração de projeto será encontrada ou adicionada. O nome padrão dessa configuração de solução não inclui um nome de plataforma; ele usa o formulário <nome de configuração do projeto>.
Se um projeto der suporte a várias plataformas, uma configuração de solução será encontrada ou adicionada para cada plataforma com suporte. O nome de cada configuração de solução inclui o nome da configuração do projeto e o nome da plataforma e tem o formulário <nome de configuração do projeto><nome da plataforma>.
Como as configurações afetam o build
Quando você cria uma solução usando o comando Build>Build Solution, o Visual Studio cria apenas a configuração ativa. Todos os projetos especificados nessa configuração de solução são criados e a única configuração de projeto criada é aquela especificada na configuração da solução ativa e na plataforma de solução ativa, que é mostrada na barra de ferramentas no Visual Studio. Por exemplo, Depurar e x86. Outras configurações e plataformas definidas não são montadas.
Se você quiser criar várias configurações e plataformas em uma ação, poderá usar a opção Compilar>Build em Lote no Visual Studio. Para acessar esse recurso, pressione Ctrl+Q para abrir a caixa de pesquisa e insira Batch build. O build em lote não está disponível para todos os tipos de projeto. Consulte Como criar várias configurações simultaneamente.