Ubuntu22.04下CMake FetchContent引入WebKitGTK报错：找不到WebKitCommon

核心问题说明 #

WebKitGTK的CMake构建体系依赖自身内部模块（如WebKitCommon）和自定义命令（如WEBKIT_FRAMEWORK_DECLARE），这些内容不会自动暴露给外部项目的find_package调用。直接混用find_package(webkit2)和FetchContent会因上下文不匹配触发错误，正确做法是通过FetchContent完整构建WebKitGTK子项目，再直接链接其提供的编译目标。

正确CMakeLists.txt配置示例 #

cmake_minimum_required(VERSION 3.22)
project(YourProjectName)

# 启用FetchContent模块
include(FetchContent)

# 声明并配置WebKitGTK 2.42.3的下载源
FetchContent_Declare(
    webkitgtk
    URL https://webkitgtk.org/releases/webkitgtk-2.42.3.tar.xz
    URL_HASH SHA256=替换为对应版本的SHA256哈希值 # 可从WebKitGTK官方下载页获取校验值
)

# 触发WebKitGTK的下载、配置与构建流程
FetchContent_MakeAvailable(webkitgtk)

# 定义你的项目可执行文件
add_executable(your_app main.cpp)

# 直接链接WebKitGTK导出的官方目标
target_link_libraries(your_app PRIVATE WebKit2GTK::WebKit2)

关键注意事项 #

• 禁止混用find_package与FetchContent：FetchContent构建的WebKitGTK是作为子项目集成的，无需再调用find_package(webkit2)，直接使用其导出的WebKit2GTK::WebKit2目标即可。
• 提前安装编译依赖：Ubuntu 22.04下需先安装WebKitGTK的编译依赖包，执行命令：

  sudo apt-get install build-essential cmake libgtk-3-dev libsoup3.0-dev libjavascriptcoregtk-4.0-dev libxml2-dev libxslt1-dev libsqlite3-dev libharfbuzz-dev libwoff-dev libpng-dev libjpeg-dev libgif-dev libwebp-dev libsecret-dev libgcrypt20-dev libnotify-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
  

• 添加哈希校验：URL_HASH参数用于验证下载包的完整性，避免源码被篡改，务必替换为对应版本的官方SHA256值。
• 满足CMake版本要求：WebKitGTK 2.42.3需要CMake 3.22及以上版本，Ubuntu 22.04默认CMake版本刚好符合要求。

错误原因补充 #

你遇到的无法找到WebKitCommon文件，是因为WebKitGTK的内部CMake模块不在外部项目的CMAKE_MODULE_PATH中；WEBKIT_FRAMEWORK_DECLARE是未知CMake命令，是因为该命令是WebKit自身CMake脚本定义的，仅在WebKit的构建上下文内有效，外部项目直接调用find_package无法识别。

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