CMake通过ExternalProject_Add构建链接libdatachannel的技术问题

问题1：构建libdatachannel的datachannel-static目标 #

默认ExternalProject_Add仅构建标记为ALL的目标，而datachannel-static被EXCLUDE_FROM_ALL排除在默认构建范围外。需显式指定构建目标，修改ExternalProject_Add配置：

ExternalProject_Add(libdatachannel
    GIT_REPOSITORY      git@github.com:paullouisageneau/libdatachannel.git
    GIT_TAG             v0.18.0
    GIT_PROGRESS        TRUE
    GIT_SHALLOW         TRUE
    # 显式指定构建datachannel-static目标，兼容多配置（Debug/Release）
    BUILD_COMMAND       ${CMAKE_COMMAND} --build . --target datachannel-static --config $<CONFIG>
    # 可选：指定安装目录，为后续导入导出目标做准备
    INSTALL_DIR         ${CMAKE_CURRENT_BINARY_DIR}/libdatachannel_install
    INSTALL_COMMAND     ${CMAKE_COMMAND} --install . --config $<CONFIG> --prefix ${CMAKE_CURRENT_BINARY_DIR}/libdatachannel_install
)

此配置会强制构建datachannel-static及其依赖目标。

问题2：为test库设置头文件路径并链接静态库 #

可通过ExternalProject_Get_Property获取libdatachannel的路径信息，再配置头文件包含与库链接：

# 获取libdatachannel的源码目录与安装目录
ExternalProject_Get_Property(libdatachannel SOURCE_DIR INSTALL_DIR)

# 为test库添加头文件包含路径
target_include_directories(test
    PRIVATE
    ${SOURCE_DIR}/include  # 源码中的头文件目录（未安装时可用）
    ${INSTALL_DIR}/include # 安装后的头文件目录（更稳定）
)

# 链接静态库，根据Android ABI与构建配置调整路径
target_link_libraries(test
    PRIVATE
    ${INSTALL_DIR}/lib/${CMAKE_ANDROID_ARCH_ABI}/libdatachannel.a
)

若未设置INSTALL_DIR，也可直接从libdatachannel的构建目录取静态库（如${SOURCE_DIR}/build/libdatachannel.a），但安装到指定目录更适配多ABI场景。

问题3：Android环境下使用LibDataChannel导出目标 #

Android Gradle调用CMake时，ExternalProject_Add构建的库不会自动将导出目标导入主项目，需通过find_package手动导入，步骤如下：

1. 调整libdatachannel的ExternalProject配置 #

确保传递Android构建参数并指定安装目录，保证导出目标正确生成：

ExternalProject_Add(libdatachannel
    GIT_REPOSITORY      git@github.com:paullouisageneau/libdatachannel.git
    GIT_TAG             v0.18.0
    GIT_PROGRESS        TRUE
    GIT_SHALLOW         TRUE
    # 传递与主项目一致的Android构建参数
    CMAKE_ARGS
        -DCMAKE_SYSTEM_NAME=Android
        -DCMAKE_ANDROID_ARCH_ABI=${CMAKE_ANDROID_ARCH_ABI}
        -DCMAKE_ANDROID_NDK=${CMAKE_ANDROID_NDK}
        -DCMAKE_BUILD_TYPE=${CMAKE_BUILD_TYPE}
        -DCMAKE_INSTALL_PREFIX=${CMAKE_CURRENT_BINARY_DIR}/libdatachannel_install/${CMAKE_ANDROID_ARCH_ABI}
        -DUSE_STATIC_LIBS=ON # 显式启用静态库导出
    BUILD_COMMAND       ${CMAKE_COMMAND} --build . --target datachannel-static --config ${CMAKE_BUILD_TYPE}
    INSTALL_COMMAND     ${CMAKE_COMMAND} --install . --config ${CMAKE_BUILD_TYPE}
)

2. 在主项目中导入并使用导出目标 #

需等待libdatachannel安装完成后，通过find_package定位导出配置，再链接目标：

add_dependencies(test libdatachannel)

# 获取安装目录并导入LibDataChannel导出目标
ExternalProject_Get_Property(libdatachannel INSTALL_DIR)
find_package(LibDataChannel REQUIRED PATHS ${INSTALL_DIR}/lib/cmake/LibDataChannel)

# 链接静态导出目标
target_link_libraries(test PRIVATE LibDataChannel::LibDataChannelStatic)

补充Gradle配置 #

确保Gradle传递正确的ABI参数，避免多ABI冲突：

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
                arguments "-DCMAKE_BUILD_TYPE=Release"
            }
        }
    }
}

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