Konfiguracja rozwiązania
Konfiguracje rozwiązań przechowują właściwości na poziomie rozwiązania. Kierują zachowanie klawisza Start (F5) i poleceń kompilacji . Domyślnie te polecenia kompilują i uruchamiają konfigurację debugowania. Oba polecenia są wykonywane w kontekście konfiguracji rozwiązania. Oznacza to, że użytkownik może spodziewać się uruchomienia i skompilowania dowolnego aktywnego rozwiązania za pomocą ustawień. Środowisko jest przeznaczone do optymalizacji pod kątem rozwiązań, a nie projektów, jeśli chodzi o kompilowanie i uruchamianie.
Standardowy pasek narzędzi programu Visual Studio zawiera przycisk Start i listę rozwijaną konfiguracji rozwiązania po prawej stronie przycisku Uruchom. Ta lista umożliwia użytkownikom wybranie konfiguracji, która ma zostać uruchomiona po naciśnięciu klawisza F5, utworzeniu własnych konfiguracji rozwiązań lub edytowaniu istniejącej konfiguracji.
Uwaga
Nie ma interfejsów rozszerzalności do tworzenia ani edytowania konfiguracji rozwiązania. Należy użyć polecenia DTE.SolutionBuild
. Istnieją jednak interfejsy API rozszerzalności do zarządzania kompilacją rozwiązania. W celu uzyskania więcej informacji, zobacz następujący temat: IVsSolutionBuildManager2.
Poniżej przedstawiono sposób implementowania konfiguracji rozwiązań obsługiwanych przez typ projektu:
Projekt
Wyświetla nazwy projektów znalezionych w bieżącym rozwiązaniu.
Konfigurowanie
Aby podać listę konfiguracji obsługiwanych przez typ projektu i wyświetlanych na stronach właściwości, zaimplementuj element IVsCfgProvider2.
W kolumnie Konfiguracja wyświetlana jest nazwa konfiguracji projektu do skompilowania w tej konfiguracji rozwiązania i wyświetla listę wszystkich konfiguracji projektu po kliknięciu przycisku strzałki. Środowisko wywołuje metodę GetCfgNames , aby wypełnić tę listę. GetCfgProviderProperty Jeśli metoda wskazuje, że projekt obsługuje edytowanie konfiguracji, opcje Nowe lub Edytuj są również wyświetlane pod nagłówkiem Konfiguracja. Każde z tych wyborów uruchamia okna dialogowe wywołujące metody interfejsu
IVsCfgProvider2
w celu edytowania konfiguracji projektu.Jeśli projekt nie obsługuje konfiguracji, w kolumnie Konfiguracja jest wyświetlana wartość Brak i jest wyłączona.
Platforma
Wyświetla platformę, dla której jest kompilowane wybrane konfiguracje projektu, i wyświetla listę wszystkich dostępnych platform dla projektu po kliknięciu przycisku strzałki. Środowisko wywołuje metodę GetPlatformNames , aby wypełnić tę listę. GetCfgProviderProperty Jeśli metoda wskazuje, że projekt obsługuje edytowanie platformy, opcje Nowe lub Edytuj są również wyświetlane pod nagłówkiem Platforma. Każde z tych wyborów uruchamia okna dialogowe wywołujące
IVsCfgProvider2
metody edytowania dostępnych platform projektu.Jeśli projekt nie obsługuje platform, kolumna platformy dla tego projektu wyświetla wartość Brak i jest wyłączona.
Tworzenie
Określa, czy projekt jest kompilowany przez bieżącą konfigurację rozwiązania. Niezaznaczone projekty nie są kompilowane, gdy polecenia kompilacji na poziomie rozwiązania są wywoływane pomimo wszelkich zależności projektu, które zawierają. Projekty, które nie zostały wybrane do skompilowania, są nadal uwzględniane podczas debugowania, uruchamiania, tworzenia pakietów i wdrażania rozwiązania.
Wdrażaj
Określa, czy projekt zostanie wdrożony, gdy polecenia uruchamiania lub wdrażania są używane z wybraną konfiguracją kompilacji rozwiązania. Pole wyboru dla tego pola będzie dostępne, jeśli projekt obsługuje wdrażanie przez zaimplementowanie interfejsu IVsDeployableProjectCfg w jego IVsProjectCfg2 obiekcie.
Po dodaniu nowej konfiguracji rozwiązania użytkownik może wybrać ją z listy rozwijanej Konfiguracja rozwiązania na standardowym pasku narzędzi, aby skompilować i/lub uruchomić tę konfigurację.