Opis konfiguracji kompilacji

Konfiguracje kompilacji są potrzebne w przypadku konieczności kompilowania projektów przy użyciu różnych ustawień. Na przykład debugowanie i wydawanie to konfiguracje kompilacji, a podczas kompilowania używane są różne opcje kompilatora. Jedna konfiguracja jest aktywna i jest wskazana na pasku poleceń w górnej części środowiska IDE.

Screenshot showing the active configuration in the main Visual Studio toolbar.

Screenshot showing the active configuration in the main Visual Studio toolbar.

Uwaga

Ten temat dotyczy programu Visual Studio w systemie Windows. Aby uzyskać Visual Studio dla komputerów Mac, zobacz Kompilowanie konfiguracji w Visual Studio dla komputerów Mac.

Konfiguracja i kontrolka platformy, w której są przechowywane skompilowane pliki wyjściowe. Zwykle, gdy program Visual Studio kompiluje projekt, dane wyjściowe są umieszczane w podfolderze projektu o nazwie z aktywną konfiguracją (na przykład bin/Debug/x86), ale można to zmienić.

Konfiguracje kompilacji można tworzyć na poziomie rozwiązania i projektu. Konfiguracja rozwiązania określa, które projekty są zawarte w kompilacji, gdy ta konfiguracja jest aktywna. Zostaną skompilowane tylko projekty określone w aktywnej konfiguracji rozwiązania. Jeśli w programie Configuration Manager wybrano wiele platform docelowych, tworzone są wszystkie projekty, które mają zastosowanie do tej platformy. Konfiguracja projektu określa, jakie ustawienia kompilacji i opcje kompilatora są używane podczas kompilowania projektu.

Aby utworzyć, wybrać, zmodyfikować lub usunąć konfigurację, możesz użyć programu Configuration Manager. Aby go otworzyć, na pasku menu wybierz pozycję Build Configuration Manager (Kompiluj>program Configuration Manager) lub wpisz polecenie Configuration (Konfiguracja ) w polu wyszukiwania. Możesz również użyć listy Konfiguracje rozwiązań na pasku narzędzi w warstwie Standardowa, aby wybrać konfigurację lub otworzyć program Configuration Manager.

Screenshot of Configuration Manager dialog.

Uwaga

Jeśli nie możesz znaleźć ustawień konfiguracji rozwiązania na pasku narzędzi i nie możesz uzyskać dostępu do programu Configuration Manager, może to być spowodowane używaniem ustawień programowania w języku Visual Basic. Aby uzyskać więcej informacji, zobacz How to: Manage configurations with Visual Basic developer settings applied (Jak zarządzać konfiguracjami za pomocą zastosowanych ustawień dewelopera języka Visual Basic).

Domyślnie konfiguracje debugowania i wydania są uwzględniane w projektach tworzonych przy użyciu szablonów programu Visual Studio. Konfiguracja debugowania obsługuje debugowanie aplikacji, a konfiguracja wydania tworzy wersję aplikacji, którą można wdrożyć. Aby uzyskać więcej informacji, zobacz How to: Set debug and release configurations (Instrukcje: ustawianie konfiguracji debugowania i wydawania). Można również tworzyć niestandardowe konfiguracje rozwiązań i konfiguracje projektów. Aby uzyskać więcej informacji, zobacz How to: Create and edit configurations (Instrukcje: tworzenie i edytowanie konfiguracji).

Konfiguracje rozwiązań

Konfiguracja rozwiązania określa sposób kompilowania i wdrażania projektów w rozwiązaniu. Aby zmodyfikować konfigurację rozwiązania lub zdefiniować nową, w programie Configuration Manager w obszarze Konfiguracja aktywnego rozwiązania wybierz pozycję Edytuj lub Nowy.

Każdy wpis w polu Konteksty projektu w konfiguracji rozwiązania reprezentuje projekt w rozwiązaniu. Dla każdej kombinacji konfiguracji aktywnego rozwiązania i aktywnej platformy rozwiązania można ustawić sposób użycia każdego projektu.

Po zdefiniowaniu nowej konfiguracji rozwiązania i wybraniu pola wyboru Utwórz nowe konfiguracje projektu program Visual Studio tworzy nową konfigurację projektu we wszystkich projektach. Podobnie po zdefiniowaniu nowej platformy rozwiązania i wybraniu pola wyboru Utwórz nowe platformy projektów program Visual Studio tworzy nową opcję platformy we wszystkich projektach. Ponadto jeśli dodasz projekt przeznaczony dla nowej platformy, program Visual Studio doda tę platformę do listy platform rozwiązań i udostępni platformę jako opcję we wszystkich projektach. Możesz zmodyfikować ustawienia dla każdego projektu, w przypadkach, gdy platformy nie są potrzebne lub obsługiwane przez niektóre projekty.

Aktywna konfiguracja rozwiązania zapewnia również kontekst środowiska IDE. Jeśli na przykład pracujesz nad projektem, a konfiguracja określa, że zostanie utworzona dla urządzenia przenośnego, przybornik wyświetla tylko elementy, które mogą być używane w projekcie urządzenia przenośnego.

Konfiguracje projektu

Konfiguracja i platforma docelowa projektu są używane razem do określania ustawień kompilacji i opcji kompilatora do użycia podczas kompilowania. Projekt może mieć różne ustawienia dla każdej kombinacji konfiguracji i platformy. Aby zmodyfikować właściwości projektu, otwórz menu skrótów dla projektu w Eksplorator rozwiązań, a następnie wybierz pozycję Właściwości. W górnej części karty Kompilacja projektanta projektu wybierz aktywną konfigurację, aby edytować ustawienia kompilacji.

Screenshot of project designer configurations.

Screenshot of project designer configurations.

Jak program Visual Studio kojarzy konfiguracje projektu z konfiguracjami rozwiązań

Podczas definiowania nowej konfiguracji rozwiązania i nie kopiowania ustawień z istniejącego programu Visual Studio używa następujących kryteriów do skojarzenia istniejących konfiguracji projektu z nową konfiguracją rozwiązania. Kryteria są oceniane w podanej kolejności.

  1. Jeśli projekt ma nazwę konfiguracji (<nazwę> platformy nazwy><konfiguracji), która jest zgodna z nazwą nowej konfiguracji rozwiązania, ta konfiguracja jest używana. Nazwy konfiguracji nie są uwzględniane w wielkości liter.

  2. Jeśli projekt ma nazwę konfiguracji, w której część nazwa-konfiguracji jest zgodna z nową konfiguracją rozwiązania, ta konfiguracja jest używana, niezależnie od tego, czy część platformy jest zgodna, czy nie.

  3. Jeśli nadal nie ma dopasowania, zostanie użyta pierwsza konfiguracja wymieniona w projekcie.

Jak program Visual Studio kojarzy konfiguracje rozwiązań z nowymi konfiguracjami projektu

Podczas tworzenia konfiguracji projektu (w programie Configuration Manager, wybierając pozycję Nowy w menu rozwijanym w kolumnie Konfiguracja dla tego projektu) i zaznacz pole wyboru Utwórz nowe konfiguracje rozwiązań, program Visual Studio szuka konfiguracji rozwiązania o podobnej nazwie, aby skompilować projekt na każdej obsługiwanej platformie. W niektórych przypadkach program Visual Studio zmienia nazwę istniejących konfiguracji rozwiązań lub definiuje nowe.

Program Visual Studio używa następujących kryteriów do kojarzenia konfiguracji rozwiązań z konfiguracjami projektu:

  • Jeśli konfiguracja projektu nie określa platformy lub określa tylko jedną platformę, konfiguracja rozwiązania, którego nazwa jest zgodna z konfiguracją nowego projektu, zostanie znaleziona lub dodana. Domyślna nazwa tej konfiguracji rozwiązania nie zawiera nazwy platformy; przyjmuje nazwę> konfiguracji projektu formularza<.

  • Jeśli projekt obsługuje wiele platform, konfiguracja rozwiązania zostanie znaleziona lub dodana dla każdej obsługiwanej platformy. Nazwa każdej konfiguracji rozwiązania zawiera zarówno nazwę konfiguracji projektu, jak i nazwę platformy oraz nazwę platformy> konfiguracji<>projektu formularza<.

Jak konfiguracje wpływają na kompilację

Podczas kompilowanie rozwiązania przy użyciu polecenia Kompiluj > rozwiązanie program Visual Studio kompiluje tylko aktywną konfigurację. Wszystkie projekty określone w tej konfiguracji rozwiązania są kompilowane, a jedyną utworzoną konfiguracją projektu jest to, że jeden określony w aktywnej konfiguracji rozwiązania i aktywnej platformie rozwiązania, która jest wyświetlana na pasku narzędzi w programie Visual Studio. Na przykład Debugowanie i x86. Inne zdefiniowane konfiguracje i platformy nie są kompilowane.

Jeśli chcesz utworzyć wiele konfiguracji i platform w jednej akcji, możesz użyć opcji Kompilacja> usługi Batch w programie Visual Studio. Aby uzyskać dostęp do tej funkcji, naciśnij klawisze Ctrl+Q, aby otworzyć pole wyszukiwania, a następnie wprowadź .Batch build Kompilacja usługi Batch nie jest dostępna dla wszystkich typów projektów. Zobacz Instrukcje: kompilowanie wielu konfiguracji jednocześnie.