1. Binder 专题18——添加 Java 系统服务在 Android 系统开发中Binder 作为进程间通信IPC的核心机制承载着系统服务与应用程序之间的交互重任。本专题将深入探讨如何在 Android 系统中添加一个 Java 层的系统服务涵盖从 AIDL 接口定义到服务注册的完整流程。对于需要扩展系统功能的开发者而言这是一项必备技能。2. 核心概念与准备工作2.1 Binder 机制回顾Binder 是 Android 特有的 IPC 机制其核心由以下组件构成Binder 驱动内核空间的桥梁负责实际的跨进程数据传输ServiceManager系统服务的注册中心类似 DNS 服务Proxy/Stub客户端和服务端的通信代理Java 层系统服务本质上是通过 JNI 封装了 Native 层的 Binder 实现。在 Android 8.0 之后系统引入了 Treble 项目进一步规范了 HAL 服务的 Binder 化。2.2 开发环境准备需要配置以下环境AOSP 源码环境建议使用最新稳定分支编译工具链source build/envsetup.sh lunch aosp_arm-eng # 根据实际设备选择开发目录结构frameworks/base/ ├── core/ ├── services/ │ ├── core/ │ ├── java/ │ └── ... └── ...注意建议使用 SSD 存储源码机械硬盘会导致编译时间显著延长3. 服务接口定义与实现3.1 创建 AIDL 接口在frameworks/base/core/java/android/os下新建IMyService.aidlpackage android.os; interface IMyService { int getVersion(); void setConfig(in Bundle config); Bundle executeCommand(String cmd); }AIDL 支持的数据类型包括基本类型int, long, boolean 等String, CharSequenceList, MapParcelable 对象其他 AIDL 接口3.2 实现服务 Stub在frameworks/base/services/core/java/com/android/server创建服务实现public class MyService extends IMyService.Stub { private static final String TAG MyService; private int mVersion 1; Override public int getVersion() { return mVersion; } Override public void setConfig(Bundle config) { enforcePermission(android.permission.MY_PERMISSION); // 处理配置... } private void enforcePermission(String permission) { if (mContext.checkCallingPermission(permission) ! PackageManager.PERMISSION_GRANTED) { throw new SecurityException(Requires permission); } } }关键点继承自生成的 Stub 类必须实现所有 AIDL 方法注意添加权限检查线程模型默认是 Binder 线程池4. 服务注册与管理4.1 修改 SystemServer在frameworks/base/services/java/com/android/server/SystemServer.java的startOtherServices()方法中添加try { traceBeginAndSlog(StartMyService); ServiceManager.addService(my_service, new MyService()); traceEnd(); } catch (Throwable e) { reportWtf(starting MyService, e); }4.2 Android.bp 配置在对应模块的 Android.bp 中添加java_library { name: my-service, srcs: [**/*.java], aidl: { include_dirs: [frameworks/base/core/java], }, libs: [ android, services.core, ], }编译验证m my-service adb sync5. 客户端访问实现5.1 获取服务代理客户端调用方式IMyService myService IMyService.Stub.asInterface( ServiceManager.getService(my_service)); if (myService ! null) { try { int version myService.getVersion(); Log.d(TAG, Service version: version); } catch (RemoteException e) { e.printStackTrace(); } }5.2 权限声明在frameworks/base/core/res/AndroidManifest.xml中添加permission android:nameandroid.permission.MY_PERMISSION android:protectionLevelsignature /6. 高级技巧与调试6.1 Binder 调用优化批量操作减少跨进程调用次数异步调用使用 oneway 修饰符interface IMyService { oneway void asyncUpdate(in Parcelable data); }对象复用避免频繁创建 Parcelable 对象6.2 调试方法Binder 调用追踪adb shell su root cat /sys/kernel/debug/tracing/trace_pipe | grep Binder服务列表检查adb shell service list调用统计adb shell dumpsys activity services my_service7. 常见问题解决7.1 服务注册失败症状ServiceManager.addService() 返回 false检查服务名是否冲突验证 SELinux 策略adb shell su root dmesg | grep avc7.2 客户端获取服务为 null确认服务已成功注册adb shell service check my_service检查客户端权限adb shell dumpsys package client-pkg | grep permission7.3 性能问题Binder 线程池耗尽默认 16 线程可通过修改Binder.java调整传输大对象超过 1MB 建议使用共享内存ashmem8. 安全最佳实践最小权限原则仅开放必要的接口参数校验所有输入参数必须验证速率限制防止恶意高频调用private final RateLimiter mRateLimiter new RateLimiter(10); // 10次/秒 public Bundle executeCommand(String cmd) { if (!mRateLimiter.tryAcquire()) { throw new SecurityException(Call too frequent); } // ... }SELinux 策略为服务添加对应 domain 和权限9. 测试验证策略9.1 单元测试在frameworks/base/services/tests/servicestests/添加SmallTest public class MyServiceTest extends AndroidTestCase { private IMyService mService; Override protected void setUp() throws Exception { mService IMyService.Stub.asInterface( ServiceManager.getService(my_service)); } public void testVersion() throws RemoteException { assertTrue(mService.getVersion() 0); } }运行测试atest MyServiceTest9.2 CTS 验证在cts/tests/tests/os/添加 CTS 用例public class MyServiceHostTest extends BaseHostJUnit4Test { Test public void testServiceAvailable() throws Exception { assertNotNull(getDevice().getService(my_service)); } }10. 性能优化实践10.1 传输效率优化优化方式实现方法适用场景数据压缩使用 GZIP 压缩 Bundle传输数据 10KB批处理合并多个小请求高频小数据调用缓存客户端缓存结果数据变化不频繁10.2 内存管理// 服务端实现 Parcelable 时注意 Override public void writeToParcel(Parcel dest, int flags) { dest.writeInt(mData.length); // 先写长度 dest.writeByteArray(mData); // 再写数据 } // 客户端读取时 byte[] data new byte[source.readInt()]; // 预分配 source.readByteArray(data);11. 兼容性考虑接口版本控制interface IMyService { int VERSION 2; // 每次修改递增 int getInterfaceVersion(); }多进程支持确保 Parcelable 类在所有进程可用避免使用静态变量共享状态API 演进新方法添加 default 实现废弃方法用 Deprecated 标记12. 扩展知识Binder 调用流程详解客户端调用proxy.getVersion() → Proxy.transact(CODE_GET_VERSION) → BinderProxy.transact() → nativeTransact() (JNI)服务端处理Binder线程收到请求 → onTransact(CODE_GET_VERSION) → Stub.getVersion() → 实际服务实现返回结果服务端结果写入Parcel → 通过Binder驱动返回 → Proxy读取结果 → 返回给客户端13. 实际案例实现配置服务以下是一个完整的配置服务实现示例IConfigService.aidl:interface IConfigService { int getInt(String key, int defValue); void putInt(String key, int value); String getString(String key, String defValue); void putString(String key, String value); }ConfigService.java:public class ConfigService extends IConfigService.Stub { private final ConcurrentHashMapString, Object mConfigs new ConcurrentHashMap(); Override public int getInt(String key, int defValue) { Object val mConfigs.get(key); return (val instanceof Integer) ? (int)val : defValue; } Override public void putInt(String key, int value) { mConfigs.put(key, value); } // 其他方法实现... }14. 线程模型详解Binder 调用涉及以下线程客户端线程发起调用的原始线程Binder 线程池服务端处理线程默认16个名称格式Binder:XXXX_#主线程服务如果绑定到 Activity 的主线程重要不要在 Binder 方法中执行长时间操作1秒否则会阻塞线程池15. 跨版本兼容实现处理不同 Android 版本的兼容方案public class MyService extends IMyService.Stub { Override public Bundle executeCommand(String cmd) { if (Build.VERSION.SDK_INT Build.VERSION_CODES.Q) { // Android 10 的实现 } else { // 旧版本实现 } } }16. 性能监控与统计添加调用统计public class MyService extends IMyService.Stub { private final LongArray mCallTimes new LongArray(); Override public Bundle executeCommand(String cmd) { long start SystemClock.elapsedRealtime(); try { // 实际处理... } finally { mCallTimes.add(SystemClock.elapsedRealtime() - start); } } public void dump(FileDescriptor fd, PrintWriter pw, String[] args) { pw.println(Average call time: calculateAverage() ms); } }17. 内存泄漏防护常见泄漏场景及防护静态引用避免在服务中静态持有 Context匿名回调使用 WeakReference 包装回调private static class SafeCallback extends IMyCallback.Stub { private final WeakReferenceMyClient mClient; SafeCallback(MyClient client) { mClient new WeakReference(client); } }资源释放在 onDestroy() 中释放 native 资源18. 多用户支持处理多用户场景public Bundle getUserData(int userId) { final long ident Binder.clearCallingIdentity(); try { return ActivityManager.getService().getUserData(userId); } finally { Binder.restoreCallingIdentity(ident); } }关键点clearCallingIdentity() 保存原始调用身份以系统身份执行特权操作restoreCallingIdentity() 恢复原始身份19. 服务生命周期管理完整生命周期处理public class MyService extends IMyService.Stub implements IBinder.DeathRecipient { void start() { // 初始化资源 ServiceManager.addService(my_service, this); } void stop() { // 释放资源 } Override public void binderDied() { // 客户端Binder死亡处理 } }20. 最佳实践总结接口设计原则方法粒度适中避免太细或太粗参数不超过 5 个返回结果包含错误码性能关键点单次调用耗时 100ms传输数据 100KB避免同步阻塞调用安全规范所有方法默认添加权限检查敏感操作记录审计日志定期检查调用频次维护建议添加详细的接口文档保持向后兼容提供版本迁移指南