Partilhar via


Como: Integrar ferramentas personalizadas nas propriedades do projeto

Você pode adicionar opções de ferramenta 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 de uma ferramenta ou de um grupo de recursos. Por exemplo, a regra Linker contém as configurações para a ferramenta de vinculação. As configurações em uma regra podem ser subdivididas em categorias.

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

A pasta na 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 regras é %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>. O <version> valor é v140 no Visual Studio 2015. O <locale> é um LCID, por exemplo, 1033 para o inglês. Você usará um caminho diferente para cada edição do Visual Studio instalada e para cada idioma. Por exemplo, o caminho da pasta de regras padrão para o Visual Studio 2015 Community edition em inglês pode ser C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\v140\1033\.

A pasta na 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 o inglês. Num prompt de comando de desenvolvedor do Visual Studio 2015 ou anterior, a pasta de regras é %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>\, onde o valor <version> é v140 no Visual Studio 2015. Você usará um caminho diferente para cada edição do Visual Studio instalada e para cada idioma. Por exemplo, o caminho da pasta de regras padrão para o Visual Studio 2017 Community edition em inglês pode ser C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\VC\VCTargets\1033\.

A pasta na 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>\, onde o valor <version> está v160 no Visual Studio 2019. O <locale> é um LCID, por exemplo, 1033 para o 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 regras é %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>\. Você usará um caminho diferente para cada edição do Visual Studio instalada e para cada idioma. Por exemplo, o caminho da pasta de regras padrão para o Visual Studio 2019 Community edition em inglês pode ser C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Microsoft\VC\v160\1033\.

Para adicionar ou alterar as propriedades do projeto

  1. No editor XML, crie um arquivo XML.

  2. Salve o arquivo na pasta de regras padrão. Ajuste o caminho para seu idioma e edição do Visual Studio. Cada regra na janela Páginas de propriedades é representada por um arquivo XML nesta pasta. Certifique-se de que o ficheiro tem um nome exclusivo na pasta.

  3. Copie o conteúdo de um arquivo de regras existente, como rc.xml, feche-o sem salvar as alterações e 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. Certifique-se de alterar o Nome da Regra e Rule.DisplayName na parte superior do arquivo.

  5. Salve as 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, confirme a existência de um novo nó com o nome da sua regra.

Ver também

MSBuild na linha de comando - C++