Android编译mintct Native代码时出现未定义符号错误求助

核心问题分析 #

从编译日志可见，链接器找不到get_minutiae、free_minutiae等符号，且提示符号存在下划线前缀（如_read_and_decode_grayscale_image），这说明：

1. 你当前使用的${NBIS_DIR}/exports/lib下的静态库是Mac平台编译产物，与Android的交叉编译环境ABI不兼容，符号命名规则不匹配；
2. 代码编译时可能触发了C++名称修饰（name mangling），导致与C语言编写的NBIS库符号无法匹配。

修复步骤 #

1. 针对Android交叉编译NBIS库 #

必须使用Android NDK工具链重新编译NBIS，生成对应ABI的静态库。以x86_64为例，创建编译脚本：

export NDK_PATH=/Users/amanda/Library/Android/sdk/ndk/23.1.7779620
export TOOLCHAIN=$NDK_PATH/toolchains/llvm/prebuilt/darwin-x86_64
export TARGET=x86_64-none-linux-android24
export CC=$TOOLCHAIN/bin/$TARGET-clang
export CXX=$TOOLCHAIN/bin/$TARGET-clang++
export AR=$TOOLCHAIN/bin/$TARGET-ar
export LD=$TOOLCHAIN/bin/$TARGET-ld
export RANLIB=$TOOLCHAIN/bin/$TARGET-ranlib
export STRIP=$TOOLCHAIN/bin/$TARGET-strip

cd NBIS_5.0
mkdir -p build-android-x86_64
cd build-android-x86_64
../configure --host=x86_64-none-linux-android --prefix=$(pwd)/output
make -j$(nproc)
make install

编译完成后，build-android-x86_64/output/lib下会生成Android兼容的静态库，替换原${NBIS_DIR}/exports/lib中的文件。如需支持多ABI（armeabi-v7a、arm64-v8a等），需为每个ABI重复上述步骤。

2. 调整CMake配置 #

移除Mac专属的头文件路径，修正库依赖顺序：

cmake_minimum_required (VERSION 3.19) # 更新到3.19+解决版本警告
project (mindtct)
set(CMAKE_VERBOSE_MAKEFILE ON)
SET(MINDTCT_DIR ${CMAKE_SOURCE_DIR}/mintct-android)
# 替换为交叉编译后的NBIS输出路径
SET(NBIS_DIR ${CMAKE_SOURCE_DIR}/NBIS_5.0/build-android-x86_64/output)

include_directories("${NBIS_DIR}/include"
        "${NBIS_DIR}/include/mindtct"
        "${MINDTCT_DIR}")
link_directories("${NBIS_DIR}/lib")

FIND_PACKAGE(SWIG REQUIRED)
INCLUDE(${SWIG_USE_FILE})
SET(CMAKE_SWIG_FLAGS -package    "com.bah.biometrics")

# 强制用C语言编译，避免C++名称修饰
set_source_files_properties(./mintct-android/mindtct.i PROPERTIES CPLUSPLUS OFF)
SWIG_ADD_LIBRARY(libmindtct TYPE SHARED LANGUAGE JAVA SOURCES ./mintct-android/mindtct.i ./mintct-android/mindtct.c)

# 调整链接顺序，依赖库放在后方
SWIG_LINK_LIBRARIES(libmindtct mindtct image an2k openjp2 ihead jpegb jpegl
    wsq png fet ioutil util z m)

3. 确保C符号可见性 #

在mindtct.c的开头和末尾添加如下代码，强制C语言符号规则：

#ifdef __cplusplus
extern "C" {
#endif

// 原文件代码

#ifdef __cplusplus
}
#endif

额外注意事项 #

• 若需支持多ABI，需为每个ABI编译对应的NBIS库，并在Android Studio的build.gradle中配置abiFilters指定目标架构；
• 更新CMake到3.19及以上版本，解决日志中的版本兼容性警告。

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