Compartilhar via


Como integrar ferramentas personalizadas a propriedades de projeto

Adicione opções de ferramentas personalizadas à janela Páginas de Propriedades do Visual Studio criando um arquivo XML.

A seção Propriedades de Configuração da janela Páginas de Propriedades exibe grupos de configurações conhecidos como regras. Cada regra contém as configurações para uma ferramenta ou um grupo de funcionalidades. Por exemplo, a regra Vinculador contém as configurações para a ferramenta do vinculador. As configurações em uma regra podem ser subdivididas em categorias.

Você pode criar um arquivo de regra que contém propriedades para a ferramenta personalizada, de modo que as propriedades sejam carregadas quando o Visual Studio for iniciado. Para obter informações sobre como modificar o arquivo, confira Extensibilidade da plataforma parte 2 no blog da equipe de projeto do Visual Studio.

A pasta para qual colocar o arquivo de regra depende da localidade e da versão do Visual Studio em uso. Em um prompt de comando do desenvolvedor do Visual Studio 2015 ou anterior, a pasta de regra é %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>. O valor <version> é v140 no Visual Studio 2015. O <locale> é um LCID; por exemplo, 1033 para inglês. Você usará um caminho diferente para cada linguagem e edição instalada do Visual Studio. Por exemplo, o caminho da pasta de regras padrão no Visual Studio 2015 Community Edition em inglês poderia ser C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\v140\1033\.

A pasta para qual colocar o arquivo de regra depende da localidade e da versão do Visual Studio em uso. Em um prompt de comando do desenvolvedor do Visual Studio 2017, a pasta de regras é %VSINSTALLDIR%Common7\IDE\VC\VCTargets\<locale>\. O <locale> é um LCID; por exemplo, 1033 para inglês. Em um prompt de comando do desenvolvedor do Visual Studio 2015 ou anterior, a pasta de regras é %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>\, em que o valor <version> é v140 no Visual Studio 2015. Você usará um caminho diferente para cada linguagem e edição instalada do Visual Studio. Por exemplo, o caminho da pasta padrão de regras no Visual Studio 2017 Community Edition em inglês poderia ser C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\VC\VCTargets\1033\.

A pasta para qual colocar o arquivo de regra depende da localidade e da versão do Visual Studio em uso. Em um prompt de comando do desenvolvedor do Visual Studio 2019 ou posterior, a pasta de regras é %VSINSTALLDIR%MSBuild\Microsoft\VC\<version>\<locale>\, em que o valor <version> é v160 no Visual Studio 2019. O <locale> é um LCID; por exemplo, 1033 para inglês. No Visual Studio 2017, a pasta de regras é %VSINSTALLDIR%Common7\IDE\VC\VCTargets\<locale>\. Em um prompt de comando do desenvolvedor do Visual Studio 2015 ou anterior, a pasta de regra é %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>\. Você usará um caminho diferente para cada linguagem e edição instalada do Visual Studio. Por exemplo, o caminho da pasta de regras padrão no Visual Studio 2019 Community Edition em inglês poderia ser C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Microsoft\VC\v160\1033\.

Para adicionar ou alterar as propriedades de projeto

  1. No editor de XML, crie um arquivo XML.

  2. Salve o arquivo na pasta de regras padrão. Ajuste o caminho de acordo com a linguagem e a edição do Visual Studio. Cada regra na janela Páginas de Propriedades é representada por um arquivo XML nessa pasta. Verifique se o arquivo está exclusivamente nomeado na pasta.

  3. Copie o conteúdo de um arquivo de regras existente, como o rc.xml, feche-o sem salvar as alterações e, em seguida, cole o conteúdo no novo arquivo XML. Você pode copiar qualquer arquivo de esquema XML para usar como modelo. Escolha um que seja semelhante à sua ferramenta.

  4. No novo arquivo XML, modifique o conteúdo de acordo com suas necessidades. Lembre-se de alterar o Nome da Regra e Rule.DisplayName na parte superior do arquivo.

  5. Salve suas alterações e feche o arquivo.

  6. Os arquivos XML na pasta de regras são carregados quando o Visual Studio é iniciado. Para testar o novo arquivo, reinicie o Visual Studio.

  7. No Gerenciador de Soluções, clique com o botão direito do mouse em um projeto e escolha Propriedades. Na janela Páginas de Propriedades, verifique se há um novo nó com o nome da regra.

Confira também

MSBuild na linha de comando – C++