Общие сведения о конфигурациях сборок

Конфигурации сборок требуются для создания проектов с разными параметрами. Например, отладка и выпуск — это конфигурации сборки, а при их создании используются разные параметры компилятора. Одна конфигурация является активной и отображается на панели команд в верхней части интегрированной среды разработки.

Снимок экрана: активная конфигурация на главной панели инструментов Visual Studio.

Снимок экрана: активная конфигурация на главной панели инструментов Visual Studio.

Параметры "Конфигурация" и "Платформа" позволяют определить, где будут храниться выходные файлы сборки. Как правило, когда в Visual Studio выполняется сборка проекта, выходные данные помещаются во вложенную папку проекта с именем активной конфигурации (например, bin/debug/x86). Но это можно изменить.

Вы можете создавать свои конфигурации сборки на уровне решения и проекта. Конфигурация решения определяет, какие проекты включаются в сборку, когда эта конфигурация активна. В сборку будут включены только проекты, указанные в активной конфигурации решения. Если в Configuration Manager выбрано несколько целевых платформ, будут построены все проекты, которые применяются к этой платформе. Конфигурация проекта определяет, какие параметры сборки и компилятора используются при сборке проекта.

Чтобы создать, выбрать, изменить или удалить конфигурацию, можно использовать Configuration Manager. Чтобы открыть его, выберите в строке меню Сборка>Configuration Manager или просто введите Configuration в поле поиска. Можно также использовать список Конфигурации решения на панели инструментов Стандартные, чтобы выбрать конфигурацию или открыть Configuration Manager.

Снимок экрана: диалоговое окно Configuration Manager.

Примечание.

Если вы не можете найти параметры конфигурации решения на панели инструментов и не сможете получить доступ к Configuration Manager, это может быть связано с тем, что вы используете параметры разработки Visual Basic. Дополнительные сведения см. в разделе Управление конфигурациями сборок с применением параметров разработчика Visual Basic.

По умолчанию конфигурации отладки и выпуска включаются в проекты, созданные с помощью шаблонов Visual Studio. Конфигурация Debug поддерживает отладку приложения, а конфигурация Release создает версию приложения, которое можно развернуть. Дополнительные сведения см. в пошаговом руководстве по настройке конфигураций отладки и выпусков. Можно также создать пользовательские конфигурации решений и проектов. Дополнительные сведения см. в разделе Практическое руководство. Создание и изменение конфигураций.

Конфигурации решения

Конфигурация решения указывает, как следует создавать и развертывать проекты в решении. Чтобы изменить конфигурацию решения или определить новую конфигурацию в Configuration Manager, в меню Активная конфигурация решения щелкните Изменить или Создать.

Каждая запись в поле Контексты проекта в конфигурации решений представляет проект в решении. Для каждой комбинацииАктивная конфигурация решения и Активная платформа решения можно задать способ использования каждого проекта.

При определении новой конфигурации решения и флажке "Создать конфигурации проекта" Visual Studio создает новую конфигурацию проекта во всех проектах. Аналогичным образом при определении новой платформы решения и флажке "Создать новые платформы проектов " Visual Studio создает новый параметр платформы во всех проектах. Кроме того, если добавить проект, предназначенный для новой платформы, Visual Studio добавляет эту платформу в список платформ решений и делает платформу доступной в качестве варианта во всех проектах. Параметры каждого проекта можно изменить, если платформы не нужны или поддерживаются некоторыми проектами.

Активная конфигурация решения также предоставляет контекст для IDE. Например, если вы работаете над проектом и конфигурация указывает, что он будет создан для мобильного устройства, на панели инструментов отобразятся только элементы, которые можно использовать в проекте мобильного устройства.

Конфигурации проекта

Параметры сборки и компилятора, используемых при сборке проекта определяют конфигурация и целевая платформа. В проекте могут быть разные параметры для каждой комбинации конфигурации и платформы. Чтобы изменить свойства проекта, откройте контекстное меню проекта в обозревателе решений и щелкните Свойства. В верхней части вкладки Сборка конструктора проектов выберите активную конфигурацию, чтобы изменить параметры сборки.

Снимок экрана: конфигурации конструктора проектов.

Снимок экрана: конфигурации конструктора проектов.

Как Visual Studio связывает конфигурации проектов с конфигурациями решений

При определении новой конфигурации решения и не копируйте параметры из существующего, Visual Studio использует следующие критерии, чтобы связать существующие конфигурации проекта с новой конфигурацией решения. Критерии оцениваются в следующем порядке.

  1. Если у проекта есть имя конфигурации (<<>имя> платформы конфигурации), соответствующее имени новой конфигурации решения, используется эта конфигурация. В именах конфигураций не учитывается регистр.

  2. Если у проекта есть имя конфигурации, в котором часть имени конфигурации соответствует новой конфигурации решения, используется ли эта конфигурация, совпадает ли часть платформы.

  3. Если совпадения по-прежнему нет, используется первая конфигурация, указанная в проекте.

Как Visual Studio связывает конфигурации решений с новыми конфигурациями проекта

При создании конфигурации проекта (в Configuration Manager путем выбора пункта Создать в раскрывающемся меню столбца Конфигурация для этого проекта) и установке флажка Создать новые конфигурации решений Visual Studio ищет конфигурацию решения с таким же именем, чтобы создать проект на каждой поддерживаемой платформе. В некоторых случаях Visual Studio переименовывает существующие конфигурации решения или определяет новые.

Visual Studio использует следующие критерии для связывания конфигураций решений с конфигурациями проекта:

  • Если конфигурация проекта не указывает платформу или указывает только одну платформу, будет найдена или добавлена конфигурация решения, имя которой совпадает с именем новой конфигурации проекта. Имя по умолчанию этой конфигурации решения не включает имя платформы; он принимает имя> конфигурации проекта формы<.

  • Если проект поддерживает несколько платформ, для каждой поддерживаемой платформы будет найдена или добавлена конфигурация решения. Имя каждой конфигурации решения включает имя конфигурации проекта и имя платформы, а также имя> платформы конфигурации<>проекта формы.<

Как конфигурации влияют на сборку

При построении решения с помощью команды Сборка>Собрать решение, Visual Studio выполняет сборку только активной конфигурации. Все проекты, указанные в этой конфигурации решения, будут построены, и единственной конфигурацией проекта будет только одна из них, указанная в активной конфигурации решения и активной платформе решения, которая отображается на панели инструментов в Visual Studio. Например, Отладка и x86. Другие определенные конфигурации и платформы не создаются.

Если требуется создать несколько конфигураций и платформ в одном действии, можно использовать параметр Сборка>Пакетная сборка в Visual Studio. Для получения доступа к этой функции, нажмите Ctrl+Q, чтобы открыть поле поиска, и введите Batch build. Пакетная сборка доступна не для всех типов проектов. См . инструкции. Создание нескольких конфигураций одновременно.