{"id":22275,"date":"2019-01-24T10:02:04","date_gmt":"2019-01-24T18:02:04","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/vcblog\/?p=22275"},"modified":"2019-04-11T18:03:54","modified_gmt":"2019-04-11T18:03:54","slug":"introducing-the-new-cmake-project-settings-ui","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/introducing-the-new-cmake-project-settings-ui\/","title":{"rendered":"Introducing the New CMake Project Settings UI"},"content":{"rendered":"

Visual Studio 2019 Preview 2 introduces a new CMake Project Settings Editor to help you more easily configure your CMake projects in Visual Studio. The editor provides an alternative to modifying the CMakeSettings.json file directly and allows you to create and manage your CMake configurations.<\/p>\n

If you\u2019re just getting started with CMake in Visual Studio, head over to our CMake Support in Visual Studio introductory page<\/a>.<\/p>\n

\"The<\/a><\/p>\n

The goal of this editor is to simplify the experience of configuring a CMake project by grouping and promoting commonly used settings, hiding advanced settings, and making it easier to edit CMake variables. This is the first preview of this new UI so we will continue to improve it based on your feedback.<\/p>\n

Open the editor<\/h2>\n

The CMake Project Settings Editor opens by default when you select \u201cManage Configurations\u2026\u201d from the configuration drop-down menu at the top of the screen.<\/p>\n

\"Open<\/a><\/p>\n

You can also right-click on CMakeSettings.json in the Solution Explorer and select \u201cEdit CMake Settings\u201d from the context menu. If you prefer to manage your configurations directly from the CMakeSettings.json file, you can click the link to \u201cEdit JSON\u201d in the top right-hand corner of the editor.<\/p>\n

Configurations sidebar<\/h2>\n

The <\/span><\/span>left <\/span><\/span>side <\/span><\/span>of the editor contains a configurations sidebar where you can easily toggle between your existing configurations, add a new configuration, and remove configurations. You can also now <\/span><\/span>clone<\/span><\/span><\/strong> an existing configuration so that the new <\/span><\/span>configuration <\/span><\/span>inherits all properties set by the original.\u00a0<\/span><\/span><\/p>\n

\"The<\/a><\/p>\n

Sections of the editor<\/h2>\n

The editor contains four sections: General, Command Arguments, CMake Variables and Cache, and Advanced. The General, Command Arguments, and Advanced sections provide a user interface for properties exposed in the CMakeSettings.json file. The Advanced section is hidden by default and can be expanded by clicking the link to \u201cShow advanced settings\u201d at the bottom of the editor.<\/p>\n

The CMake Variables and Cache <\/b>section provides a new way for you to edit CMake variables. You can click \u201cSave and Generate CMake Cache to Load Variables\u201d to generate the CMake cache and populate a table with all the CMake cache variables available for you to edit. Advanced variables (per the CMake GUI) are hidden by default. You can check \u201cShow Advanced Variables\u201d to show all cache variables or use the search functionality to filter CMake variables by name.<\/p>\n

\"The<\/a><\/p>\n

You can change the value of any CMake variable by editing the \u201cValue\u201d column of the table. Modified variables are automatically saved to CMakeSettings.json.<\/p>\n

Linux configurations<\/h2>\n

The CMake Project Settings Editor also provides support for Linux configurations. If you are targeting a remote Linux machine, the editor will expose properties specific to a remote build and link to the Connection Manager, where you can add and remove connections to remote machines.<\/p>\n

\"CMake<\/a><\/p>\n

Give us your feedback!<\/h2>\n

We\u2019d love for you to download Visual Studio 2019<\/a> and give it a try. As always, we welcome your feedback. We can be reached via the comments below or via email (visualcpp@microsoft.com<\/a>). If you encounter other problems with Visual Studio or MSVC or have a suggestion please let us know through Help > Send Feedback > Report A Problem \/ Provide a Suggestion <\/b>in the product, or via Developer Community<\/a>. You can also find us on Twitter (@VisualC<\/a>) and Facebook (msftvisualcpp<\/a>).<\/p>\n","protected":false},"excerpt":{"rendered":"

Visual Studio 2019 Preview 2 introduces a new CMake Project Settings Editor to help you more easily configure your CMake projects in Visual Studio. The editor provides an alternative to modifying the CMakeSettings.json file directly and allows you to create and manage your CMake configurations. If you\u2019re just getting started with CMake in Visual Studio, […]<\/p>\n","protected":false},"author":2953,"featured_media":22747,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[270,266,279,230,269],"tags":[],"class_list":["post-22275","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-announcement","category-cmake","category-linux","category-new-feature","category-openfolder"],"acf":[],"blog_post_summary":"

Visual Studio 2019 Preview 2 introduces a new CMake Project Settings Editor to help you more easily configure your CMake projects in Visual Studio. The editor provides an alternative to modifying the CMakeSettings.json file directly and allows you to create and manage your CMake configurations. If you\u2019re just getting started with CMake in Visual Studio, […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/22275","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/users\/2953"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=22275"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/22275\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/22747"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=22275"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=22275"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=22275"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}