Android NDK 项目中 Prefab 模块的使用指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01069/article/details/148415895

Android NDK 项目中 Prefab 模块的使用指南

ndk-samples 项目地址: https://gitcode.com/gh_mirrors/ndks/ndk-samples

前言

在 Android 开发中，当我们需要在项目中集成 C/C++ 代码时，传统的方式往往需要手动配置 NDK 编译选项、处理头文件路径和库文件链接等复杂操作。Android Gradle Plugin 4.0 引入的 Prefab 功能极大地简化了这一过程，使得 C/C++ 依赖的管理变得和 Java 依赖一样简单。

什么是 Prefab

Prefab 是 Android 平台上用于打包和分发 C/C++ 库的一种标准化格式。它允许开发者将原生库（包括头文件和共享库/静态库）打包到 AAR 文件中，并通过 Gradle 依赖系统进行分发和管理。

Prefab 的主要优势包括：

简化原生依赖管理流程
自动处理头文件路径和库链接
支持版本管理和依赖传递
与现有 Gradle 构建系统无缝集成

Prefab 的基本使用

环境要求

要使用 Prefab 功能，需要满足以下条件：

Android Gradle Plugin 4.0+（消费依赖）
Android Gradle Plugin 4.1+（发布依赖）
最新版本的 Android NDK

消费 Prefab 依赖

在项目中消费 Prefab 依赖的步骤如下：

在模块的 build.gradle 文件中启用 Prefab 功能：

android {
    buildFeatures {
        prefab true
    }
}

添加依赖项：

dependencies {
    implementation 'com.example:native-library:1.0'
}

在 CMakeLists.txt 中导入依赖：

find_package(native-library REQUIRED CONFIG)

target_link_libraries(my-lib
    native-library::native-lib
)

发布 Prefab 依赖

如果你需要将自己的 C/C++ 库打包为 Prefab 格式供其他项目使用，可以按照以下步骤操作：

在模块的 build.gradle 文件中启用 Prefab 发布功能：

android {
    buildFeatures {
        prefabPublishing true
    }
    
    prefab {
        mylibrary {
            headers "src/main/cpp/include"
            libraryName "mylibrary"
        }
    }
}

配置要导出的库和头文件路径

实际应用示例

使用第三方 Prefab 库

以使用 curl 和 ssl 库为例，首先在 build.gradle 中添加依赖：

dependencies {
    implementation "com.android.ndk.thirdparty:curl:1.0.0"
    implementation "com.android.ndk.thirdparty:openssl:1.0.0"
}

然后在 CMakeLists.txt 中链接这些库：

find_package(curl REQUIRED CONFIG)
find_package(ssl REQUIRED CONFIG)

target_link_libraries(native-lib
    curl::curl
    ssl::ssl
)

创建自己的 Prefab 库

假设我们有一个名为 "mathlib" 的数学运算库需要打包：

配置 build.gradle：

android {
    buildFeatures {
        prefabPublishing true
    }
    
    prefab {
        mathlib {
            headers "src/main/cpp/include"
            libraryName "mathlib"
        }
    }
}

确保头文件放置在 src/main/cpp/include 目录下
构建项目后，生成的 AAR 文件将包含 Prefab 格式的原生库

常见问题与解决方案

依赖解析问题：在 Android Studio 中，当前项目的一个模块无法直接依赖另一个模块生成的 Prefab AAR。解决方法是将生成的 AAR 发布到本地或远程 Maven 仓库，然后作为外部依赖引入。
版本兼容性问题：确保所有模块使用相同版本的 Android Gradle Plugin 和 NDK，以避免兼容性问题。
头文件找不到：检查 prefab 配置中的 headers 路径是否正确，以及是否在 CMakeLists.txt 中正确导入了包。