Partilhar via


Configuração da solução

As configurações da solução armazenam propriedades no nível da solução. Eles direcionam o comportamento da tecla Start (F5) e dos comandos Build . Por padrão, esses comandos criam e iniciam a configuração de depuração. Ambos os comandos são executados no contexto de uma configuração de solução. Isso significa que o usuário pode esperar que o F5 inicie e construa qualquer que seja a solução ativa configurada através das configurações. O ambiente é projetado para otimizar soluções em vez de projetos quando se trata de construção e execução.

A barra de ferramentas padrão do Visual Studio contém um botão Iniciar e uma lista suspensa de configuração da solução à direita do botão Iniciar. Essa lista permite que os usuários escolham a configuração a ser iniciada quando F5 é pressionado, criem suas próprias configurações de solução ou editem uma configuração existente.

Observação

Não há interfaces de extensibilidade para criar ou editar as configurações da solução. Você deve usar DTE.SolutionBuild. No entanto, existem APIs de extensibilidade para gerenciar a compilação da solução. Para obter mais informações, consulte IVsSolutionBuildManager2.

Veja como você pode implementar as configurações de solução suportadas pelo seu tipo de projeto:

  • Projeto

    Exibe os nomes dos projetos encontrados na solução atual.

  • Configuração

    Para fornecer a lista de configurações suportadas pelo seu tipo de projeto e apresentadas nas páginas de propriedades, implemente IVsCfgProvider2.

    A coluna Configuração exibe o nome da configuração do projeto a ser compilada nessa configuração de solução e lista todas as configurações do projeto quando você clica no botão de seta. O ambiente chama o GetCfgNames método para preencher essa lista. Se o GetCfgProviderProperty método indicar que o projeto oferece suporte à edição de configuração, as seleções Novo ou Editar também serão exibidas sob o título Configuração. Cada uma dessas seleções inicia caixas de diálogo que chamam métodos da IVsCfgProvider2 interface para editar as configurações do projeto.

    Se um projeto não oferecer suporte a configurações, a coluna Configuração exibirá Nenhum e será desabilitada.

  • Platform

    Exibe a plataforma para a qual a configuração do projeto selecionado se baseia e lista todas as plataformas disponíveis para o projeto quando você clica no botão de seta. O ambiente chama o GetPlatformNames método para preencher essa lista. Se o GetCfgProviderProperty método indicar que o projeto suporta edição de plataforma, as seleções Novo ou Editar também serão exibidas sob o título Plataforma. Cada uma dessas seleções inicia janelas que chamam métodos IVsCfgProvider2 para editar as plataformas que o projeto tem disponíveis.

    Se um projeto não oferecer suporte a plataformas, a coluna de plataforma desse projeto exibirá Nenhum e será desabilitada.

  • Construir

    Especifica se o projeto é ou não criado pela configuração atual da solução. Projetos não selecionados não são criados quando os comandos de compilação no nível da solução são invocados, apesar de quaisquer dependências de projeto que eles contenham. Os projetos não selecionados para serem criados ainda estão incluídos na depuração, execução, empacotamento e implantação da solução.

  • Deploy

    Especifica se o projeto será implantado ou não quando os comandos Iniciar ou Implantar forem usados com a configuração de compilação da solução selecionada. A caixa de seleção para este campo estará disponível se o projeto oferecer suporte à implantação implementando a IVsDeployableProjectCfg interface em seu IVsProjectCfg2 objeto.

    Depois que uma nova configuração de solução é adicionada, o usuário pode selecioná-la na caixa de listagem suspensa Configuração da solução na barra de ferramentas padrão para criar e/ou iniciar essa configuração.