4. 实现 Service Stub：生成 AIDL Stub 类、override 方法、权限检查、异常处理

4.1 原理：AIDL Stub 类与 Binder 通信模型

Android Framework 中，自定义系统级 Service 必须通过 Binder 对外暴露接口。AIDL（Android Interface Definition Language）编译器会为声明的接口自动生成一个名为 Stub 的抽象内部类，它继承自 android.os.Binder 并实现了你在 .aidl 文件中定义的接口。客户端通过 Stub.asInterface() 拿到代理，发起 IPC 调用；服务端则继承 Stub 类，重写接口方法，完成实际业务逻辑。

4.2 实现流程

4.3 代码实现

4.3.1 AIDL 接口定义

// frameworks/base/core/java/com/example/IMyService.aidl
package com.example;

interface IMyService {
    String getData(int id);
    int setData(String value) throws android.os.RemoteException;
}

4.3.2 编译后生成的 Stub 类（简化展示）

// 自动生成：out/soong/.../IMyService.java
public interface IMyService extends android.os.IInterface {
    public static abstract class Stub extends android.os.Binder implements IMyService {
        private static final String DESCRIPTOR = "com.example.IMyService";

        public Stub() {
            attachInterface(this, DESCRIPTOR);
        }

        @Override
        public boolean onTransact(int code, android.os.Parcel data,
                                  android.os.Parcel reply, int flags)
                throws android.os.RemoteException {
            switch (code) {
                case TRANSACTION_getData:
                    data.enforceInterface(DESCRIPTOR);
                    int _id = data.readInt();
                    // 权限检查可在此处
                    String _result = getData(_id);
                    reply.writeNoException();
                    reply.writeString(_result);
                    return true;
                case TRANSACTION_setData:
                    data.enforceInterface(DESCRIPTOR);
                    String _value = data.readString();
                    // 权限检查
                    int _result = setData(_value);
                    reply.writeNoException();
                    reply.writeInt(_result);
                    return true;
                default:
                    return super.onTransact(code, data, reply, flags);
            }
        }
        // 以下为事务码常量
        static final int TRANSACTION_getData = (IBinder.FIRST_CALL_TRANSACTION + 0);
        static final int TRANSACTION_setData = (IBinder.FIRST_CALL_TRANSACTION + 1);
    }
}

4.3.3 自定义 Service 继承 Stub 并 override 方法

// MyService.java
public class MyService extends Service {
    private final IMyService.Stub mBinder = new IMyService.Stub() {
        @Override
        public String getData(int id) throws RemoteException {
            // 权限检查
            if (checkCallingOrSelfPermission("com.example.permission.ACCESS_MY_SERVICE")
                    != PackageManager.PERMISSION_GRANTED) {
                throw new SecurityException("Permission denied");
            }
            // 业务逻辑
            return "data for id=" + id;
        }

        @Override
        public int setData(String value) throws RemoteException {
            // 权限检查
            enforceCallingPermission("com.example.permission.ACCESS_MY_SERVICE", null);
            // 业务逻辑
            return 0;
        }
    };

    @Override
    public IBinder onBind(Intent intent) {
        return mBinder;
    }
}

4.4 权限检查详解

Binder 调用方可以是任意进程，必须验证调用者是否具备权限。Framework 为 Service 提供了两种方法：

• checkCallingOrSelfPermission(String permission) – 返回是否授予权限（不抛异常）
• enforceCallingPermission(String permission, String message) – 无权限时直接抛出 SecurityException

权限字符串需在 AndroidManifest.xml 中声明（system 级 Service 通常使用 android.permission 或自定义 signature 级权限）：

<permission android:name="com.example.permission.ACCESS_MY_SERVICE"
            android:protectionLevel="signature" />

4.5 异常处理策略

推荐在 Stub 的 onTransact() 内包裹 try-catch，统一处理未预期异常：

@Override
public boolean onTransact(int code, Parcel data, Parcel reply, int flags) {
    try {
        return super.onTransact(code, data, reply, flags);
    } catch (Exception e) {
        reply.writeException(e);
        return true;
    }
}

4.6 调试与验证

• 日志：在 Stub 方法内添加 Log.d("MyService", "getData called from uid=" + Binder.getCallingUid());
• dumpsys：在 Service 中实现 dump() 方法，通过 adb shell dumpsys activity service <component> 查看状态
• 测试客户端：编写一个简单的 App 绑定 Service，调用方法并捕获返回或异常

4.7 常见错误

4.8 性能与稳定性优化

• 减少跨进程数据传输：避免在方法中传递大 Bitmap 或长 List，改用文件描述符或 ContentProvider
• 使用 oneway 声明：在 AIDL 方法前加 oneway 关键字，使调用不阻塞客户端（适用于通知类接口）
• 线程池隔离：如果 Service 需要执行耗时操作，在 Stub 方法内抛到自己的 HandlerThread 中，避免占用 Binder 线程池
• 资源释放：在 onTransact() 或方法结束后，确保 Parcel 不会泄露

通过以上步骤，你就能在 Framework 层成功实现一个健壮、安全的 Service Stub，为后续注册到 ServiceManager 并提供给其他进程调用打下坚实基础。