Cómo: Integrar herramientas personalizadas en las propiedades del proyecto

Puede agregar opciones de herramientas personalizadas a la ventana Páginas de propiedades de Visual Studio mediante la creación de un archivo XML.

La sección Propiedades de configuración de la ventana Páginas de propiedades muestra grupos de opciones que se conocen como reglas. Cada regla contiene la configuración de una herramienta o un grupo de características. Por ejemplo, la regla Enlazador contiene la configuración de la herramienta del enlazador. La configuración de una regla se puede subdividir en categorías.

Puede crear un archivo de reglas que contenga propiedades de la herramienta personalizada para que las propiedades se carguen cuando se inicie Visual Studio. Para obtener más información sobre cómo modificar el archivo, vea Extensibilidad de la plataforma, parte 2 en el blog del equipo de proyecto de Visual Studio.

La carpeta en la que se va a colocar el archivo de reglas depende de la configuración regional y de la versión de Visual Studio en uso. En un símbolo del sistema para desarrolladores de Visual Studio 2015 o anterior, la carpeta de reglas es %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>. El valor <version> es v140 en Visual Studio 2015. <locale> es un LCID, por ejemplo, 1033 para inglés. Se usa una ruta de acceso diferente para cada edición de Visual Studio instalada, y para cada idioma. Por ejemplo, la ruta predeterminada de la carpeta de reglas de Visual Studio 2015 edición Community en inglés podría ser C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\v140\1033\.

La carpeta en la que se va a colocar el archivo de reglas depende de la configuración regional y de la versión de Visual Studio en uso. En un símbolo del sistema para desarrolladores de Visual Studio 2017, la carpeta de reglas es %VSINSTALLDIR%Common7\IDE\VC\VCTargets\<locale>\. <locale> es un LCID, por ejemplo, 1033 para inglés. En un símbolo del sistema para desarrolladores de Visual Studio 2015 o anterior, la carpeta de reglas es %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>\, donde el valor <version> es v140 en Visual Studio 2015. Se usa una ruta de acceso diferente para cada edición de Visual Studio instalada, y para cada idioma. Por ejemplo, la ruta predeterminada de la carpeta de reglas de Visual Studio 2017 edición Community en inglés podría ser C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\VC\VCTargets\1033\.

La carpeta en la que se va a colocar el archivo de reglas depende de la configuración regional y de la versión de Visual Studio en uso. En un símbolo del sistema para desarrolladores de Visual Studio 2019 o posterior, la carpeta de reglas es %VSINSTALLDIR%MSBuild\Microsoft\VC\<version>\<locale>\, donde el valor <version> es v160 en Visual Studio 2019. <locale> es un LCID, por ejemplo, 1033 para inglés. En Visual Studio 2017, la carpeta de reglas es %VSINSTALLDIR%Common7\IDE\VC\VCTargets\<locale>\. En un símbolo del sistema para desarrolladores de Visual Studio 2015 o anterior, la carpeta de reglas es %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\<locale>\. Se usa una ruta de acceso diferente para cada edición de Visual Studio instalada, y para cada idioma. Por ejemplo, la ruta predeterminada de la carpeta de reglas de Visual Studio 2019 edición Community en inglés podría ser C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Microsoft\VC\v160\1033\.

Para agregar o cambiar las propiedades del proyecto

  1. En el editor XML, cree un archivo XML.

  2. Guarde el archivo en la carpeta de reglas predeterminada. Ajuste la ruta de acceso para el idioma y la edición de Visual Studio. Cada regla de la página Páginas de propiedades se representa mediante un archivo XML en esta carpeta. Asegúrese de que el archivo tiene un nombre único en la carpeta.

  3. Copie el contenido de un archivo de reglas existente, como rc.xml, ciérrelo sin guardar los cambios y luego pegue el contenido en el nuevo archivo XML. Puede copiar cualquier archivo de esquema XML para usarlo como plantilla. Elija uno que sea similar a la herramienta.

  4. En el nuevo archivo XML, modifique el contenido según sus requisitos. No olvide cambiar los valores de Nombre de la regla y Rule.DisplayName en la parte superior del archivo.

  5. Guarde los cambios y cierre el archivo.

  6. Los archivos XML de la carpeta de reglas se cargan cuando se inicia Visual Studio. Para probar el nuevo archivo, reinicie Visual Studio.

  7. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Propiedades. En la ventana Páginas de propiedades, compruebe que hay un nuevo nodo con el nombre de la regla.

Consulte también

MSBuild en la línea de comandos - C++