MediaPipe项目构建Android AAR包的技术实践

在Android平台上使用MediaPipe进行机器学习模型部署时，开发者经常需要将自定义的计算图(Graph)打包成AAR(Android Archive)格式。本文针对MediaPipe 0.10.21版本中构建AAR包的方法变更进行技术解析，并提供完整的解决方案。

背景与问题

MediaPipe项目在近期版本更新中进行了构建系统的重构，原先用于构建AAR的mediapipe_aar.bzl脚本被合并到了mediapipe_tasks_aar.bzl中。这一变更导致开发者无法直接使用原有的mediapipe_aar()函数来构建自定义计算图的AAR包。

解决方案

目前有两种可行的技术方案：

方案一：使用新的构建函数

MediaPipe项目提供了新的构建函数mediapipe_build_aar_with_jni，该函数位于mediapipe_tasks_aar.bzl中。使用示例如下：

load("//mediapipe/tasks/java/com/google/mediapipe/tasks:mediapipe_tasks_aar.bzl", "mediapipe_build_aar_with_jni")

mediapipe_build_aar_with_jni(
    name = "custom_aar",
    srcs = ["CustomCalculator.java"],
    native_library = ":custom_jni_lib",
    manifest = "AndroidManifest.xml",
    proguard_spec = "proguard.pgcfg",
    deps = [
        "//mediapipe/java/com/google/mediapipe/framework:android_framework",
    ],
)

方案二：恢复旧版构建脚本

考虑到兼容性问题，MediaPipe项目团队已临时恢复了mediapipe_aar.bzl脚本。开发者可以同步到特定提交来使用原有的构建方式。

技术实现细节

无论采用哪种方案，构建AAR包时都需要注意以下关键点：

1. JNI库配置：必须正确配置native_library参数，指向对应的JNI库目标
2. Android清单文件：需要提供完整的AndroidManifest.xml
3. 混淆配置：建议提供Proguard规则文件以保证代码优化和混淆
4. 依赖管理：确保包含所有必要的MediaPipe框架依赖

最佳实践建议

1. 对于新项目，建议优先使用mediapipe_build_aar_with_jni函数
2. 对于已有项目迁移，可以先采用恢复的mediapipe_aar.bzl进行过渡
3. 构建前确保环境配置正确，包括：
   • Android SDK和NDK版本兼容
   • Bazel构建系统版本要求
   • 必要的系统依赖安装

总结

MediaPipe项目在不断演进过程中，构建系统也在持续优化。开发者需要关注这些变更，及时调整自己的构建配置。本文介绍的两种方案都能有效解决AAR包构建问题，开发者可以根据项目实际情况选择最适合的方式。

随着MediaPipe生态的成熟，建议开发者逐步迁移到新的构建系统，以获得更好的维护性和新特性支持。