Compartir vía


Descripción de las configuraciones de compilación

Necesita configuraciones de compilación para compilar los proyectos con otros valores. 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 en 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 del proyecto designada con la configuración activa (por ejemplo, bin/Debug/x86), pero se puede cambiar.

Puede crear sus propias configuraciones de compilación en el nivel de solución y proyecto. La configuración de soluciones 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 el Administrador de configuración, se compilan todos los proyectos que se aplican a esa plataforma. La configuración del proyecto determina qué opciones del compilador y valores de compilación se usan al compilar el proyecto.

Para crear, seleccionar, modificar o eliminar una configuración, se puede usar el Administrador de configuración. 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 Administrador de configuración.

Nota

Si no encuentra los valores de configuración de una solución en la barra de herramientas y no puede acceder al Administrador de configuración, es posible que esté usando una configuración de desarrollo de Visual Basic. Para obtener más información, vea Cómo: Administración de configuraciones 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 se pueden crear configuraciones de soluciones personalizadas y configuraciones de proyecto. Para obtener más información, vea Cómo: crear y editar configuraciones.

Configuraciones de solución

Una configuración de soluciones especifica el modo en que se van a compilar e implementar los proyectos de la solución. Para modificar una configuración de soluciones o definir una nueva, en el Administrador de configuración, en Configuración de soluciones activas, seleccione Editar o Nueva.

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.

Cuando se define una nueva configuración de la solución y se activa la casilla Crear nuevas configuraciones de proyecto, Visual Studio crea una configuración en todos los proyectos. Del mismo modo, cuando se define una nueva plataforma de soluciones y se activa la casilla Crear nuevas plataformas de proyecto, Visual Studio crea la opción de plataforma en todos los proyectos. Además, si se agrega un proyecto destinado a una nueva plataforma, Visual Studio agrega esa plataforma a la lista de plataformas de la solución y habilita la plataforma como una 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 soluciones activas también proporciona contexto al IDE. Por ejemplo, si se está trabajando en un proyecto y la configuración especifica que se va a compilar para un dispositivo móvil, en el Cuadro de herramientas solo se muestran los elementos que se pueden usar en un proyecto de dispositivo móvil.

Configuraciones de proyectos

La configuración y la plataforma a la que se dirige un proyecto se usan conjuntamente para especificar los valores de compilación y las opciones del compilador que se utilizarán al compilar el proyecto. Un proyecto puede tener unos valores diferentes para cada combinación de configuración y plataforma. Para modificar las propiedades de un proyecto, abra el menú contextual del proyecto en el Explorador de soluciones y, luego, 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 proyectos a configuraciones de soluciones

Si se define una nueva configuración de soluciones y no se copia de una existente, Visual Studio utiliza los siguientes criterios para asociar las configuraciones de proyectos existentes con la nueva configuración de soluciones. 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 usará dicha 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 la parte del nombre de configuración coincide con la nueva configuración de soluciones, se usa esa configuración, independientemente de que la parte de plataforma coincida o no.

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

Cómo Visual Studio asocia configuraciones de soluciones a configuraciones nuevas de soluciones

Cuando se crea una configuración de proyecto (en el Administrador de configuración, al seleccionar Nuevo en el menú desplegable de la columna Configuración para ese proyecto) y se activa la casilla Crear nuevas configuraciones de solución, Visual Studio busca una configuración de soluciones con el mismo nombre para compilar el proyecto en cada una de las plataformas que se admiten. En algunos casos, Visual Studio cambia el nombre de las configuraciones de soluciones existentes o define otras nuevas.

Visual Studio utiliza los siguientes criterios para asociar configuraciones de soluciones con configuraciones de proyectos:

  • Si una configuración de proyectos no especifica ninguna plataforma o especifica solo una, se busca o se agrega una configuración de soluciones cuyo nombre coincida con el de la nueva configuración de proyecto. El nombre predeterminado de esta configuración de la solución no incluye el nombre de plataforma, sino que adopta el formato <nombre de la configuración del proyecto>.

  • Si un proyecto admite varias plataformas, se busca o se agrega una configuración de soluciones para cada plataforma admitida. El nombre de cada configuración de soluciones incluye tanto el nombre de configuración del proyecto como el nombre de la plataforma y tiene el formato <nombre de la 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 Compilar>Compilar solución, Visual Studio solo compila la configuración activa. Se compilan todos los proyectos que se especifican en la configuración de la solución y la única configuración de proyecto compilada es la que se especifica en la configuración de la solución activa y en la plataforma de la solución activa, que se muestra en la barra de herramientas de Visual Studio. Por ejemplo, Depurar y x86. No se compilan otras configuraciones y plataformas definidas.

Si desea compilar varias configuraciones y plataformas en una acción, puede usar la opción Compilar>Compilación por lotes en Visual Studio. Para obtener acceso 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 proyectos. Vea Cómo: Compilación de varias configuraciones simultáneamente.