You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/build/cmake-projects-in-visual-studio.md
+5-5Lines changed: 5 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -64,12 +64,12 @@ When you open an existing CMake cache file (*`CMakeCache.txt`*), Visual Studio d
64
64
You can add an existing CMake cache to an open project. It's done the same way you'd add a new configuration. For more information, see our blog post on [opening an existing cache in Visual Studio](https://devblogs.microsoft.com/cppblog/open-existing-cmake-caches-in-visual-studio/).
65
65
66
66
> [!NOTE]
67
-
> The default existing cache experience relies on cmake-server, which has been removed from CMake in version 3.20. In Visual Studio 2019 16.10 and later, you will need to do one of the following in order to continue using existing cache functionality:
68
-
> 1. Manually install CMake with version 3.19 or lower. Then set the `cmakeExecutable` property in your existing cache configuration to that CMake.
69
-
> 2. In your existing cache configuration, set the `cacheGenerationCommand` property (see the [CMakeSettings.json reference page](cmakesettings-reference.md) for more details). This allows Visual Studio to request the necessary CMake file-based API files.
70
-
> 3. Ensure the CMake file-based API files are requested when generating your cache prior to opening it in Visual Studio. The instructions for how to do this are described below in "Advanced CMake cache troubleshooting".
67
+
> The default existing cache experience relies on `cmake-server`, which was removed from CMake in version 3.20. To continue using existing cache functionality in Visual Studio 2019 version 16.10 and later, take one of these steps:
68
+
> - Manually install CMake version 3.19 or lower. Then, set the `cmakeExecutable` property in your existing cache configuration to use that version of CMake.
69
+
> - In your existing cache configuration, set the `cacheGenerationCommand` property to let Visual Studio request the necessary CMake file-based API files. For more information on that property, see [CMakeSettings.json reference](cmakesettings-reference.md#configurations).
70
+
> - Use a query file to request the CMake file-based API files when generating your cache before it's opened in Visual Studio. For query file instructions, see the next section, [Advanced CMake cache troubleshooting](#advanced).
Visual Studio uses the CMake [file-based API](https://cmake.org/cmake/help/latest/manual/cmake-file-api.7.html) (in versions 3.14 and later) to populate the editor with information specific to your project structure. For more information, see the C++ team blog post on [multi-root workspaces and file-based API](https://devblogs.microsoft.com/cppblog/visual-studio-code-cmake-tools-extension-multi-root-workspaces-and-file-based-api/).
0 commit comments