【无标题】

🧩 深入理解 Android 系统服务注册：从 ServiceManager.addService() 说起

关键词：Android 系统开发、Binder、ServiceManager、SystemServer、自定义系统服务、STB 机顶盒

在 Android 系统定制开发中（尤其是智能电视、IPTV 机顶盒、车载系统等场景），我们经常需要向系统注入自定义的服务，以便上层 App 能够调用底层硬件或专有功能。而实现这一目标的核心步骤之一，就是在系统启动时将服务注册到全局服务管理器中。

今天，我们就来详细解析一段典型的 Android 系统服务注册代码：

t.traceBegin("StartStbService");
try {
    Slog.i("WsService", "Ws Service");
    MyWsServiceImpl mService = new MyWsServiceImpl();
    ServiceManager.addService("WsService", mService);
} catch (Throwable e) {
    reportWtf("starting Ws Service", e);
}
t.traceEnd();

这段看似简单的代码，背后却承载着 Android IPC（进程间通信）架构的核心思想。下面我们逐层拆解它的作用与意义。

---

一、代码出现在哪里？

这段代码通常位于 frameworks/base/services/java/com/android/server/SystemServer.java 文件中 ------ 这是 Android 系统启动过程中最关键的类之一。

• SystemServer 运行在 system_server 进程中；
• 它负责启动所有核心系统服务，如 ActivityManagerService、PackageManagerService、PowerManagerService 等；
• 厂商或 ROM 开发者也会在这里插入自己的定制服务，比如这里的 STBService（Set-Top Box Service，机顶盒服务）。

---

二、逐行解析：每一行都在做什么？

1. t.traceBegin("StartWsService");

• 使用 Android 的 Systrace / Perfetto 性能追踪机制 ，标记一个名为 "StartStbService" 的执行区间。
• 目的：便于后续通过性能分析工具查看该服务启动耗时，优化系统启动速度。

2. Slog.i("WsService", "Ws Service");

• 打印一条 系统级日志 （Slog = System Log）。
• 与普通 Log 不同，Slog 用于 system_server 等特权进程，输出到 logcat -b system。

3. MyWsServiceImpl mService = new MyWsServiceImpl();

• 创建自定义服务的实例。

• 关键要求 ：MyWsServiceImpl 必须继承自 Binder，通常是某个 AIDL 接口的 Stub 实现：

  public class MyWsServiceImpl extends IWsService.Stub {
      @Override
      public void switchChannel(String channel) { /* ... */ }
      
      @Override
      public void setVolume(int level) { /* ... */ }
  }

4. ServiceManager.addService("WsService", WsService); ✅ 核心！

• 将该服务以名称 "WsService" 注册到 全局 ServiceManager。

• 此后，任何进程都可以通过服务名获取其 Binder 引用：

  IBinder binder = ServiceManager.getService("WsService");
  IWsService proxy = IWsService.Stub.asInterface(binder);
  proxy.switchChannel("CCTV-1"); // 跨进程调用！

• 注意 ：ServiceManager 是 Android Binder 架构中的"电话总机"，维护着 <服务名, IBinder> 的全局映射表。

5. 异常处理 + reportWtf

• 捕获所有异常（包括 Error），并通过 reportWtf() 上报"严重故障"（What a Terrible Failure）。
• 这是 Android 系统处理致命错误的标准做法，会记录到 ANR/WTF 日志中，便于调试。

6. t.traceEnd();

• 结束 Systrace 区间，确保性能追踪数据完整。

---

三、为什么这一步如此重要？

✅ 实现跨进程服务暴露

• 没有 addService()，你的服务就只是一个普通的 Java 对象，只能在 system_server 内部使用。
• 通过注册，它变成了 全系统可见的 Binder 服务，App、其他系统服务均可调用。

✅ 支撑上层 API 封装

• 后续你可以在 ContextImpl 中注册一个 WsManager：

  registerService(Context.Ws_SERVICE, WsManager.class,
      new CachedServiceFetcher<>() {
          public WsManager createService(ContextImpl ctx) {
              IBinder b = ServiceManager.getService("WsService");
              return new WsManager(IWsService.Stub.asInterface(b));
          }
      });

• 这样 App 就能像使用 PowerManager 一样使用：

  WsManager stb = (WsManager) getSystemService(Context.WS_SERVICE);
  stb.switchChannel("CCTV-1");

✅ 符合 Android 系统架构规范

• 所有原生系统服务（如 ActivityManagerService）都是这样注册的；
• 你的定制服务因此能无缝融入 Android 生态。

---

四、典型应用场景

场景	说明
智能电视 / 机顶盒	控制 DTV 频道、CA 卡认证、EPG 节目单、PVR 录制
车载系统	调音台控制、CAN 总线通信、倒车影像切换
工业平板	串口通信、GPIO 控制、RFID 读写
安全设备	DRM 内容解密、安全启动状态查询

💡 例如：某运营商定制机顶盒要求 App 能切换直播频道，但频道控制逻辑涉及 CA 加密和硬件调谐器 ------ 这就必须通过系统服务实现。

---

五、注意事项与最佳实践

1. 权限控制必不可少

   在 MyWsServiceImpl 中校验调用者权限：

   public void playPaidChannel(String ch) {
       mContext.enforceCallingOrSelfPermission("com.example.permission.STB_PAID", null);
       // ...
   }

2. 线程安全
   system_server 是多线程环境，服务实现必须线程安全。

3. 避免阻塞主线程

   耗时操作应放到工作线程（如 HandlerThread）。

4. 服务名全局唯一

   避免与其他服务冲突（建议加厂商前缀，如 "vendor.stb"）。

5. 仅限系统签名应用调用

   普通 App 无法直接调用 ServiceManager.getService()，需通过封装后的 getSystemService()。

---