Android 系统源码集成三方 SO库-三亩地-编程学习日记

1. 概述

本手册提供在 Android 系统源码环境下集成第三方 SO 动态链接库（如 WebRTC 的libjingle_peerconnection_so.so）以及将应用编译为系统特权应用的标准流程。涵盖了 Makefile 配置、权限预置、JNI 目录结构、Android.bp 定义及部署调试等核心步骤。

2. 适用场景

系统集成：需要将第三方 SDK（如 WebRTC, 语音 SDK, 安全 SDK 等）深度集成到 Android 系统源码中。
系统应用开发：应用需要具备系统级权限（如WRITE_SECURE_SETTINGS,REBOOT等）。
车载/嵌入式开发：在定制化硬件平台上进行应用预装和底层服务配置。

3. 前置条件

环境要求：具备 Android AOSP 或厂商定制系统源码编译环境（如 Ubuntu 20.04+）。
权限要求：拥有源码修改权限，以及对设备进行adb remount和adb push的调试权限。
依赖组件：第三方.so文件（对应架构：arm64-v8a, armeabi-v7a）及对应的.aar或.jar包。

4. 操作步骤

以下是Android系统源码集成第三方SO库及编译系统特权应用的完整流程图：

4.1 步骤一：配置系统编译包列表

在全局或厂商特定的 Makefile 中添加目标模块，确保系统编译时包含该应用及其依赖的 SO 库。

路径：vendor/xxx/common/packages.mk(以实际路径为准)
操作：在PRODUCT_PACKAGES列表中添加libjingle_peerconnection_so和应用模块名。

PRODUCT_PACKAGES += \ libjingle_peerconnection_so \ ...

4.2 步骤二：预置系统特权权限

如果应用需要执行敏感操作，必须在系统的白名单配置文件中声明。

路径：frameworks/base/data/etc/privapp-permissions-platform.xml
操作：根据包名添加所需的系统权限。

<privapp-permissionspackage="com.test.wifip2pconnect"><permissionname="android.permission.READ_PRIVILEGED_PHONE_STATE"/><permissionname="android.permission.MANAGE_USB"/></privapp-permissions>

4.3 步骤三：工程目录结构准备

在应用模块目录下建立正确的 JNI 和库文件结构。

JNI 目录：在src下创建jniLibs，并根据架构（arm64-v8a,armeabi-v7a）放入.so文件。
库文件目录：创建lib目录放入.aar文件（如google-webrtc-1.0.40794.aar）。
混淆配置：在proguard-rules.pro中保留第三方库包名，防止 SO 库调用失败。
```
-keep class org.webrtc.** { *; } -dontwarn org.webrtc.**
```

4.4 步骤四：编写 Android.bp 编译脚本

使用Android.bp定义 SO 库的预编译规则及应用的编译逻辑。

// 定义预编译 SO 库 cc_prebuilt_library_shared { name: "libjingle_peerconnection_so", arch: { arm: { srcs: ["src/jniLibs/armeabi-v7a/libjingle_peerconnection_so.so"] }, arm64: { srcs: ["src/jniLibs/arm64-v8a/libjingle_peerconnection_so.so"] }, }, check_elf_files: false, shared_libs: ["libEGL", "liblog"], } // 导入 AAR 库 android_library_import { name: "google-webrtc", aars: ["lib/google-webrtc-1.0.40794.aar"], } // 定义系统应用 android_app { name: "XXX", static_libs: ["google-webrtc"], jni_libs: ["libjingle_peerconnection_so"], ... }

4.5 步骤五：应用层初始化

在代码中显式初始化 WebRTC 环境及相关业务组件。

PeerConnectionFactory.initialize(PeerConnectionFactory.InitializationOptions.builder(MainActivity.this).createInitializationOptions());// 业务初始化WebRtcSenderwebRtcSender=newWebRtcSender();webRtcSender.init(MainActivity.this);

5. 参数说明

| 参数 | 说明 |

|------|------|

|PRODUCT_PACKAGES| Makefile 中定义的系统集成模块列表。 |

|cc_prebuilt_library_shared| Android.bp 中用于预编译.so文件的模块类型。 |

|jni_libs|android_app模块依赖的 JNI 共享库。 |

|privapp-permissions| 系统特权应用权限声明。 |

6. 输出说明

编译产物：编译后应用位于/system/priv-app/下。
SO 库位置：SO 库被打包进 APK 的lib/目录下或预装在/system/lib64/中。

7. 常见问题

Q: SO 库加载失败 (UnsatisfiedLinkError)？

A: 请检查Android.bp中的jni_libs是否正确包含模块名，并确认架构（armeabi-v7a/arm64-v8a）与设备 CPU 匹配。

Q: 系统权限不生效？

A: 确保 XML 路径正确，且应用已安装在system/priv-app目录下，普通安装在data/app下的特权权限无效。

8. 注意事项

调试提效：初次需全量编译系统包，后续小改动可使用adb remount后通过adb push将 APK 覆盖到/system/priv-app/快速验证。
ELF 校验：三方 SO 库常因依赖缺失无法通过编译期 ELF 校验，需在cc_prebuilt_library_shared中设置check_elf_files: false。

日记详情

Android 系统源码集成三方 SO库