Projekty CMake v Visual Studio

Visual Studio nativní podpora CMake umožňuje upravovat, sestavovat a ladit projekty CMake v Windows, Subsystém Windows pro Linux (WSL) a vzdálených systémech ze stejné instance Visual Studio. Soubory projektu CMake (například ) využívají přímo Visual Studio pro účely CMakeLists.txt IntelliSense a procházení. cmake.exese vyvolá přímo příkazem Visual Studio konfigurace a sestavení CMake.

Instalace

Nástroje C++ CMake pro Windows se instaluje jako součást vývoje desktopových aplikací pomocí jazyka C++ a vývoje pro Linux pomocí úloh jazyka C++. Oba nástroje C++ CMake pro Windows a linuxový vývoj v jazyce C++ jsou vyžadovány pro vývoj CMake pro více platforem.

Další informace najdete v tématu Instalace linuxové úlohy C++ v Visual Studio.

Integrace integrovaného vývojového prostředí (IDE)

Když otevřete složku obsahující soubor, stane se následující.

• Visual Studio přidá do nabídky Project CMake položky CMake s příkazy pro zobrazení a úpravy skriptů CMake.

• V Průzkumník řešení se zobrazí struktura složek a soubory.

• Visual Studio CMake a vygeneruje soubor mezipaměti CMake ( CMakeCache.txt ) pro výchozí konfiguraci. Příkazový řádek CMake se zobrazí v okno Výstupa další výstup z CMake.

• Na pozadí Visual Studio indexovat zdrojové soubory, aby bylo možné povolit technologii IntelliSense, informace o procházení, refaktoring atd. Jak pracujete, Visual Studio monitoruje změny v editoru a také na disku, aby byl index synchronizovaný se zdroji.

Po úspěšném generování mezipaměti CMake můžete také zobrazit projekty uspořádané logicky podle cílů. V rozevíracím seznamu na panelu nástrojů pro výběr Průzkumník řešení cíle:

Zvolte tlačítko Zobrazit všechny soubory v horní části Průzkumník řešení zobrazíte ve složkách všechny výstupy vygenerované pomocí CMake.

Soubor v každé složce projektu použijte stejně jako CMakeLists.txt v jakémkoli projektu CMake. Můžete zadat zdrojové soubory, najít knihovny, nastavit možnosti kompilátoru a linkeru a zadat další informace související se systémem sestavení. Další informace o jazykových službách CMake poskytovaných Visual Studio najdete v tématu Úprava CMakeLists.txt souborů.

Visual Studio a sestavení mezipaměti CMake používá konfigurační soubor CMake. Další informace najdete v tématu Konfigurace projektů CMake a Vytváření projektů CMake.

Pokud chcete předávat argumenty spustitelnému souboru při ladění, můžete použít jiný soubor s názvem launch.vs.json . Další informace o ladění projektů CMake pro více platforem v Visual Studio tématu Ladění projektů CMake.

Projekty CMake Visual Studio podporu většiny funkcí jazyka C++ v Visual Studio. Mezi příklady patří:

• Upravit a pokračovat pro projekty CMake

• Integrace incredibuild pro projekty CMake

• Podpora AddressSanitizer pro projekty CMake

• Podpora Clang/LLVM

Konfigurace projektů CMake

Krok konfigurace CMake vygeneruje systém sestavení projektu. Je ekvivalentní volání z cmake.exe příkazového řádku. Další informace o kroku konfigurace CMake najdete v dokumentaci ke CMake.

Visual Studio používá konfigurační soubor CMake k řízení generování a sestavování CMake. Soubor CMakePresets.json podporuje Visual Studio 2019 verze 16.10 nebo novější a je doporučený konfigurační soubor CMake. Soubor CMakePresets.json podporuje přímo CMake a lze ho použít k řízení generování a sestavování CMake z Visual Studio, z VS Code, v kanálu kontinuální integrace a z příkazového řádku v systémech Windows, Linux a Mac. Další informace o souboru CMakePresets.json najdetev tématu Konfigurace a sestavení s předvolbami CMake. Soubor CMakeSettings.json je k dispozici zákazníkům, kteří používají starší verzi Visual Studio. Další informace o souboru CMakeSettings.json najdetev tématu Přizpůsobení nastavení sestavení CMake.

Pokud v konfiguračním souboru nebo souboru CMake výrazně změníte, Visual Studio automaticky spustí krok CMakeLists.txt konfigurace CMake. Konfiguraci můžete vyvolat ručně výběrem možnosti Project konfigurovat mezipaměť na panelu nástrojů. Předvolby konfigurace můžete také změnit v části Nástroje Možnosti > CMake > Obecné.

Pokud se krok konfigurace dokončí bez chyb, informace, které jsou k dispozici, řídí C++ IntelliSense a jazykové služby. Používá se také v operacích sestavení a ladění.

Můžete také otevřít existující mezipaměť CMake v Visual Studio. Další informace najdete v tématu Otevření existující mezipaměti.

Přizpůsobení názorů na konfiguraci a oznámení

Ve výchozím nastavení je většina zpráv konfigurace potlačena, pokud ne dojde k chybě. Pokud chcete zobrazit všechny zprávy, vyberte NástrojeMožnostiCMakePovolit podrobný diagnostický výstup CMake.

Výběrem možnosti Zobrazit oznámení mezipaměti CMake můžete také zakázat všechna oznámení mezipaměti CMake (zlaté pruhy).

Řešení potíží s chybami mezipaměti CMake

Pokud potřebujete další informace o stavu mezipaměti CMake pro diagnostiku problému, otevřete hlavní nabídku Project nebo místní nabídku v Průzkumník řešení a spusťte jeden z těchto příkazů:

• Zobrazení CMakeCache.txt otevře soubor z adresáře sestavení v editoru. Pokud mezipaměť vyčistíte, veškeré úpravy, které zde CMakeCache.txt provádíte, se vymažou. Pokud chcete provést změny, které se zachovávají po vyčištění mezipaměti, podívejte se na stránku Přizpůsobení nastavení CMake nebo Konfigurace a sestavení pomocí předvoleb CMake.

• Odstranění mezipaměti a změna konfigurace odstraní adresář sestavení a překonfiguruje ho z čisté mezipaměti.

• Konfigurace mezipaměti vynutí spuštění kroku generování, i když Visual Studio považuje prostředí za aktuální.

Sestavování projektů CMake

Krok sestavení CMake sestaví už vygenerovaný binární strom projektu. Je ekvivalentní volání z cmake --build příkazového řádku. Další informace o kroku sestavení CMake najdete v dokumentaci k CMake.

Při vytváření projektu CMake máte tyto možnosti:

1. Na panelu nástrojů vyhledejte rozevírací seznam Položka po spuštění. Vyberte upřednostňovaný cíl a stiskněte klávesu F5nebo zvolte tlačítko Spustit na panelu nástrojů. Projekt se automaticky sestaví jako první, stejně jako Visual Studio řešení.

2. Klikněte pravým tlačítkem na cíl CMake s aktivním zobrazením cílů CMake Průzkumník řešení v místní nabídce vyberte Sestavit.

3. V hlavní nabídce vyberte Build Build All (Sestavit vše). Ujistěte se, že v rozevíracím seznamu Spouštěcí položka na panelu nástrojů je už vybraný cíl CMake.

Jak byste očekávali, výsledky sestavení se zobrazují v okno Výstup a Seznam chyb.

Úprava nastavení sestavení

Visual Studio sestavení CMake používá konfigurační soubor CMake. Konfigurační soubory CMake zapouzdřují možnosti sestavení, jako jsou nativní přepínače nástroje sestavení a proměnné prostředí. Pokud je soubor CMakePresets.json aktivním konfiguračním souborem, podívejte se na část Konfigurace a sestavení s předvolbami CMake. Pokud je aktivním konfiguračním souborem CMakeSettings.json, podívejte se na stránku Přizpůsobení nastavení sestavení CMake. Soubor CMakePresets.json je k dispozici v Visual Studio 2019 verze 16.10 nebo novější a je doporučený konfigurační soubor CMake.

Ladění projektů CMake

Všechny spustitelné cíle CMake se zobrazují v rozevíracím seznamu Spouštěcí položka na panelu nástrojů. Pokud chcete spustit ladění, vyberte ho a na panelu nástrojů stiskněte tlačítko Ladit spustit ladění. V projektu CMake je možnost Aktuální dokument platná pouze pro soubory .cpp.

Příkazy Debug nebo F5 nejprve sestaví projekt, pokud byly od předchozího sestavení provedeny změny. Změny konfiguračního souboru CMake (CMakePresets. JSON nebo CMakeSettings. JSON) nebo způsobí, že se mezipaměť cmake znovu vygeneruje.

Relaci ladění CMake můžete přizpůsobit nastavením vlastností v launch.vs.json souboru. chcete-li přizpůsobit nastavení ladění pro konkrétní cíl, vyberte cíl v rozevíracím seznamu položka po spuštění a stiskněte položku ladit ladění a spusťte Nastavení pro možnost aktivní cíl >. Další informace o relacích ladění CMake najdete v tématu Konfigurace relací ladění cmake.

Pouze můj kód pro projekty CMake

při sestavování pro Windows pomocí kompilátoru MSVC mají projekty cmak podporu pro Pouze můj kód ladění. Chcete-li změnit nastavení pouze můj kód, přejděte na Možnostinástroje laděníObecné.

Upravit a pokračovat pro projekty CMake

při sestavování pro Windows s kompilátorem MSVC mají projekty cmak podporu pro úpravy a pokračování. Přidejte do souboru následující kód CMakeLists.txt , aby bylo možné povolit možnost upravit a pokračovat.

if(MSVC)
  target_compile_options(<target> PUBLIC "/ZI")
  target_link_options(<target> PUBLIC "/ZI" "/INCREMENTAL")
endif()

Připojení k projektu CMake běžícímu na Linux

Visual Studio umožňuje ladit proces spuštěný ve vzdáleném systému Linux nebo WSL a ladit ho pomocí ladicího programu GDB. Začněte tím, že vyberete laditpřipojit k procesu..., nastavíte Typ připojení na SSHa ze seznamu připojení ve Správci připojení vyberete cíl připojení . Vyberte proces ze seznamu dostupných procesů a stiskněte připojit. GDB musí být nainstalovaný na počítači se systémem Linux. Další informace o připojení SSH najdete v tématu Správce připojení .

Otevřít existující mezipaměť

když otevřete existující soubor mezipaměti cmake ( CMakeCache.txt ), Visual Studio se nepokusí spravovat mezipaměť a strom sestavení za vás. Vaše vlastní nebo preferované nástroje mají plnou kontrolu nad tím, jak CMake nakonfiguruje váš projekt.

Do otevřeného projektu můžete přidat existující mezipaměť CMake. To se provádí stejným způsobem jako při přidávání nové konfigurace. Další informace najdete v našem blogovém příspěvku o otevření existující mezipaměti v Visual Studio.

Pokročilé řešení potíží s mezipamětí CMake

Visual Studio používá rozhraní API cmake založené na souborech (ve verzích 3,14 a novější) k naplnění editoru o informace specifické pro vaši strukturu projektu. Další informace najdete v blogovém příspěvku týmu C++ na více kořenových pracovních prostorech a na souborovém rozhraní API.

Před vygenerováním mezipaměti CMake může být nutné, aby vaše vlastní nebo preferované nástroje vytvořily soubor dotazů s názvem .cmake/api/v1/query/client-MicrosoftVS/query.json ve výstupní složce sestavení (složka, která obsahuje CMakeCache.txt ). Soubor dotazu by měl obsahovat tento obsah:

{"requests":[{"kind":"cache","version":2},{"kind":"cmakeFiles","version":1},{"kind":"codemodel","version":2}]}

když vaše mezipaměť vygeneruje vaše vlastní nebo preferované nástroje, uloží cmake soubory .cmake/api/v1/response do tohoto Visual Studio používá k naplnění editoru informace, které jsou specifické pro vaši strukturu projektu.

Úpravy CMakeLists.txt souborů

Chcete-li upravit CMakeLists.txt soubor, klikněte pravým tlačítkem myši na soubor v CMakeLists.txt a vyberte možnost otevřít. Pokud provedete změny v souboru, zobrazí se žlutý stavový řádek, který bude informovat o aktualizaci IntelliSense. Nabízí možnost zrušit operaci aktualizace. Informace o nástroji CMakeLists.txt najdete v CMakeLists.txt.

Jakmile soubor uložíte, krok konfigurace se automaticky spustí znovu a zobrazí informace v okně výstup . Chyby a varování se zobrazí v okně Seznam chyb nebo výstup . Dvojím kliknutím na chybu v Seznam chyb přejděte na problematický řádek v .

Jazykové služby pro CMake

jazykové služby pro cmake jsou k dispozici v Visual Studio 2019 verze 16,5 nebo novější. Funkce pro navigaci v kódu jako přejít na definici, náhled definice a najít všechny odkazy jsou podporované pro součásti CMake, funkce a cíle v souborech skriptu CMake. Další informace najdete v tématu Navigace v kódu pro skripty cmake.

Manipulace s projektem CMake

manipulace s projekty cmake je k dispozici ve verzi Visual Studio 2019 16,5 nebo novější. Project manipulace umožňuje přidat, odebrat a přejmenovat zdrojové soubory a cíle v projektu cmake, aniž byste museli ručně upravovat skripty cmake. když přidáte nebo odeberete soubory z Průzkumník řešení, Visual Studio automaticky upraví projekt cmake. pokud je k dispozici více míst, kde má smysl přidat nebo odebrat odkaz na skript cmake, Visual Studio zobrazí dotaz, kde chcete provést změnu, a zobrazit náhled navrhovaných změn. Podrobné pokyny najdete v tématu Přidání, odebrání a přejmenování souborů a cílů v projektech cmake.

IntelliSense pro projekty CMake

ve výchozím nastavení Visual Studio používá režim IntelliSense, který se shoduje s kompilátorem a cílovou architekturou určenou aktivní konfigurací cmake.

pokud je CMakePresets. json vaším aktivním konfiguračním souborem cmake, můžete zadat další možnosti technologie IntelliSense s a intelliSenseOptions v mapě Visual Studio Nastavení dodavatele. další informace najdete v referenčních informacích k mapě Visual Studio Nastavení dodavatele.

Pokud je CMakeSettings. JSON vaším aktivním konfiguračním souborem cmake, můžou se v souboru CMakeSettings. JSONzadat další možnosti technologie IntelliSense. Další informace naleznete v odkazu CMakeSettings. JSON.

Konfigurace IntelliSense pomocí souborů sada nástrojů CMake

Visual Studio bude v projektech cmake automaticky konfigurovat IntelliSense na základě hodnoty proměnných cmake nastavených souborem cmake v Visual Studio 2019 verze 16,9 nebo novější. Tato funkce poskytuje automatickou konfiguraci IntelliSense, když se soubor sada nástrojů CMake používá pro konfiguraci a sestavování CMake. Další informace najdete v tématu Konfigurace IntelliSense pomocí souborů sada nástrojů cmake.

Integrace Vcpkg

projekty cmake otevřené v Visual Studio integraci s vcpkg, což je správce závislostí ve více platformách C/C++. před použitím vcpkg s Visual Studio musíte spustit vcpkg integrate install . pokyny a další informace o vcpkg najdete v dokumentaci k vcpkg.

pokud je CMakeSettings. json vaším aktivním konfiguračním souborem, pak Visual Studio automaticky předáte vcpkg souboru sada nástrojů ( ) do cmake. toto chování se automaticky zakáže, když v konfiguraci Nastavení cmake zadáte jakýkoli jiný sada nástrojů.

Pokud je CMakePresets. JSON vaším aktivním konfiguračním souborem, pak budete muset nastavit cestu k v souboru CMakePresets. JSON. VCPKG_ROOTK zachování sdílení souborů doporučujeme použít proměnnou prostředí místo absolutní cesty. další informace najdete v tématu povolení integrace vcpkg s předdefinovanými cmake. CMakePresets. json je k dispozici ve verzi Visual Studio 2019 16,10 nebo novější a jedná se o doporučený konfigurační soubor cmake.

Spuštění CMake z příkazového řádku

Pokud je CMakePresets. JSON vaším aktivním konfiguračním souborem cmake, můžete snadno reprodukování místní sestavení mimo Visual Studio. Další informace najdete v tématu spuštění cmake z příkazového řádku nebo kanálu CI. CMakePresets. json se podporuje v Visual Studio 2019 verze 16,10 nebo novější a je to doporučený konfigurační soubor cmake.

Pokud je CMakeSettings. JSON vaším aktivním konfiguračním souborem cmake, budete muset ručně předávat argumenty, které jsou zakódované v souboru CMakeSettings. JSON , do cmake. pokud jste nainstalovali cmake z Instalační program pro Visual Studio, můžete ji spustit z příkazového řádku pomocí následujících kroků:

1. Spusťte příslušný vsdevcmd.bat soubor (x86/x64). Další informace najdete v tématu sestavování na příkazovém řádku .

2. Přepněte do výstupní složky.

3. Spusťte CMake pro sestavování nebo konfiguraci vaší aplikace.

Visual Studio 2017 nabízí bohatou podporu pro cmake, včetně projektů cmake pro různé platformy. Komponenta Visual C++ Tools for cmake používá funkci Otevřít složku , která umožňuje integrovanému vývojovém prostředí (IDE) využívat soubory projektu cmake (například ) přímo pro účely IntelliSense a procházení. expertem i generátory Visual Studio jsou podporovány. použijete-li generátor Visual Studio, vygeneruje dočasný soubor projektu a předá ho MSBuild. Projekt se ale nikdy nenačte pro účely IntelliSense nebo procházení. Můžete také importovat stávající mezipaměť CMake.

Instalace

Visual C++ nástroje pro cmaki se nainstalují jako součást vývoje pro stolní počítače s vývojem v jazyce c++ a Linux s využitím úloh c++.

Další informace najdete v tématu Instalace linuxové úlohy C++ v Visual Studio.

Integrace integrovaného vývojového prostředí (IDE)

Když zvolíte Otevřít > složku a otevřete složku obsahující CMakeLists.txt soubor, stane se toto:

• Visual Studio do hlavní nabídky přidá položku nabídky CMake s příkazy pro zobrazení a úpravy skriptů CMake.

• Průzkumník řešení se struktura složek a soubory.

• Visual Studio CMake a volitelně vygeneruje mezipaměť CMake pro výchozí konfiguraci ,což je ladění x86. Příkazový řádek CMake se zobrazí v okno Výstupa další výstup z CMake.

• Na pozadí Visual Studio indexovat zdrojové soubory, aby bylo možné povolit technologii IntelliSense, informace o procházení, refaktoring atd. Jak pracujete, Visual Studio monitoruje změny v editoru a také na disku, aby byl index synchronizovaný se zdroji.

Můžete otevřít složky obsahující libovolný počet projektů CMake. Visual Studio rozpozná a nakonfiguruje všechny "kořenové" CMakeLists.txt soubory ve vašem pracovním prostoru. Operace CMake (konfigurace, sestavení, ladění), C++ IntelliSense a procházení jsou dostupné pro všechny projekty CMake ve vašem pracovním prostoru.

Můžete také zobrazit projekty uspořádané logicky podle cílů. V rozevíracím seznamu na panelu nástrojů pro výběr Průzkumník řešení cíle:

Visual Studio používá soubor s názvem k ukládání proměnných prostředí nebo CMakeSettings.json možností příkazového řádku pro CMake. CMakeSettings.json umožňuje také definovat a ukládat několik konfigurací sestavení CMake. Mezi nimi můžete pohodlně přepínat v integrovaném vývojovém prostředí (IDE).

Jinak použijte stejně jako v jakémkoli projektu CMake zdrojové soubory, vyhledejte knihovny, nastavte možnosti kompilátoru a linkeru a zadejte další informace související se systémem CMakeLists.txt sestavení.

Pokud potřebujete předávat argumenty spustitelnému souboru při ladění, můžete použít jiný soubor s názvem launch.vs.json . V některých scénářích Visual Studio tyto soubory automaticky vygeneruje. Můžete je upravit ručně, nebo dokonce vytvořit soubor sami.

Import existující mezipaměti

Při importu existujícího souboru Visual Studio automaticky extrahuje přizpůsobené proměnné a na jejich základě vytvoří CMakeCache.txtCMakeSettings.json předem vyplněný soubor. Původní mezipaměť se žádným způsobem neupraví. Stále se může používat z příkazového řádku nebo pomocí jakéhokoli nástroje nebo integrovaného vývojového prostředí, které se použilo k jeho vygenerování. Nový CMakeSettings.json soubor se umístí společně s kořenem projektu CMakeLists.txt . Visual Studio soubor nastavení vygeneruje novou mezipaměť. Automatické generování mezipaměti můžete přepsat v dialogovém okně Nástroje Možnosti > CMake > Obecné.

Ne všechno v mezipaměti se importuje. Vlastnosti, jako je generátor a umístění kompilátorů, jsou nahrazeny výchozími nastaveními, o které je známo, že dobře fungují s rozhraním IDE.

Import existující mezipaměti

1. V hlavní nabídce zvolte Soubor Otevřít > CMake:

   

   Tento příkaz zobrazí průvodce importem CMake z mezipaměti.

2. Přejděte k CMakeCache.txt souboru, který chcete importovat, a pak zvolte CMakeCache.txt. Zobrazí se průvodce importem Project CMake z mezipaměti:

   

   Po dokončení průvodce se nový soubor zobrazí v souboru Průzkumník řešení vedle kořenového CMakeCache.txt souboru v CMakeCache.txtCMakeLists.txt projektu.

Sestavování projektů CMake

Při vytváření projektu CMake máte tyto možnosti:

1. Na panelu nástrojů Obecné vyhledejte rozevírací seznam Konfigurace. Ve výchozím nastavení pravděpodobně zobrazuje "Linux-Debug" nebo "x64-Debug". Vyberte upřednostňovanou konfiguraci a stiskněte klávesu F5nebo zvolte tlačítko Spustit (zelený trojúhelník) na panelu nástrojů. Projekt se automaticky sestaví jako první, stejně jako Visual Studio řešení.

2. Klikněte pravým tlačítkem CMakeLists.txt na CMakeLists.txt a v místní nabídce vyberte Build (Sestavit). Pokud máte ve struktuře složek více cílů, můžete se rozhodnout sestavit jenom jeden konkrétní cíl.

3. V hlavní nabídce vyberte Sestavit řešení sestavení (F7 nebo Ctrl+Shift+B). Ujistěte se, že je cíl CMake už vybraný v rozevíracím seznamu Spouštěcí položka na panelu nástrojů Obecné.

V souboru můžete přizpůsobit konfigurace sestavení, proměnné prostředí, argumenty příkazového řádku a další CMakeSettings.json nastavení. Umožňuje provádět změny beze změny CMakeLists.txt souboru. Další informace najdete v tématu Přizpůsobení nastavení CMake.

Jak byste očekávali, výsledky sestavení se zobrazují v okno Výstup a Seznam chyb.

Ve složce s více cíli sestavení můžete určit cíl CMake, který se má sestavit: Zvolte položku Sestavení v nabídce CMake nebo v místní nabídce určete cíl. Pokud v projektu CMake zadáte Ctrl+Shift+B, sestaví se aktuální aktivní dokument.

Ladění projektů CMake

Pokud chcete ladit projekt CMake, zvolte upřednostňovanou konfiguraci a stiskněte klávesu F5. Nebo stiskněte tlačítko Spustit na panelu nástrojů. Pokud se na tlačítku Spustit zobrazí "Select Startup Item" (Vybrat spouštěcí položku), vyberte šipku rozevíracího seznamu a zvolte cíl, který chcete spustit. (V projektu CMake je možnost Aktuální dokument platná jenom pro soubory .cpp.)

Příkazy Run nebo F5 nejprve sestaví projekt, pokud od předchozího sestavení byly provedeny změny.

Ladicí relaci CMake můžete přizpůsobit nastavením vlastností v launch.vs.json souboru . Další informace najdete v tématu Konfigurace ladicích relací CMake.

Úpravy CMakeLists.txt souborů

Pokud chcete soubor CMakeLists.txt upravit, klikněte pravým tlačítkem na soubor v CMakeLists.txt a zvolte Otevřít. Pokud v souboru změníte změny, zobrazí se žlutý stavový řádek, který vás informuje o aktualizaci technologie IntelliSense. Máte tak možnost operaci aktualizace zrušit. Informace o najdete CMakeLists.txt v dokumentaci CMakeLists.txt

Jakmile soubor uložíte, krok konfigurace se automaticky spustí znovu a zobrazí informace v okně Výstup. Chyby a upozornění se zobrazují v okně Seznam chybnebo Výstup. Poklikejte na chybu v Seznam chyb a přejděte na řádek, který vás uráží.

CMake – krok konfigurace

Při významných změnách souborů nebo se Visual Studio automaticky znovu spustí krok konfigurace CMakeSettings.jsonCMakeLists.txt CMake. Pokud se krok konfigurace dokončí bez chyb, jsou shromážděné informace dostupné v C++ IntelliSense a jazykových službách. Používá se také v operacích sestavení a ladění.

Více projektů CMake může používat stejný název konfigurace CMake (například x86-Debug). Všechny jsou nakonfigurovány a sestaveny (ve vlastní kořenové složce sestavení), když je tato konfigurace vybrána. Cíle můžete ladit ze všech projektů CMake, které se účastní této konfigurace CMake.

Sestavení a ladicí relace můžete omezit na podmnožinu projektů v pracovním prostoru. Vytvořte novou konfiguraci s jedinečným názvem v CMakeSettings.json souboru. Potom tuto konfiguraci použijte pouze na tyto projekty. Když je tato konfigurace vybraná, intellisense a příkazy sestavení a ladění se vztahují pouze na tyto zadané projekty.

Řešení potíží s chybami mezipaměti CMake

Pokud potřebujete další informace o stavu mezipaměti CMake pro diagnostiku problému, otevřete hlavní nabídku CMake nebo místní nabídku v Průzkumník řešení a spusťte jeden z těchto příkazů:

• Mezipaměť zobrazení otevře soubor z kořenové složky sestavení v editoru. (Pokud mezipaměť vyčistíte, veškeré úpravy, které zde CMakeCache.txt provádíte, se vymažou. Pokud chcete provést změny, které se po vyčištění mezipaměti zachovávají, podívejte se na přizpůsobení nastavení CMake.)

• Otevření složky mezipaměti otevře okno Průzkumníka kořenové složky sestavení.

• Funkce Vyčistit mezipaměť odstraní kořenovou složku sestavení tak, aby další krok konfigurace CMake začal z čisté mezipaměti.

• Generate Cache vynutí spuštění kroku generování, i když Visual Studio prostředí považuje za aktuální.

Automatické generování mezipaměti je možné zakázat v dialogovém okně Nástroje Možnosti > CMake > Obecné.

Kompilace s jedním souborem

Pokud chcete vytvořit jeden soubor v projektu CMake, klikněte pravým tlačítkem na soubor v Průzkumník řešení. V místní nabídce zvolte Kompilovat. Aktuálně otevřený soubor můžete také vytvořit v editoru pomocí hlavní nabídky CMake:

Spuštění CMake z příkazového řádku

Pokud jste CMake nainstalovali z Instalační program pro Visual Studio, můžete ho spustit z příkazového řádku pomocí následujících kroků:

1. Spusťte příslušný vsdevcmd.bat soubor (x86/x64). Další informace najdete v tématu Sestavení na příkazovém řádku.

2. Přepněte do výstupní složky.

3. Spusťte CMake a sestavte nebo nakonfigurujte aplikaci.

V Visual Studio 2015 mohou uživatelé Visual Studio pomocí generátoru CMake vygenerovat soubory projektu MSBuild, které pak integrované vývojové prostředí využívá pro IntelliSense, procházení MSBuild kompilaci.