Clion下vcpkg的使用详解

Clion是一个流行的C++开发环境，而vcpkg是一个C++库管理器，旨在简化依赖项安装和管理。本文将简要介绍Clion中如何使用vcpkg。

安装vcpkg

首先，需要下载并安装vcpkg，可以从https://github.com/microsoft/vcpkg上下载最新版本的vcpkg。

接下来，我们需要将vcpkg添加到系统路径中，然后打开命令行工具，并导航到vcpkg目录。执行以下命令，安装所需的基本库：

.\vcpkg install zlib:x64-windows openssl:x64-windows

这将在vcpkg安装目录下的packages目录中安装这些库的二进制文件（Windows）。要在Linux / macOS上安装，请将上面的“x64-windows”替换为您的架构（x64-linux / x64-osx）。

配置Clion使用vcpkg

接下来，我们需要配置Clion使用vcpkg来管理项目的依赖项。这可以通过添加以下两个变量到CMakeLists.txt文件中来完成：

set(VCPKG_TARGET_TRIPLET "x64-windows" CACHE STRING "")
set(CMAKE_TOOLCHAIN_FILE <vcpkg_root_directory>/scripts/buildsystems/vcpkg.cmake CACHE STRING "")

需要将上面的“x64-windows”替换为您的目标体系结构（x64-linux / x64-osx）。

这两行代码告诉CMake使用vcpkg作为库管理器，并告诉它查找指定目标三元组（Windows / Linux / macOS）的库。

添加依赖项

现在，您可以将所需的依赖项添加到项目中。假设我们要添加异常处理库cpprestsdk，可以使用以下命令：

.\vcpkg install cpprestsdk:x64-windows

注意：如果您使用的是Linux / macOS，请将上面的“x64-windows”替换为您的架构（x64-linux / x64-osx）。

然后，在Clion中打开CMakeLists.txt文件，并添加以下代码：

find_package(cpprestsdk CONFIG REQUIRED)
target_link_libraries(<your_project_name> PRIVATE Microsoft::cpprestsdk::cpprest)

注意：需要将上面的替换为您的项目名称。

这将告诉CMake在使用vcpkg安装cpprestsdk后查找并链接它。

示例

示例1：

假设您正在编写一个使用WebSocket的简单客户端，需要cpprestsdk来管理其WebSocket连接。首先，请按照上面的说明安装vcpkg和cpprestsdk，并将以下代码添加到项目的源文件中：

#include <cpprest/ws_client.h>
#include <iostream>

using namespace utility;
using namespace web::websockets::client;

int main()
{
    websocket_client client;

    client.connect("wss://echo.websocket.org/")
        .wait()
        .receive()
        .then([](websocket_incoming_message msg) {
            return msg.extract_string();
        })
        .then([](std::string body) {
            std::cout << "Received message: " << body << std::endl;
        })
        .wait();

    return 0;
}

接下来，在CMakeLists.txt文件中添加以下代码：

find_package(cpprestsdk CONFIG REQUIRED)
add_executable(exe main.cpp)
target_link_libraries(exe PRIVATE Microsoft::cpprestsdk::cpprest)

您现在可以使用Clion构建并运行该示例，它将连接到WebSocket并获得回显消息。

示例2：

假设您正在编写一个使用Boost库的应用程序。首先，您需要使用以下命令在vcpkg中安装Boost：

.\vcpkg install boost:x64-windows

接下来，在CMakeLists.txt文件中添加以下代码：

set(VCPKG_TARGET_TRIPLET "x64-windows" CACHE STRING "")
set(CMAKE_TOOLCHAIN_FILE <vcpkg_root_directory>/scripts/buildsystems/vcpkg.cmake CACHE STRING "")
find_package(Boost COMPONENTS <list_of_components> REQUIRED)
add_executable(exe main.cpp)
target_link_libraries(exe PRIVATE ${Boost_LIBRARIES})

需要将上面的“”替换为您想要使用的Boost库的列表。例如，如果您想使用Boost.Filesystem和Boost.System库，则应将其替换为“filesystem;system”。

您现在可以使用Clion构建并运行该示例，它将使用您安装的Boost库来完成其工作。

总结

这是Clion和vcpkg集成的一个简单示例。通过使用这种方法，管理库和依赖项将变得更加容易，并可以更轻松地构建和部署项目。