如何通过CMake拉取、构建libpng-android并导入为导入库？

你遇到的核心问题是：libpng-android并非CMake项目（它依赖ndk-build脚本），所以FetchContent_Declare里的BUILD_COMMAND和后续的add_subdirectory都不会按预期工作——add_subdirectory仅处理带有CMakeLists.txt的项目，和ndk-build的构建逻辑完全不兼容。

下面是一套可行的解决方案，核心思路是：用FetchContent下载源码，手动调用ndk-build完成编译，最后把编译产物包装成CMake的导入目标供你的项目使用。

步骤1：用FetchContent拉取源码 #

首先用FetchContent获取libpng-android的源码，这里不需要设置BUILD_COMMAND，因为我们会手动处理构建流程：

FetchContent_Declare(
    png
    GIT_REPOSITORY https://github.com/julienr/libpng-android.git
    GIT_TAG master
    UPDATE_DISCONNECTED TRUE
)

FetchContent_GetProperties(png)
if (NOT png_POPULATED)
    FetchContent_Populate(png)
endif()

步骤2：手动执行ndk-build编译 #

接下来调用ndk-build命令编译库。注意Android CMake构建是针对单个ABI的，所以要利用CMAKE_ANDROID_ABI变量指定目标架构，同时配置ndk-build需要的核心参数：

# 配置ndk-build命令参数
set(NDK_BUILD_CMD "${NDK_PATH}/ndk-build.cmd"
    NDK_PROJECT_PATH="${png_SOURCE_DIR}"
    APP_BUILD_SCRIPT="${png_SOURCE_DIR}/Android.mk"
    APP_ABI="${CMAKE_ANDROID_ABI}"
    APP_PLATFORM="${CMAKE_ANDROID_PLATFORM}"
    NDK_LIBS_OUT="${png_BINARY_DIR}/libs"
    NDK_OUT="${png_BINARY_DIR}/obj"
)

# 执行ndk-build命令
execute_process(
    COMMAND ${NDK_BUILD_CMD}
    WORKING_DIRECTORY "${png_SOURCE_DIR}"
    RESULT_VARIABLE NDK_BUILD_RESULT
)

# 检查编译是否成功，失败则终止构建
if(NOT NDK_BUILD_RESULT EQUAL 0)
    message(FATAL_ERROR "ndk-build执行失败，返回码：${NDK_BUILD_RESULT}")
endif()

参数说明：

• APP_BUILD_SCRIPT：明确指定Android.mk的路径，确保ndk-build能找到正确的构建脚本
• APP_ABI：和当前CMake构建的ABI保持一致，避免生成不匹配的架构库
• NDK_LIBS_OUT/NDK_OUT：指定编译产物的输出目录，统一放到FetchContent的binary目录下，方便后续查找

步骤3：将编译好的库导入为CMake目标 #

编译完成后，把生成的库文件包装成CMake的导入目标，这样你的项目就能正常链接它：

# 定位编译后的静态库（如果需要动态库，改为libpng.so即可）
set(PNG_LIB_PATH "${png_BINARY_DIR}/libs/${CMAKE_ANDROID_ABI}/libpng.a")

# 创建导入库目标
add_library(png STATIC IMPORTED GLOBAL)
set_target_properties(png PROPERTIES
    IMPORTED_LOCATION "${PNG_LIB_PATH}"
    INTERFACE_INCLUDE_DIRECTORIES "${png_SOURCE_DIR}"
)

步骤4：在你的项目中链接该库 #

最后，在你的Android C++库目标中，直接链接这个导入的png库即可：

add_library(your_android_lib SHARED your_source_files.cpp)
target_link_libraries(your_android_lib PRIVATE png)

额外注意事项 #

• 确保NDK_PATH变量正确指向你的Android NDK根目录，你可以在CMake配置时通过-DNDK_PATH=/path/to/ndk传入，或者利用Android Studio自动设置的CMAKE_ANDROID_NDK变量替代
• 如果使用动态库，需要把add_library的类型从STATIC改为SHARED，同时修改库文件路径
• 可以给你的目标添加BUILD_BYPRODUCTS属性，让CMake明确依赖ndk-build的输出：set_property(TARGET your_android_lib PROPERTY BUILD_BYPRODUCTS "${PNG_LIB_PATH}")

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