Uso compartido o reutilización de la configuración del proyecto de Visual Studio

Para crear un grupo personalizado de opciones de configuración que se puedan compartir con otros usuarios o reutilizar en varios proyectos, use el Administrador de propiedades para crear una hoja de propiedades (archivo .props) para almacenar la configuración de cada tipo de proyecto que quiera poder reutilizar o compartir con otros usuarios. El uso de hojas de propiedades es mucho menos propenso a errores que otras formas de crear una configuración "global".

Importante

El problema con los archivos *.user

En las versiones anteriores de Visual Studio se usaban hojas de propiedades globales que tenían una extensión de nombre de archivo .user y se encontraban en la carpeta \<userprofile>\AppData\Local\Microsoft\MSBuild\v4.0\. Ya no recomendamos estos archivos porque establecen propiedades para configuración de proyecto por usuario y por equipo. Estos valores "globales" pueden interferir con las compilaciones, especialmente cuando tenga como destino varias plataformas en el equipo de compilación. Por ejemplo, si tiene un proyecto MFC y un proyecto de Windows Phone, las propiedades .user no serían válidas para uno de ellos. Las hojas de propiedades reutilizables son más flexibles y más eficaces.

Aunque los archivos .user todavía se instalan con Visual Studio y participan en la herencia de propiedades, están vacíos de forma predeterminada. El procedimiento recomendado es eliminar la referencia a ellos en el Administrador de propiedades para asegurarse de que los proyectos funcionan independientemente de cualquier configuración por usuario y por equipo. Esto es importante para asegurar un comportamiento correcto en un entorno SCC (control de código fuente).

Para mostrar el Administrador de propiedades, en la barra de menús elija Ver>Administrador de propiedades o Ver>Otras ventanas>Administrador de propiedades, en función de la configuración.

Si quiere aplicar a varios proyectos un conjunto de propiedades común que usa con frecuencia, puede usar el Administrador de propiedades para capturarlas en un archivo de hoja de propiedades reutilizable, que por convención tiene una extensión de nombre de archivo .props. Puede aplicar la hoja (u hojas) a nuevos proyectos para que no tenga que establecer las propiedades desde cero.

Screenshot of the Property Manager shortcut menu.

En cada nodo de configuración, podrá ver los nodos para cada hoja de propiedades que se aplica a esa configuración. El sistema agrega hojas de propiedades que establecen valores comunes en función de las opciones que se elijan en el Asistente para aplicaciones al crear el proyecto. Haga clic con el botón derecho en cualquier nodo y seleccione Propiedades para ver las propiedades que se aplican a ese nodo. Todas las hojas de propiedades se importan de manera automática en la hoja de propiedades principal del proyecto (ms.cpp.props) y se evalúan en el orden en que aparecen en el Administrador de propiedades. Se pueden mover para cambiar el orden de evaluación. Las hojas de propiedades que se evalúan después invalidan los valores de las hojas evaluadas anteriormente. Para obtener más información sobre el orden de evaluación en el archivo .vcxproj, los archivos .props y .targets, las variables de entorno y la línea de comandos, consulte Herencia de propiedades del proyecto.

Si hace clic en Agregar nueva hoja de propiedades de proyecto y selecciona, por ejemplo, la hoja de propiedades MyProps.props, aparecerá un cuadro de diálogo de página de propiedades. Observe que se aplica a la hoja de propiedades MyProps; los cambios que realice se escriben en la hoja, no en el archivo de proyecto (.vcxproj).

Las propiedades de una hoja de propiedades se invalidan si la misma propiedad se establece directamente en el archivo .vcxproj.

Puede importar una hoja de propiedades con tanta frecuencia como sea necesaria. Varios proyectos de una solución pueden heredar valores de la misma hoja de propiedades y un proyecto puede tener varias hojas. Una hoja de propiedades en sí misma puede heredar la configuración de otra hoja de propiedades.

También puede crear una hoja de propiedades común para varias configuraciones. Para crear una hoja de propiedades para cada configuración, abra el menú contextual para una de ellas, seleccione Agregar hoja de propiedades existente y, después, agregue las demás hojas. Aun así, si usa una hoja de propiedades común, las propiedades se establecerán para todas las configuraciones a las que se aplica la hoja. El IDE no muestra qué proyectos u otras hojas de propiedades heredan de una hoja de propiedades determinada.

En soluciones grandes con muchos proyectos, puede ser útil crear una hoja de propiedades común para todos los proyectos de la solución. Cree la hoja de propiedades como de costumbre. Use el Administrador de propiedades para agregar esa hoja de propiedades a cada proyecto de la solución. Si es necesario en el nivel de proyecto, puede agregar otra hoja de propiedades para establecer valores específicos del proyecto.

Importante

Los archivos .props no participan de forma predeterminada en el control de código fuente porque no se crean como elemento del proyecto. Puede agregar manualmente el archivo como elemento de la solución si desea incluirlo en el control de código fuente.

Para crear una hoja de propiedades

  1. En la barra de menús, elija Ver>Administrador de propiedades o Ver>Otras ventanas>Administrador de propiedades. Se abrirá el Administrador de propiedades.

  2. Para definir el ámbito de la hoja de propiedades, seleccione el elemento al que se aplica. Este elemento puede ser una configuración concreta u otra hoja de propiedades. Abra el menú contextual para este elemento y después seleccione Agregar nueva hoja de propiedades de proyecto. Especifique un nombre y una ubicación.

  3. En el Administrador de propiedades, abra la hoja de propiedades nueva y después establezca las propiedades que quiera incluir.