Compartilhamento ou reutilização das configurações de projeto do Visual Studio

Para criar um grupo personalizado de configurações que você pode compartilhar com outras pessoas ou reutilizar em vários projetos, use o Gerenciador de Propriedades para criar uma folha de propriedades (um arquivo .props) para armazenar as configurações para cada tipo de projeto que você deseja poder reutilizar ou compartilhar com outras pessoas. O uso de folhas de propriedades é muito menos propenso a erros do que outras maneiras de criar configurações “globais”.

Importante

O problema com *.user arquivos

As versões anteriores do Visual Studio usavam folhas de propriedades globais que tinham uma extensão de nome de arquivo .user e estavam localizadas na pasta \<userprofile>\AppData\Local\Microsoft\MSBuild\v4.0\. Não recomendamos mais esses arquivos, pois definem propriedades para configurações do projeto com base no computador e no usuário. Essas configurações “globais” podem interferir com as compilações, especialmente quando você está definindo mais de uma plataforma no computador de compilação. Por exemplo, se você tiver um projeto do MFC e um projeto do Windows Phone, as propriedades .user serão inválidas para um deles. Folhas de propriedade reutilizáveis são mais flexíveis e mais robustas.

Embora os arquivos .user ainda sejam instalados pelo Visual Studio e participem da herança de propriedade, eles são vazios por padrão. A melhor prática é excluir a referência a eles no Gerenciador de Propriedades para garantir que os projetos operem independentemente de qualquer configuração por usuário e por computador. Essa prática é importante para garantir o comportamento correto em um ambiente SCC (controle do código-fonte).

Para exibir o Gerenciador de Propriedades, na barra de menus, escolha Exibir>Gerenciador de Propriedades ou Exibir>Outro Gerenciadorde>Propriedades do Windows, dependendo de suas configurações.

Se você deseja aplicar um conjunto de propriedades comum e usado com frequência a vários projetos, use o Gerenciador de Propriedades para capturá-las em um arquivo de folha de propriedades reutilizável, que por convenção tem uma extensão de nome de arquivo .props. Você pode aplicar a folha (ou folhas) a novos projetos para não precisar definir suas propriedades a partir do zero.

Em cada nó de configuração, você verá os nós de cada folha de propriedades que se aplica a essa configuração. O sistema adiciona folhas de propriedades que definem valores comuns com base nas opções escolhidas no assistente de aplicativo no momento da criação do projeto. Clique com o botão direito do mouse em qualquer nó e escolha Propriedades para ver as propriedades que se aplicam a esse nó. Todas as folhas de propriedades são importadas automaticamente para a folha de propriedades primária do projeto (ms.cpp.props) e são avaliadas na ordem em que são exibidas no Gerenciador de Propriedades. Mova-as para alterar a ordem de avaliação. As folhas de propriedades que são avaliadas posteriormente substituem os valores nas planilhas avaliadas anteriormente. Para obter mais informações sobre a ordem de avaliação no arquivo .vcxproj, os arquivos .propse .targets, as variáveis de ambiente e a linha de comando, consulte a Herança de propriedade do projeto.

Se você escolher Adicionar Nova Folha de Propriedades do Projeto e, em seguida, selecionar, por exemplo, a folha de propriedades MyProps.props, uma caixa de diálogo da página de propriedades será aberta. Observe que isso se aplica à folha de propriedades MyProps; as alterações feitas são gravadas na folha, não no arquivo de projeto (.vcxproj).

As propriedades em uma folha de propriedades são substituídas se a mesma propriedade for definida diretamente no arquivo .vcxproj.

Você pode importar uma folha de propriedades quantas vezes for necessário. Vários projetos em uma solução podem herdar configurações da mesma folha de propriedades, e um projeto pode ter várias folhas. Uma folha de propriedades em si pode herdar configurações de outra folha de propriedades.

Você também pode criar uma folha de propriedades comum para várias configurações. Para criar uma folha de propriedades para cada configuração, abra o menu de atalho de uma delas, escolha Adicionar Folha de Propriedades Existente e, em seguida, adicione as outras folhas. No entanto, se você usar uma folha de propriedades comum, as propriedades definidas para todas as configurações às quais a planilha se aplica. O IDE não mostra quais projetos ou outras folhas de propriedades herdam de uma determinada folha de propriedades.

Em grandes soluções que têm muitos projetos, pode ser útil criar uma folha de propriedades comum para todos os projetos na solução. Crie a folha de propriedades como de costume. Use o Gerenciador de Propriedades para adicionar essa folha de propriedades a cada projeto na solução. Se for necessário no nível do projeto, você pode adicionar uma outra folha de propriedades para definir valores específicos do projeto.

Importante

Um arquivo .props por padrão não participa no controle de código-fonte porque não é criado como um item de projeto. Você pode adicionar manualmente o arquivo como um item de solução se quiser incluí-lo no controle de código-fonte.

Para criar uma folha de propriedades

1. Na barra de menus, escolha Exibir>Gerenciador de Propriedades ou Exibir>Outro Gerenciador de>Propriedades do Windows. O Gerenciador de Propriedades será aberto.

2. Para definir o escopo da folha de propriedades, selecione o item ao qual se aplica. Este item pode ser uma configuração específica ou outra folha de propriedades. Abra o menu de atalho desse item e, em seguida, escolha Adicionar Nova Folha de Propriedades do Projeto. Especifique um nome e um local.

3. No Gerenciador de Propriedades, abra a nova folha de propriedades e, em seguida, defina as propriedades que deseja incluir.