Compartir vía


Comprender las configuraciones de compilación

Necesitas configuraciones de compilación cuando debes compilar tus proyectos con distintos ajustes. Por ejemplo, Debug y Release son configuraciones de compilación, y las opciones de compilador que se usan para crearlas son distintas. Una configuración está activa y se indica en la barra de comandos de la parte superior del IDE.

Captura de pantalla que muestra la configuración activa en la barra de herramientas principal de Visual Studio.

Captura de pantalla que muestra la configuración activa en la barra de herramientas principal de Visual Studio.

La configuración y el control de plataforma donde se almacenan los archivos de salida compilados. Normalmente, cuando Visual Studio compila el proyecto, la salida se coloca en una subcarpeta de proyecto denominada con la configuración activa (por ejemplo, bin/Debug/x86), pero puede cambiarlo.

Puede crear sus propias configuraciones de compilación en el nivel de solución y proyecto. La configuración de la solución determina qué proyectos se incluyen en la compilación cuando esa configuración está activa. Solo se compilarán los proyectos que se especifiquen en la configuración de soluciones activa. Si se seleccionan varias plataformas de destino en Configuration Manager, se compilan todos los proyectos que se aplican a esa plataforma. La configuración del proyecto determina qué opciones de compilación y de compilador se usan al compilar el proyecto.

Para crear, seleccionar, modificar o eliminar una configuración, puede usar el Configuration Manager. Para abrirlo, en la barra de menús, seleccione Compilación>, Administrador de configuración, o simplemente escriba Configuración en el cuadro de búsqueda. También se puede usar la lista Configuraciones de soluciones de la barra de herramientas Estándar para seleccionar una configuración o abrir el Administrador de configuración.

captura de pantalla del cuadro de diálogo de Configuration Manager.

Nota

Si no encuentra opciones de configuración de soluciones en la barra de herramientas y no puede acceder a la configuration Manager, puede deberse a que usa la configuración de desarrollo de Visual Basic. Para más información, vea Cómo: Administrar configuraciones de compilación a las que se han aplicado opciones del desarrollador de Visual Basic.

Las configuraciones Debug y Release están incluidas de forma predeterminada en los proyectos que se crean con las plantillas de Visual Studio. Una configuración Debug admite la depuración de una aplicación y una configuración Release compila una versión de la aplicación que se puede implementar. Para obtener más información, vea Cómo: Establecer configuraciones Debug y Release. También puede crear configuraciones de soluciones personalizadas y configuraciones de proyecto. Para obtener más información, vea Cómo: Crear y editar configuraciones.

Configuraciones de soluciones

Una configuración de solución especifica cómo se van a compilar e implementar los proyectos de la solución. Para modificar una configuración de solución o definir una nueva, en el Configuration Manager, bajo la Configuración de la Solución Activa, elija Editar o Nuevo.

Cada entrada del cuadro Contextos del proyecto de una configuración de soluciones representa un proyecto de la solución. Para cada combinación de Configuración de soluciones activas y de Plataforma de soluciones activas, se puede establecer cómo se usa cada proyecto.

Al definir una nueva configuración de solución y activar la casilla Crear nuevas configuraciones de proyecto, Visual Studio crea una nueva configuración de proyecto en todos los proyectos. Del mismo modo, al definir una nueva plataforma de solución y activar la casilla Crear nuevas plataformas de proyecto, Visual Studio crea la nueva opción de plataforma en todos los proyectos. Además, si agrega un proyecto destinado a una nueva plataforma, Visual Studio agrega esa plataforma a la lista de plataformas de soluciones y hace que la plataforma esté disponible como opción en todos los proyectos. Puede modificar la configuración de cada proyecto, en los casos en los que algunas plataformas no son necesarias o compatibles con algunos proyectos.

La configuración de la solución activa también proporciona contexto al IDE. Por ejemplo, si está trabajando en un proyecto y la configuración especifica que se compilará para un dispositivo móvil, el cuadro de herramientas de muestra solo los elementos que se pueden usar en un proyecto de dispositivo móvil.

Configuraciones de proyecto

La configuración y la plataforma que un proyecto tiene como destino se usan conjuntamente para especificar la configuración de compilación y las opciones del compilador que se van a usar cuando se compila. Un proyecto puede tener diferentes opciones de configuración para cada combinación de configuración y plataforma. Para modificar las propiedades de un proyecto, abra el menú contextual del proyecto en Explorador de solucionesy elija Propiedades. En la parte superior de la pestaña Compilación del diseñador de proyectos, elija una configuración activa para editar sus valores de compilación.

Captura de pantalla de las configuraciones del diseñador de proyectos.

Captura de pantalla de las configuraciones del diseñador de proyectos.

Cómo Visual Studio asocia configuraciones de proyecto con configuraciones de solución

Cuando se define una nueva configuración de solución y no se copian valores de uno existente, Visual Studio usa los criterios siguientes para asociar las configuraciones de proyecto existentes a la nueva configuración de la solución. Los criterios se evalúan en el orden mostrado.

  1. Si un proyecto tiene un nombre de configuración (<nombre de configuración><nombre de plataforma>) que coincide con el nombre de la nueva configuración de la solución, se usa esa configuración. En los nombres de configuraciones no se distingue entre mayúsculas y minúsculas.

  2. Si el proyecto tiene un nombre de configuración en el que el elemento configuration-name coincide con la nueva configuración de la solución, esa configuración se usa, tanto si la parte de la plataforma coincide o no.

  3. Si todavía no hay ninguna coincidencia, se usa la primera configuración que aparece en el proyecto.

Cómo Visual Studio asocia configuraciones de solución con nuevas configuraciones de proyecto

Cuando creas una configuración de proyecto (en el Configuration Manager, al elegir Nuevo en el menú desplegable de la columna Configuración para ese proyecto) y activas la casilla Crear nuevas configuraciones de solución, Visual Studio busca una configuración de solución con nombre similar para compilar el proyecto en cada plataforma que soporte. En algunos casos, Visual Studio cambia el nombre de las configuraciones de solución existentes o define las nuevas.

Visual Studio usa los siguientes criterios para asociar configuraciones de solución con configuraciones de proyecto:

  • Si una configuración de proyecto no especifica una plataforma o especifica solo una plataforma, se encuentra o agrega una configuración de solución cuyo nombre coincide con el de la nueva configuración del proyecto. El nombre predeterminado de esta configuración de solución no incluye un nombre de plataforma; toma el formato <nombre de configuración del proyecto>.

  • Si un proyecto admite varias plataformas, se encuentra o se agrega una configuración de solución para cada plataforma compatible. El nombre de cada configuración de solución incluye el nombre de configuración del proyecto y el nombre de la plataforma, y tiene el formulario <nombre de configuración del proyecto><nombre de la plataforma>.

Cómo afectan las configuraciones a la compilación

Al compilar una solución con el comando Build>Build Solution, Visual Studio solo compila la configuración activa. Todos los proyectos que se especifican en esa configuración de solución se compilan y la única configuración del proyecto compilada es la especificada en la configuración de la solución activa y la plataforma de solución activa, que se muestra en la barra de herramientas de Visual Studio. Por ejemplo, Debug y x86. No se construyen otras configuraciones y plataformas definidas.

Si quiere compilar varias configuraciones y plataformas en una acción, puede usar la opción Build>Batch Build en Visual Studio. Para acceder a esta característica, presione Ctrl+Q para abrir el cuadro de búsqueda y escriba Batch build. La compilación por lotes no está disponible para todos los tipos de proyecto. Consulte Cómo: Compilar varias configuraciones simultáneamente.