CXX_LIB

本仓库存储着使用 MSVC 工具链编译构建的常见 C++ 三方库。

版本：Visual Studio Community 2022 (64 位) 17.11.3。

编译器工具集：v14。

Visual Studio 版本之间的 C++ 存在二进制兼容性，自 Visual Studio 2015 到 2022。

Tip

说是说有二进制兼容，不过也别太指望我构建的库你一定能用，尤其其中还存在许多静态库，那则更是不可能，

如果你是纯萌新还没有 Visual Studio，参考：MSVC-setup.md

快速安装

直接下载 Setup-CXX_LIB 脚本然后执行，即可自动配置。

windows 默认不开启执行脚本权限，需要以管理员身份运行 Set-ExecutionPolicy Unrestricted -Scope CurrentUser 命令设置。

为了考虑大多数人的环境是 windows 中国大陆区域，即 chcp 936，我们将脚本存储为 gb2312 的编码，以让大多数人能直接运行。如果你和我一样是全局 utf-8 记得修改脚本编码。

普通安装

Tip

如果你做了上一步快速安装，则无需看这一节。

引入库十分的简单，将仓库克隆到本地：

git clone https://github.com/Mq-b/CXX_LIB

然后定义变量 CMAKE_PREFIX_PATH ，值为仓库的路径，它是用来设置 CMake 查找包路径的。

Tip

建议将该变量定义在全局环境中，而非 CMakeLists.txt 文件中。这种方式更通用，便于开发者根据需要自行决定库的路径，避免硬编码路径的问题（例如和同事共享）。

可以定义在全局环境变量，或者是在 CMakeList.txt 中定义：

set(CMAKE_PREFIX_PATH "D:/CXX_LIB" CACHE STRING "自定义查找包的安装路径" FORCE)

定义环境变量查看是否生效：

PS C:\Users\A1387> $env:CMAKE_PREFIX_PATH
D:/CXX_LIB

做好这一步之后就可以直接在自己仓库随便的引入库了：

在项目中引入库

find_package(SFML 2.6.1 COMPONENTS system window graphics audio network REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE sfml-system sfml-window sfml-graphics sfml-audio sfml-network)

find_package(fmt CONFIG REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE fmt::fmt-header-only)

find_package(TBB REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE TBB::tbb)

# 无法处理 Debug 这是库本身的问题
find_package(cpp-terminal REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE cpp-terminal::cpp-terminal)

find_package(spdlog REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE spdlog::spdlog_header_only)

find_package(nlohmann_json 3.2.0 REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE nlohmann_json::nlohmann_json)

find_package(GTest REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE GTest::GTest)

find_package(benchmark REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE benchmark::benchmark)

find_package(absl REQUIRED)
target_link_libraries(${PROJECT_NAME} PRIVATE absl::strings absl::int128)

有些库还需设置 bin 环境变量或者直接将 dll 复制过来，因为是动态链接库，这不是 CMake 管理的。

相关库介绍

• cpp-terminal

  用于构建跨平台的终端应用程序，支持终端输入输出控制（如颜色、光标控制，终端绘制图形）。

  特点：现代 C++ 风格，简单易用，适用于需要与终端交互的应用。

• FTXUI

  用于构建跨平台终端用户界面的现代 C++ 库。

  特点：提供丰富的控件和布局管理，支持动画和事件处理，适用于需要图形化终端界面的应用且无任何依赖。

Tip

除了 sfml，所有库都是本人自行源码编译构建。