vs下创建和配置LinuxCMake项目

  • Z时代
  • 2024-01-10
  • 分类：综合

编程

在开始之前

首先，请确保已安装“使用 C++ 的 Linux 开发”工作负载，包括 CMake 组件 。 请参阅在 Visual Studio 中安装 C++ Linux 工作负载。

在 Linux 系统上，请确保已安装以下项：

  • gcc

  • gdb

  • rsync

  • zip

  • ninja-build  

Linux 对 CMake 项目的支持要求目标计算机具有最新版本的 CMake。 发行版的默认包管理器提供的版本通常不够新，不足以支持 Visual Studio 所需的所有功能。 Visual Studio 2019 会检测 Linux 系统上是否安装了最新版本的 CMake。 如果未找到，Visual Studio 将在编辑器窗格顶部显示一个信息栏。 它用于从 https://github.com/Microsoft/CMake/releases 为你安装 CMake。

使用 Visual Studio 中的 CMake 支持需要 CMake 3.8 中引入的服务器模式支持。 在 Visual Studio 2019 中，建议采用版本 3.14 或更高版本。

创建新的 Linux CMake 项目

若要在 Visual Studio 2019 中创建新的 Linux CMake 项目，请执行以下操作：

  1. 在 Visual Studio 中选择“文件 > 新建项目”，或按 Ctrl + Shift + N。

  2. 将“语言”设置为“C++”，然后搜索“CMake” 。 然后，选择“下一步” 。 输入“名称”和“位置”，然后选择“创建” 。

Visual Studio 创建一个最小的 CMakeLists.txt 文件，其中只包含可执行文件的名称和所需的最小 CMake 版本。 可以按自己喜欢的方式手动编辑此文件；Visual Studio 永远不会覆盖所做的更改。 可以在此文件中指定 CMake 命令行参数和环境变量。 在“解决方案资源管理器”中右键单击根 CMakeLists.txt 文件，然后选择“项目的 CMake 设置” 。 若要指定调试选项，请右键单击项目节点，然后选择“调试并启动设置” 。

打开 CMake 项目文件夹

打开包含现有 CMake 项目的文件夹时，Visual Studio 会使用 CMake 缓存中的变量来自动配置 IntelliSense 和生成。 本地配置和调试设置将存储在 JSON 文件中。 可以选择与使用 Visual Studio 的其他人共享这些文件。

Visual Studio 不会修改 CMakeLists.txt 文件。 它保持独立，因此，处理同一项目的其他人员可以继续使用其现有工具。 在保存对 CMakeLists.txt 的编辑或在某些情况下保存对 CMakeSettings.json 的编辑时，Visual Studio 会重新生成缓存。 但是，如果使用的是“现有缓存” 配置，则 Visual Studio 不会修改缓存。

有关 Visual Studio 中的 CMake 支持的常规信息，请参阅 Visual Studio 中的 CMake 项目。 在继续此处的操作前，请先阅读相关内容。

首先，在主菜单中选择“文件” > “打开” > “文件夹” ，或在开发人员命令提示窗口中键入 devenv.exe <foldername>。 打开的文件夹中应该有一个 CMakeLists.txt 文件，以及你的源代码。

以下示例显示了一个简单的 CMakeLists.txt 文件和 .cpp 文件：

C++

复制

  

// hello.cpp
#include<iostream>
intmain(int argc, char* argv[])
{
std::cout << "Hello from Linux CMake" << std::endl;
}

CMakeLists.txt ：

txt

复制

  

cmake_minimum_required(VERSION 3.8)
project (hello-cmake)
add_executable(hello-cmake hello.cpp)

选择 Linux 目标

只要打开文件夹，Visual Studio 就会分析 CMakeLists.txt 文件，并指定 Windows 目标“x86-Debug” 。 要以远程 Linux 系统为目标，请将项目设置更改为“Linux 调试”或“Linux 发布” 。 （请参阅下面的配置适用于 Linux 的 CMake 设置。）

若要以适用于 Linux 的 Windows 子系统为目标，请单击主工具栏配置下拉列表中的“管理配置” 。 如果使用 GCC，请按“添加配置” 按钮，选择“WSL-Debug” 或“WSL-Release” 。 如果使用 Clang/LLVM 工具集，则选择 Clang 变体。

Visual Studio 2019 版本 16.1 面向 WSL 时，无需源文件或头文件。 这是因为 Linux 上的编译器可以直接访问 Windows 文件系统中的源文件。 （在 Windows 10 版本 1903 及更高版本中，Windows 应用程序同样可以直接访问 Linux 头文件。 Visual Studio 尚不利用此功能。）

对于远程目标，Visual Studio 默认选择“工具” > “选项” > “跨平台” > “连接管理器”下列表中的第一个远程系统 。 如果未找到任何远程连接，那么系统会提示你进行创建。 有关详细信息，请参阅连接到远程 Linux 计算机。

如果指定远程 Linux 目标，则会将源复制到远程系统。

选择目标后，CMake 会在 Linux 系统上自动运行，以便为项目生成 CMake 缓存。

为了向远程 Linux 系统上的标头提供 IntelliSense 支持，Visual Studio 会自动将这些标头从 Linux 计算机复制到本地 Windows 计算机上的目录中。 有关详细信息，请参阅远程标头的 IntelliSense。

调试 CMake 项目

若要在指定目标系统上调试代码，请设置断点。 在项目设置旁的工具栏菜单中选择 CMake 目标作为启动项。 然后在工具栏上选择“⏵ 启动” ，或按 F5 。

若要自定义程序的命令行参数，请按“解决方案资源管理器”顶部的“切换目标”按钮，然后选择“目标视图” 。 然后右键单击一个目标并选择“调试和启动设置” 。 此命令会打开或创建 launch.vs.json 配置文件，其中包含程序信息。 要指定源文件的位置，请将 sourceFileMap 属性添加到该文件中，如以下示例中所示：

JSON

复制

  

"MIMode": "gdb",
"externalConsole": true,
"sourceFileMap": {
"c/Users/USER/source/repos/CMAKEPROJECTNAME": "C:\Users\USER\source\repos\CMAKEPROJECTNAME"
},
"remoteMachineName": "${debugInfo.remoteMachineName}",

若要指定其他参数，请以 args JSON 数组形式添加它们。 有关详细信息，请参阅 C++ 的“打开文件夹”项目和配置 CMake 调试会话。

配置适用于 Linux 的 CMake 设置

CMake Linux 项目中的 CMakeSettings.json 文件可指定在自定义 CMake 设置中列出的所有属性，以及控制远程 Linux 计算机上的生成设置的其他属性。

若要在 Visual Studio 2019 中更改默认 CMake 设置，请在主工具栏中打开“配置”下拉列表，然后选择“管理配置” 。

此命令将打开“CMake 设置编辑器”，可使用它来编辑根项目文件夹中的 CMakeSettings.json 文件 。 也可以通过单击编辑器中的“编辑 JSON”按钮来直接打开文件 。 有关详细信息，请参阅自定义 CMake 设置。

Visual Studio 2019 版本 16.1 中的默认 Linux 调试配置如下所示：

JSON

复制

  

{
"name": "Linux-Debug",
"generator": "Unix Makefiles",
"configurationType": "Debug",
"cmakeExecutable": "/usr/bin/cmake",
"remoteCopySourcesExclusionList": [ ".vs", ".git", "out" ],
"cmakeCommandArgs": "",
"buildCommandArgs": "",
"ctestCommandArgs": "",
"inheritEnvironments": [ "linux_x64" ],
"remoteMachineName": "${defaultRemoteMachineName}",
"remoteCMakeListsRoot": "$HOME/.vs/${projectDirName}/${workspaceHash}/src",
"remoteBuildRoot": "$HOME/.vs/${projectDirName}/${workspaceHash}/out/build/${name}",
"remoteInstallRoot": "$HOME/.vs/${projectDirName}/${workspaceHash}/out/install/${name}",
"remoteCopySources": true,
"rsyncCommandArgs": "-t --delete --delete-excluded",
"remoteCopyBuildOutput": false,
"remoteCopySourcesMethod": "rsync",
"addressSanitizerRuntimeFlags": "detect_leaks=0",
"variables": []
    }
  ]
}

有关这些设置的详细信息，请参阅 CMakeSettings.json 引用。

可选设置

可使用以下可选设置进行更多控制：

JSON

复制

  

{
"remotePrebuildCommand": "",
"remotePreGenerateCommand": "",
"remotePostbuildCommand": "",
}

这些选项可用于生成前后以及 CMake 生成前在 Linux 系统中运行命令。 值可以是远程系统上的任何有效命令。 输出通过管道传递回 Visual Studio。

以上是 vs下创建和配置LinuxCMake项目 的全部内容， 来源链接： utcz.com/z/517440.html

回到顶部