Configuração de projeto para compilar

A lista de configurações de solução para uma determinada solução é gerenciada pela caixa de diálogo Configurações da Solução.

Um usuário pode criar configurações de solução adicionais, cada uma com seu próprio nome exclusivo. Quando o usuário cria uma nova configuração de solução, o IDE assume como padrão o nome de configuração correspondente nos projetos ou Depurar se não houver um nome correspondente. O usuário pode alterar a seleção para atender a requisitos específicos, se necessário. A única exceção a esse comportamento é quando o projeto oferece suporte a uma configuração que corresponde ao nome da nova configuração de solução. Por exemplo, suponha que uma solução contenha Project1 e Project2. Project1 tem configurações de projeto Debug, Retail, e MyConfig1. O Project2 tem configurações de projeto Debug, Retail e MyConfig2.

Se o usuário criar uma nova configuração de solução chamada MyConfig2, o Project1 vinculará sua configuração de depuração à configuração da solução por padrão. O Project2 também vincula sua configuração MyConfig2 à configuração da solução por padrão.

Observação

A vinculação não diferencia maiúsculas de minúsculas.

Quando o usuário seleciona o item Seleção Múltipla na lista suspensa de configuração, o ambiente exibe uma caixa de diálogo que fornece a lista de configurações disponíveis.

Multiple Configurations Várias configurações

Nessa caixa de diálogo, o usuário pode selecionar uma ou várias configurações. Depois de selecionados, os valores de propriedade exibidos na caixa de diálogo páginas de propriedades refletem a interseção de valores para as configurações selecionadas.

Consulte Configuração da Solução para obter informações relacionadas à adição e renomeação de configurações para soluções e projetos.

As dependências do projeto e a ordem de compilação são independentes da configuração da solução: ou seja, você só pode configurar uma árvore de dependências para todos os projetos na solução. Clicar com o botão direito do mouse na solução ou projeto e selecionar a opção Dependências do Projeto ou Ordem de Compilação do Projeto abre a caixa de diálogo Dependências do Projeto. Ele também pode ser aberto no menu Projeto .

Project Dependencies Dependências do projeto

As dependências do projeto determinam a ordem na qual os projetos são criados. Use a guia Ordem de compilação na caixa de diálogo para exibir a ordem exata em que os projetos em uma solução serão criados e use a guia Dependências para modificar a ordem de compilação.

Observação

Os projetos na lista que têm suas caixas de seleção marcadas, mas aparecem esmaecidas, foram adicionados pelo ambiente devido a dependências explícitas especificadas pelas IVsBuildDependency interfaces ou IVsDeployDependency e não podem ser alterados. Por exemplo, adicionar uma referência de projeto de um projeto Visual Basic para outro projeto adiciona automaticamente uma dependência de compilação que só pode ser removida excluindo a referência. Projetos cujas caixas de seleção estão desmarcadas e aparecem esmaecidas não podem ser marcados porque isso criaria um loop de dependência (por exemplo, Project1 seria dependente de Project2 e Project2 seria dependente de Project1), o que paralisaria a compilação.

Os processos de compilação do Visual Studio incluem as operações típicas de compilação e vinculação que são invocadas com um único comando Build. Dois outros processos de compilação também podem ser suportados: uma operação limpa para excluir todos os itens de saída de uma compilação anterior e uma verificação atualizada para determinar se um item de saída em uma configuração foi alterado.

  • IVsProjectCfg2 objetos retornam um correspondente IVsBuildableProjectCfg (retornado de ) para gerenciar seus processos de get_CfgTypecompilação. Para relatar o status de uma operação de compilação enquanto ela está ocorrendo, as configurações fazem chamadas para IVsBuildStatusCallback, uma interface implementada pelo ambiente e qualquer outro objeto interessado em eventos de status de compilação.

Uma vez criadas, as definições de configuração podem ser usadas para determinar se podem ou não ser executadas sob o controle do depurador. As configurações são implementadas IVsDebuggableProjectCfg para oferecer suporte à depuração.

Depois de implementar as dependências do projeto, você pode manipular programaticamente as dependências por meio do modelo de automação. Você chama BuildDependencies o modelo de automação. Não há interfaces de nível de API VSIP disponíveis que permitam a manipulação direta das configurações do gerenciador de compilação da solução e suas propriedades.

Além disso, você pode fornecer uma grade na janela de dependências do projeto. Para obter mais informações, consulte Grade de exibição de propriedades.

Confira também