Configuración de soluciones

Las configuraciones de solución almacenan propiedades de nivel de solución. Dirigen el comportamiento de la tecla Start (F5) y los comandos Build . De forma predeterminada, estos comandos compilan e inician la configuración de depuración. Ambos comandos se ejecutan en el contexto de una configuración de solución. Esto significa que el usuario puede esperar que F5 se inicie y compile lo que sea que la solución activa esté configurada a través de la configuración. El entorno está diseñado para optimizar soluciones en lugar de proyectos cuando se trata de compilar y ejecutar.

La barra de herramientas estándar de Visual Studio contiene un botón Inicio y una lista desplegable de configuración de la solución a la derecha del botón Inicio. Esta lista permite a los usuarios elegir la configuración que se va a iniciar cuando se presiona F5, crear sus propias configuraciones de solución o editar una configuración existente.

Nota:

No hay interfaces de extensibilidad para crear o editar las configuraciones de la solución. Debe usar DTE.SolutionBuild. Sin embargo, hay API de extensibilidad para administrar la compilación de la solución. Para obtener más información, vea IVsSolutionBuildManager2.

Aquí se muestra cómo puede implementar las configuraciones de solución compatibles con el tipo de proyecto:

  • Proyecto

    Muestra los nombres de los proyectos que se encuentran en la solución actual.

  • Configuración

    Para proporcionar la lista de configuraciones admitidas por el tipo de proyecto y que se muestran en las páginas de propiedades, implemente IVsCfgProvider2.

    La columna Configuración muestra el nombre de la configuración del proyecto que se va a compilar en esta configuración de solución y enumera todas las configuraciones del proyecto al hacer clic en el botón de flecha. El entorno llama al GetCfgNames método para rellenar esta lista. Si el GetCfgProviderProperty método indica que el proyecto admite la edición de configuración, las selecciones New o Edit también se muestran en el encabezado Configuración. Cada una de estas selecciones inicia cuadros de diálogo que llaman a métodos de la IVsCfgProvider2 interfaz para editar las configuraciones del proyecto.

    Si un proyecto no admite configuraciones, la columna Configuración muestra Ninguno y está deshabilitado.

  • Plataforma

    Muestra la plataforma para la que se compila la configuración del proyecto seleccionada y enumera todas las plataformas disponibles para el proyecto al hacer clic en el botón de flecha. El entorno llama al GetPlatformNames método para rellenar esta lista. Si el GetCfgProviderProperty método indica que el proyecto admite la edición de la plataforma, las selecciones New o Edit también se muestran en el encabezado Plataforma. Cada una de estas selecciones inicia cuadros de diálogo que llaman a IVsCfgProvider2 métodos para editar las plataformas disponibles del proyecto.

    Si un proyecto no admite plataformas, la columna de plataforma de ese proyecto muestra None y está deshabilitada.

  • Build

    Especifica si la configuración de la solución actual crea o no el proyecto. Los proyectos no seleccionados no se compilan cuando se invocan los comandos de compilación de nivel de solución a pesar de las dependencias del proyecto que contienen. Los proyectos no seleccionados para compilar se siguen incluyendo en la depuración, la ejecución, el empaquetado y la implementación de la solución.

  • Implementar

    Especifica si el proyecto se implementará o no cuando se usen los comandos Iniciar o Implementar con la configuración de compilación de la solución seleccionada. La casilla de este campo estará disponible si el proyecto admite la implementación mediante la implementación de la IVsDeployableProjectCfg interfaz en su IVsProjectCfg2 objeto .

    Una vez agregada una nueva configuración de solución, el usuario puede seleccionarla en el cuadro de lista desplegable Configuración de la solución de la barra de herramientas estándar para compilar o iniciar esa configuración.