远程服务使用AIDL通信

在Android 中,一个进程通常无法访问另一个进程的内存。因此为了进程间通信,Android提供了AIDL机制,AIDL是Android中IPC(Inter-Process Communication)方式中的一种,AIDL是Android Interface definition language的缩写,AIDL的作用是可以在自己的App里绑定一个其他App的Service,这样App可以通过AIDL与其他App进行交互。

App之间操作Service

这是BasicService应用中 AndroidManifest.xml定义的Service组件

1<service
2	 android:name=".MyService"
3	 android:enabled="true"
4	 android:exported="true" >
5	<intent-filter>
6		<action android:name="cn.tim.basic_service.myservice"/>
7	</intent-filter>
8</service>

MyService.java实现如下:

 1public class MyService extends Service {
 2    private static final String TAG = "MyService";
 3
 4    private DownloadBinder mBinder = new DownloadBinder();
 5    static class DownloadBinder extends Binder {
 6        public void startDownload() {
 7            // 模拟下载
 8            Log.i(TAG, "startDownload executed");
 9        }
10
11        public int getProgress() {
12            // 模拟返回下载进度
13            Log.i(TAG, "getProgress executed");
14            return 0;
15        }
16    }
17
18    public MyService() {
19
20    }
21
22    // 创建
23    @Override
24    public void onCreate() {
25        super.onCreate();
26        Log.i(TAG, "onCreate: ");
27    }
28
29    // 启动
30    @Override
31    public int onStartCommand(Intent intent, int flags, int startId) {
32        Log.i(TAG, "onStartCommand: ");
33        return super.onStartCommand(intent, flags, startId);
34    }
35
36    // 绑定
37    @Override
38    public IBinder onBind(Intent intent) {
39        Log.i(TAG, "onBind: ");
40        return mBinder;
41    }
42
43    // 解绑
44    @Override
45    public void unbindService(ServiceConnection conn) {
46        super.unbindService(conn);
47        Log.i(TAG, "unbindService: ");
48    }
49
50    // 销毁
51    @Override
52    public void onDestroy() {
53        super.onDestroy();
54        Log.i(TAG, "onDestroy: ");
55    }
56}

如何在另一个应用中远程对BasicService这个App中的应用进行操作呢?在AIDLDemo这个App中:

MainActivity.java如下:

 1public class MainActivity extends AppCompatActivity {
 2    ServiceConnection connection = new ServiceConnection() {
 3        @Override
 4        public void onServiceConnected(ComponentName name, IBinder service) {
 5
 6        }
 7
 8        @Override
 9        public void onServiceDisconnected(ComponentName name) {
10
11        }
12    };
13
14    @Override
15    protected void onCreate(Bundle savedInstanceState) {
16        super.onCreate(savedInstanceState);
17        setContentView(R.layout.activity_main);
18    }
19
20    public void aboutService(View view) {
21        int id = view.getId();
22        // Android5.0后不支持隐式启动了,最好都写成显示启动
23        Intent intent = new Intent();
24        intent.setAction("cn.tim.basic_service.myservice");
25        intent.setPackage("cn.tim.basic_service");
26        switch (id){
27            case R.id.start_btn:
28                startService(intent);
29                break;
30            case R.id.stop_btn:
31                stopService(intent);
32                break;
33            case R.id.bind_btn:
34                bindService(intent, connection, BIND_AUTO_CREATE);
35                break;
36            case R.id.unbind_btn:
37                unbindService(connection);
38                break;
39        }
40    }
41}

App之间Service通信

上面虽然完成了App之间的Service基本控制,比如启动、停止、绑定解绑等操作,但是即使绑定了Service,但是Activity还是并不知道服务到底去做了什么事情,以及完成得如何。这个时候就需要用到AIDL进行通信了。

首先需要明白的是要创建一套被调用的接口肯定要从被调用者出发,所以先在BasicService这个App中:

step1、创建AIDL文件,本例中命名为IMyAidlInterface.aidl:

step2、编辑AIDL文件,在这个AIDL文件里编写需要在服务绑定后通信的方法:

 1// IMyAidlInterface.aidl
 2package cn.tim.basic_service;
 3
 4// Declare any non-default types here with import statements
 5
 6interface IMyAidlInterface {
 7
 8    // 定义自己需要的方法:获取当前服务的进度
 9    int getProgress();
10}

step3、rebuild project自动生成对应的接口,接下来只要Rebuild一下工程就会在build > generated > aidl_source_output_dir > debug 下出现一个包,包下就是IMyAidlInterface.java:

其实Stub还会定义几个辅助方法,其中最值得注意的是 asInterface(),该方法会接收 IBinder(通常是传递给客户端 onServiceConnected() 回调方法的参数),并返回 Stub 接口的实例,其实就是通过代理的方式去完成IPC通信。

在MyService中绑定的回调函数onBind()中返回的那就是IMyAidlInterface.Stub代理对象了:

 1public class MyService extends Service {
 2    ...
 3    
 4    @Override
 5    public IBinder onBind(Intent intent) {
 6        Log.i(TAG, "onBind: ");
 7        //return mBinder;
 8        return new IMyAidlInterface.Stub() {
 9            @Override
10            public int getProgress() {
11                Log.i(TAG, "getProgress: IMyAidlInterface");
12                return 0;
13            }
14        };
15    }
16}

这样即使是在BasicService这个App中也可以使用IMyAidlInterface中的代理对象:

 1ServiceConnection connection = new ServiceConnection() {
 2    @Override
 3    public void onServiceConnected(ComponentName name, IBinder service) {
 4        // MyService.DownloadBinder binder = (MyService.DownloadBinder) service;
 5        // binder.startDownload();
 6        // binder.getProgress();
 7        IMyAidlInterface asInterface = IMyAidlInterface.Stub.asInterface(service);
 8        try {
 9            asInterface.getProgress();
10        } catch (RemoteException e) {
11            e.printStackTrace();
12        }
13    }
14
15    @Override
16    public void onServiceDisconnected(ComponentName name) {
17
18    }
19};

step4、复制同样的AIDL文件到AIDLDemo这个工程中,AIDL作为调用者。需要注意的是必须放到相同的包下,因此需要手动建包,再把文件复制过来:

同样的方式,工程进行一次rebuild,同样会生成IMyAidlInterface.java,这样大家都具有了IMyAidlInterface这个接口,使用起来也就还是一样了,MainActivity.java:

step5、在AIDLDemo这个工程中使用IMyAidlInterface

 1public class MainActivity extends AppCompatActivity {
 2    private static final String TAG = "AIDLMainActivity";
 3    ServiceConnection connection = new ServiceConnection() {
 4        @Override
 5        public void onServiceConnected(ComponentName name, IBinder service) {
 6            IMyAidlInterface asInterface = IMyAidlInterface.Stub.asInterface(service);
 7            try {
 8                int progress = asInterface.getProgress();
 9                Log.i(TAG, "onServiceConnected: progress = " + progress);
10            } catch (RemoteException e) {
11                e.printStackTrace();
12            }
13        }
14
15        @Override
16        public void onServiceDisconnected(ComponentName name) {
17
18        }
19    };
20
21    @Override
22    protected void onCreate(Bundle savedInstanceState) {
23        super.onCreate(savedInstanceState);
24        setContentView(R.layout.activity_main);
25    }
26
27    public void aboutService(View view) {
28        int id = view.getId();
29        Intent intent = new Intent();
30        intent.setAction("cn.tim.basic_service.myservice");
31        intent.setPackage("cn.tim.basic_service");
32        switch (id){
33            case R.id.start_btn:
34                startService(intent);
35                break;
36            case R.id.stop_btn:
37                stopService(intent);
38                break;
39            case R.id.bind_btn:
40                bindService(intent, connection, BIND_AUTO_CREATE);
41                break;
42            case R.id.unbind_btn:
43                unbindService(connection);
44                break;
45        }
46    }
47}

可以看到,AIDLDemo这个App的MainActivity已经和BasicService这个App的MyService服务已经绑定了,并且可以正常的调用MyService中的方法。至此,通过AIDL实现的远程绑定服务通信已经完成了:

tips:上面logcat同时打印两个TAG的日志的方法就是在配置过滤器LogTag:MyService | AIDLMainActivity即可。

使用AIDL的注意事项

1、只有在需要不同应用的客户端通过 IPC 方式访问服务,并且希望在服务中进行多线程处理时,才有必要使用 AIDL。如果无需跨不同应用执行并发 IPC,则应通过实现 Binder 来创建接口;或者如果想执行 IPC,但不需要处理多线程,推荐使用 Messenger 来实现接口。

2、如果需要在首次发布 AIDL 接口后对其进行更改,则每次更改必须保持向后兼容性,以免中断其他应用使用对应的服务。换言之,由于只有在将 .aidl 文件复制到其他应用后,才能使其访问服务接口,因而必须保留对原始接口的支持。

原文地址: 《远程服务使用AIDL通信》