C++17项目用CMake添加GTK4依赖遇peel包查找错误求解决方案

我正在学习C++17，尝试编写修改矩阵并通过GTK库展示的代码，但不知如何添加GTK这类外部依赖。我使用CMake管理项目，已修改CMakeLists.txt，通过brew在Mac上安装了GTK4，但构建时出现peel包找不到的错误。我不清楚如何正确链接依赖，也缺乏保证项目可移植性的最佳实践经验。

相关CMakeLists.txt代码 #

cmake_minimum_required(VERSION 3.15)

project(tacforge)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

enable_testing()

include(FetchContent)
FetchContent_Declare(
googletest
URL https://github.com/google/googletest/archive/refs/tags/v1.14.0.zip
)
FetchContent_MakeAvailable(googletest)

find_package (PkgConfig REQUIRED)
pkg_check_modules (gtk4 REQUIRED IMPORTED_TARGET gtk4)

find_package (peel REQUIRED)
peel_generate (Gtk 4.0 RECURSIVE)

构建错误信息 #

-- Checking for module 'gtk4'
--   Found gtk4, version 4.22.4

CMake Error at CMakeLists.txt:20 (find_package):
  By not providing "Findpeel.cmake" in CMAKE_MODULE_PATH this project has
  asked CMake to find a package configuration file provided by "peel", but
  CMake did not find one.

  Could not find a package configuration file provided by "peel" with any of
  the following names:

peel.cps
peelConfig.cmake
peel-config.cmake

  Add the installation prefix of "peel" to CMAKE_PREFIX_PATH or set
  "peel_DIR" to a directory containing one of the above files.  If "peel"
  provides a separate development package or SDK, be sure it has been
  installed.

1. 解决peel包未找到的问题 #

peel是用于GTK的C++绑定生成工具，你大概率未安装它：

• 优先尝试用brew安装：

brew install peel

• 若brew仓库无peel，需从源码编译安装：
  1. 克隆peel仓库到本地
  2. 进入仓库目录执行：cmake -B build && cmake --build build && sudo cmake --install build
  3. 安装完成后CMake即可自动识别peel配置文件

2. 正确链接GTK4依赖 #

找到GTK4后，需在CMake中为编译目标添加链接规则，示例：

# 替换为你的实际源文件列表
add_executable(tacforge main.cpp matrix_editor.cpp gtk_display.cpp)
# 链接GTK4依赖
target_link_libraries(tacforge PRIVATE PkgConfig::gtk4)

3. 项目可移植性最佳实践 #

• 优先用pkg_check_modules处理GTK这类跨平台依赖，兼容性更强
• 对peel这类非标准包，用FetchContent自动拉取源码构建，避免用户手动安装：

include(FetchContent)
FetchContent_Declare(
  peel
  GIT_REPOSITORY https://github.com/peel/peel.git
  GIT_TAG v1.0.0 # 替换为稳定版本标签
)
FetchContent_MakeAvailable(peel)

• 不要硬编码依赖路径，让CMake自动查找
• 添加依赖版本检查，确保环境满足要求：

pkg_check_modules(gtk4 REQUIRED IMPORTED_TARGET gtk4>=4.0)

内容的提问来源于stack exchange，提问作者chipauris