交叉编译OpenCV至Aarch64平台遇GTK支持缺失运行错误求助

核心原因 #

交叉编译过程中，CMake无法找到aarch64架构的GTK依赖库，导致highgui模块的GUI后端未被编译进库中，最终在目标平台调用imshow等函数时抛出异常。

具体解决步骤 #

1. 安装aarch64架构的GTK交叉编译依赖 #

在x86主机上，以Debian/Ubuntu系为例，安装对应arm64架构的GTK开发包：

# 添加arm64架构支持
sudo dpkg --add-architecture arm64
# 更新软件源
sudo apt update
# 安装GTK3及相关依赖（若需GTK2则替换为libgtk2.0-dev:arm64）
sudo apt install libgtk-3-dev:arm64 libglib2.0-dev:arm64 libpango1.0-dev:arm64 libcairo2-dev:arm64 libgdk-pixbuf-2.0-dev:arm64

2. 检查并修正交叉编译工具链文件 #

确保你的aarch64-gnu.toolchain.cmake文件包含以下关键配置，保证CMake优先查找aarch64架构的依赖：

set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR aarch64)

# 指定交叉编译工具链前缀
set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc)
set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g++)

# 强制CMake在交叉编译根目录查找依赖，忽略主机x86库
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

# 设置交叉编译根目录（对应你安装aarch64库的路径）
set(CMAKE_FIND_ROOT_PATH /usr/aarch64-linux-gnu)

3. 清理缓存并重新配置CMake #

先删除build目录下的旧缓存文件，避免残留配置干扰：

cd your_opencv_build_dir
rm -rf CMakeCache.txt CMakeFiles

然后重新运行CMake命令，直接指定启用GTK（比HIGHGUI_PLUGIN_LIST=all更精准）：

cmake -DWITH_GTK=ON -DWITH_FFMPEG=ON -DCMAKE_INSTALL_PREFIX=/usr/aarch64-linux-gnu -DCMAKE_TOOLCHAIN_FILE=../aarch64-gnu.toolchain.cmake ..

4. 验证CMake配置结果 #

运行CMake后，重点查看输出中的GTK相关日志，确认以下类似内容：

-- Checking for module 'gtk+-3.0'
--   Found gtk+-3.0, version 3.24.33
-- GTK3: YES

如果仍显示GTK3: NO，查看日志中具体的缺失依赖项，安装对应的aarch64开发包即可。

5. 备选方案：禁用GUI功能（若无需显示窗口） #

如果你的程序不需要调用imshow、namedWindow等GUI相关函数，可以直接禁用GTK依赖，避免编译和运行报错：

cmake -DWITH_GTK=OFF -DWITH_FFMPEG=ON -DCMAKE_INSTALL_PREFIX=/usr/aarch64-linux-gnu -DCMAKE_TOOLCHAIN_FILE=../aarch64-gnu.toolchain.cmake ..

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