Compartilhar via


Criar e editar configurações

Você pode criar várias configurações de build para uma solução, além das configurações internas de Depuração e Versão. Por exemplo, você pode criar uma configuração de Teste para builds de teste internos e pode configurar diferentes tipos de builds que podem ser distribuídos para clientes diferentes.

Configurações de build

É possível usar a caixa de diálogo Configuration Manager ou modificar configurações de build existentes ou compilar novas configurações.

Para abrir a caixa de diálogo do Configuration Manager, no Gerenciador de Soluções, abra o menu de atalho da solução e, em seguida, escolha Configuration Manager.

Você também pode abrir o Configuration Manager clicando na lista suspensa na barra de ferramentas do Visual Studio, o que permite escolher a configuração atual (por exemplo, Depuração ou Versão).

Captura de tela da caixa de diálogo do Configuration Manager.

Há dois níveis de configuração: a configuração da solução e a do projeto. A configuração da solução é o que você escolhe ao alternar as configurações ativas usando a barra de ferramentas no Visual Studio. A configuração do projeto é a configuração específica em cada projeto.

Na caixa de diálogo Configuration Manager é possível usar a lista suspensa Configuração da solução ativa para selecionar uma configuração de build em toda a solução, modificar uma existente ou criar uma nova configuração. É possível usar a lista suspensa Plataforma da solução ativa para selecionar a plataforma que a configuração define como destino, modificar uma existente ou adicionar uma plataforma. Se você adicionar uma plataforma de solução, ela precisará ter suporte de pelo menos um dos projetos.

O painel Contextos do projeto lista os projetos na solução. Para cada projeto, é possível selecionar configuração e plataforma específicas de projeto, modificar existentes ou criar uma configuração ou adicionar uma nova plataforma de uma lista de plataformas com suporte do Visual Studio. Também é possível marcar caixas de seleção que indicam se cada projeto está incluído quando você usa a configuração em toda a solução para compilar ou implantar a solução.

Aviso

O Visual Studio não impõe nenhum requisito de que as plataformas de projeto escolhidas nesta caixa de diálogo correspondam à plataforma da solução. Por exemplo, nada impede você de definir todas as plataformas de projeto como x86 quando a plataforma de solução ativa for x64, portanto, evite confusões e escolha plataformas de projeto que correspondam à plataforma de solução sempre que possível.

Definir as propriedades com base nas configurações

Para definir as propriedades com base nas configurações, no Gerenciador de Soluções, abra o menu de atalho para um projeto e, em seguida, escolha Propriedades.

A maioria das propriedades do projeto não depende da configuração nem da plataforma, mas algumas dependem. Para uma configuração de Versão, é possível especificar que o código seja otimizado quando a solução for compilada, e para uma configuração de Depuração, é possível especificar que o símbolo de compilação condicional DEBUG seja incluído. Você também pode escolher quais avisos deseja suprimir, ou elevar a erros, de modo diferente com base na configuração ou na plataforma, bem como controlar determinadas configurações que afetam algumas opções do compilador; Estouro aritmético, Alinhamento de arquivo e a opção do compilador /deterministic.

Nas páginas de propriedades do projeto, as páginas que têm configurações que dependem da configuração e da plataforma têm caixas suspensas que permitem escolher a configuração e a plataforma a que os valores atuais das configurações se aplicam.

Captura de tela mostrando as propriedades do projeto que dependem da configuração e da plataforma.

A maioria das propriedades do projeto não depende da configuração nem da plataforma, mas algumas dependem. Para uma configuração de Versão, é possível especificar que o código seja otimizado quando a solução for compilada, e para uma configuração de Depuração, é possível especificar que o símbolo de compilação condicional DEBUG seja incluído. Você também pode escolher quais avisos deseja suprimir, ou elevar a erros, de modo diferente com base na configuração ou na plataforma, bem como controlar determinadas configurações que afetam algumas opções do compilador; Estouro aritmético, Alinhamento de arquivo e a opção do compilador /deterministic.

As propriedades que você pode definir de modo diferente com base na configuração e na plataforma têm um ícone de engrenagem ao lado delas na página de configurações do projeto. Se você clicar no ícone de engrenagem, será exibido um menu que oferece opções para ter os mesmos valores, ou valores diferentes, com base na configuração, na plataforma ou em ambas.

Captura de tela mostrando as propriedades do projeto que dependem da configuração e da plataforma.

Para obter mais informações sobre as configurações da página de propriedades, consulte Gerenciar propriedades de solução e de projeto.

Criar uma configuração de projeto

Você cria uma configuração de projeto quando deseja adicionar um novo tipo de build. Por exemplo, em vez de Depuração e Versão, você pode criar configurações de Desenvolvimento, Teste e Produção.

  1. Abra a caixa de diálogo Configuration Manager.

  2. Selecione um projeto na coluna Projeto.

  3. Na lista suspensa Configuração desse projeto, escolha Novo.

    A caixa de diálogo Nova Configuração de Projeto é aberta.

  4. Na caixa Nome, insira um nome para a nova configuração.

  5. Para usar as configurações de propriedade com base em uma configuração de projeto existente, na lista suspensa Copiar configurações de, escolha uma configuração. Você pode personalizar as configurações posteriormente nas páginas de propriedades do projeto.

  6. Para criar uma configuração em toda a solução ao mesmo tempo, a marque a caixa de seleção Criar nova configuração de solução.

Renomear uma configuração de projeto

  1. Abra a caixa de diálogo Configuration Manager.

  2. Na coluna Projeto, selecione o projeto que tenha a configuração de projeto que você deseja renomear.

  3. Na lista suspensa Configuração desse projeto, escolha Editar.

    A caixa de diálogo Editar Configurações de Projeto é aberta.

  4. Selecione o nome de configuração de projeto que você deseja alterar.

  5. Selecione Renomear e, em seguida, digite um novo nome.

Criar e modificar configurações de build em toda a solução

Para compilar uma configuração de build em toda a solução

  1. Abra a caixa de diálogo Configuration Manager.

  2. Na lista suspensa Configuração da solução ativa, escolha Nova.

    A caixa de diálogo Nova configuração de solução é aberta.

  3. Na caixa de texto Nome, insira um nome para a nova configuração.

  4. Para usar as configurações de uma configuração de solução existente, na lista suspensa Copiar configurações de, escolha uma configuração.

  5. Se você desejar criar configurações de projeto ao mesmo tempo, marque a caixa de seleção Criar novas configurações de projeto.

Para renomear uma configuração de build em toda a solução

  1. Abra a caixa de diálogo Configuration Manager.

  2. Na lista suspensa Configuração da Solução Ativa, escolha Editar.

    A caixa de diálogo Editar Configurações da Solução é aberta.

  3. Selecione o nome de configuração da solução que você deseja alterar.

  4. Selecione Renomear e, em seguida, digite um novo nome.

Para modificar uma configuração de build em toda a solução

  1. Abra a caixa de diálogo Configuration Manager.

  2. Na lista suspensa Configuração da solução ativa, selecione a configuração desejada.

  3. No painel Contextos do projeto, para cada projeto, selecione a Configuração e a Plataforma desejadas e selecione se deseja Criá-la e se deseja Implantá-la.