将OpenCV编译进静态库后出现函数缺失问题

核心问题原因 #

静态库与动态库的链接逻辑不同：动态库会在运行时加载依赖符号，而静态库仅记录符号引用，不会自动合并依赖库的代码。你之前手动指定OpenCV framework路径的方式，没有正确处理OpenCV内部的模块依赖（比如medianBlur属于imgproc模块，还依赖core等底层模块），导致最终应用链接时无法找到完整的符号定义。

修复步骤 #

1. 改用CMake官方的find_package导入OpenCV

OpenCV的交叉编译脚本（build_framework.py/build_sdk.py）会生成标准的CMake配置文件，用find_package可以自动识别所有依赖模块，避免手动链接遗漏。

2. 修改CMakeLists.txt（分平台适配）

iOS平台版本

cmake_minimum_required(VERSION 3.0)

set(CMAKE_TOOLCHAIN_FILE ios.toolchain.cmake) 

project(mylibrary)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_EXTENSIONS OFF)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 指向OpenCV framework内的CMake配置文件路径
set(OpenCV_DIR ${CMAKE_CURRENT_LIST_DIR}/opencv/opencv/build/ios/opencv2.framework/Resources/cmake)
# 自动导入OpenCV所有依赖模块
find_package(OpenCV REQUIRED)

# 查找源文件
file(GLOB_RECURSE SOURCE_C "src/*.c")
file(GLOB_RECURSE SOURCE_CPP "src/*.cpp")
file(GLOB_RECURSE HEADER_H "src/*.h")
file(GLOB_RECURSE HEADER_HPP "src/*.hpp")

add_library(${PROJECT_NAME} STATIC
  ${SOURCE_C}
  ${SOURCE_CPP}
  ${HEADER_H}
  ${HEADER_HPP}
)

# 链接OpenCV的所有依赖库
target_link_libraries(${PROJECT_NAME} PRIVATE ${OpenCV_LIBS})

# 源文件分组（可选）
source_group("Header include" FILES ${HEADER_H} ${HEADER_HPP})
source_group("Source src" FILES ${SOURCE_C} ${SOURCE_CPP})

Android平台版本

cmake_minimum_required(VERSION 3.0)

set(CMAKE_TOOLCHAIN_FILE android.toolchain.cmake) 

project(mylibrary)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_EXTENSIONS OFF)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 指向Android OpenCV SDK的JNI配置路径
set(OpenCV_DIR ${CMAKE_CURRENT_LIST_DIR}/opencv/opencv/build/android/sdk/native/jni)
find_package(OpenCV REQUIRED)

# 查找源文件
file(GLOB_RECURSE SOURCE_C "src/*.c")
file(GLOB_RECURSE SOURCE_CPP "src/*.cpp")
file(GLOB_RECURSE HEADER_H "src/*.h")
file(GLOB_RECURSE HEADER_HPP "src/*.hpp")

add_library(${PROJECT_NAME} STATIC
  ${SOURCE_C}
  ${SOURCE_CPP}
  ${HEADER_H}
  ${HEADER_HPP}
)

target_link_libraries(${PROJECT_NAME} PRIVATE ${OpenCV_LIBS})

# 源文件分组（可选）
source_group("Header include" FILES ${HEADER_H} ${HEADER_HPP})
source_group("Source src" FILES ${SOURCE_C} ${SOURCE_CPP})

3. 关于静态库符号的说明

修改后用nm mylibrary.a | grep medianBlur仍然会看到U标记，这是正常的——静态库仅保存符号引用，不会将OpenCV的代码合并进来。最终应用侧构建时，只要在应用的CMakeLists.txt中同时导入你的库和OpenCV配置，CMake会自动链接所有依赖的静态库，符号未定义的错误就会消失。

（可选）将OpenCV代码合并到你的静态库中

如果希望把OpenCV的代码直接嵌入你的静态库（避免应用侧再链接OpenCV），可以添加链接器强制加载选项：

• iOS：target_link_libraries(${PROJECT_NAME} PRIVATE -Wl,-force_load,${OpenCV_LIBS})
• Android：target_link_libraries(${PROJECT_NAME} PRIVATE -Wl,--whole-archive ${OpenCV_LIBS} -Wl,--no-whole-archive)

注意：这种方式会显著增大你的静态库体积，且可能引发符号冲突，仅在特殊场景下使用。

验证步骤 #

1. 清空之前的构建目录，重新运行CMake生成构建文件
2. 编译你的静态库
3. 在应用的CMakeLists.txt中导入你的库和OpenCV配置，链接你的库后重新构建应用

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