Herencia de propiedades en proyectos de Visual Studio

El sistema de proyectos nativos de Visual Studio se basa en MSBuild. MSBuild define los formatos de archivo y las reglas para compilar proyectos de cualquier tipo. Administra la mayor parte de la complejidad de la creación de varias configuraciones y plataformas. Le resultará útil entender cómo funciona. Esto es especialmente importante si quiere definir configuraciones personalizadas. O bien, si quiere crear conjuntos de propiedades reutilizables que se pueden compartir e importar en varios proyectos.

El archivo .vcxproj, archivos .props y .targets

Las propiedades del proyecto se almacenan en varios archivos. Algunas se almacenan directamente en el archivo del proyecto .vcxproj. Otras provienen de otros archivos .targets o .props que importa el archivo del proyecto y que proporcionan valores predeterminados. Los archivos del proyecto de Visual Studio se encuentran en una carpeta específica de la configuración regional del directorio base, %VSINSTALLDIR%\MSBuild\Microsoft\VC\<version>. <version> es específico de la versión de Visual Studio. Es v160 en el caso de Visual Studio 2019.

Las propiedades también se almacenan en los archivos .props personalizados que es posible que se agreguen a un proyecto propio. Se recomienda encarecidamente NO editar esos archivos de forma manual, sino usar las páginas de propiedades del IDE para modificar todas las propiedades, en especial las que participan en la herencia, a menos que se tenga un gran conocimiento de los archivos .vcxproj y de MSBuild.

Como se ha mostrado antes, se puede asignar otro valor a la misma propiedad para la misma configuración en estos archivos diferentes. Cuando se compila un proyecto, el motor de MSBuild evalúa el archivo del proyecto y todos los archivos importados en un orden bien definido que se explica más adelante. Al evaluar cada archivo, los valores de propiedad definidos en ese archivo invalidarán los valores existentes. Los valores que no se especifiquen se heredan de los archivos que se evaluaron anteriormente. Cuando se establece una propiedad con páginas de propiedades, también es importante prestar atención a dónde se establece. Si se establece una propiedad en "X" en un archivo .props, pero se establece en "Y" en el archivo de proyecto, el proyecto se compilará con la propiedad establecida en "Y". Si la misma propiedad se establece en "Z" en un elemento de proyecto, como un archivo .cpp, el motor de MSBuild usará el valor de "Z".

Este es el árbol básico de herencia:

1. Configuración predeterminada del conjunto de herramientas del archivo CPP de MSBuild (el archivo Microsoft.Cpp.Default.props del directorio base, que se importa mediante el archivo .vcxproj).

2. Hojas de propiedades

3. Archivo .vcxproj . (Este archivo puede invalidar la configuración predeterminada y de la hoja de propiedades).

4. Metadatos de elemento

Sugerencia

En una página de propiedades, una propiedad en negrita se define en el contexto actual. Se hereda una propiedad en fuente normal.

Visualización de un archivo de proyecto expandido con todos los valores importados

En ocasiones, es útil ver el archivo expandido para determinar cómo se hereda un valor de propiedad especificado. Para ver la versión ampliada, escriba el siguiente comando en un símbolo del sistema de Visual Studio. (Cambie los nombres de archivo de marcador de posición a los que desea usar).

msbuild /pp:temp.txt myapp.vcxproj

Los archivos de proyecto expandidos pueden ser de gran tamaño y difíciles de comprender a menos que esté familiarizado con MSBuild. A continuación se muestra la estructura básica de un archivo de proyecto:

1. Propiedades fundamentales del proyecto que no se exponen en el IDE.

2. Importación de Microsoft.cpp.default.props, que define algunas propiedades básicas independientes del conjunto de herramientas.

3. Página de propiedades de configuración global (expuestas como PlatformToolset y propiedades predeterminadas de Proyecto en la página Configuración general. Estas propiedades determinan qué conjunto de herramientas y hojas de propiedades intrínsecas se importan en Microsoft.cpp.props en el paso siguiente.

4. Importación de Microsoft.cpp.props, que establece la mayoría de los valores predeterminados del proyecto.

5. Importación de todas las hojas de propiedades, incluidos los archivos .user. Estas hojas de propiedades pueden reemplazar todo excepto las propiedades predeterminadas PlatformToolset y Project.

6. El resto de propiedades de configuración del proyecto. Estos valores pueden invalidar lo que estaba establecido en las hojas de propiedades.

7. Elementos (archivos), junto con sus metadatos. Estos elementos son siempre la última palabra en las reglas de evaluación de MSBuild, aunque se produzcan antes de otras propiedades e importaciones.

Para obtener más información, consulte Propiedades de MSBuild.

Configuraciones de compilación

Una configuración es solo un grupo arbitrario de propiedades a las que se asigna un nombre. Visual Studio proporciona configuraciones de depuración y versión. Cada una determina varias propiedades de forma adecuada para una compilación de depuración o una compilación de versión. Puede usar el Administrador de configuración para configurar estas propiedades. Son una manera cómoda de agrupar las propiedades de un tipo específico de compilación.

Para obtener más información sobre las configuraciones de compilación, abra el Administrador de propiedades. Para abrirlo, seleccione Ver > Administrador de propiedades o Ver > Otras ventanas > Administrador de propiedades, según la configuración. El Administrador de propiedades tiene nodos para cada par de configuración y plataforma del proyecto. En cada uno de estos nodos hay otros nodos para las hojas de propiedades (los archivos .props) que establecen algunas propiedades específicas para esa configuración.

Por ejemplo, puede ir al panel General en las páginas de propiedades. Cambie la propiedad Juego de caracteres a "Sin establecer" en lugar de "Usar Unicode" y, a continuación, haga clic en Aceptar. El Administrador de propiedades ahora ya no muestra la hoja de propiedades Compatibilidad con Unicode. Se quita para la configuración actual, pero todavía existe para otras configuraciones.

Para más información sobre el Administrador de propiedades y las hojas de propiedades, vea Compartir o volver a usar la configuración del proyecto de Visual Studio - C++.

Sugerencia

El archivo .user es una característica heredada. Se recomienda eliminarlo para conservar las propiedades agrupadas de forma correcta según la configuración y la plataforma.