Android实现IPC可使用Android本身提供的AIDL机制。网上也有很多相关文章,但写的过于繁琐和麻烦,重点也不突出。本文抽丝剥茧从工程角度给出一个最简单的Android AIDL例程关键代码,以最简单的形式说明如何在代码中使用Android AIDL。
AIDL首先在逻辑上可分为“服务端”和“客户端”。在本示例中,则以两个完全不同、互相独立的Eclipse 项目代表。
(1)server。一个Android App,即AIDL的服务端服务提供者。
(2)clinet。另外一个Android App,即AIDL的服务调用方。
实现的演示代码功能很简单:
(1)服务端首先启动,启动之后,什么都不做。当客户进程连接过来,返回“Hello , World !”字符串。
(2)客户连接服务端。获得服务端返回的字符串,然后在LogCat中打印出来。
代码框架和具体步骤:
(第1步)Eclipse中创建一个服务端app。假设名字就是server。首先在服务端创建一个名为 ServerServiceInterface.aidl的源代码放在源代码包中。虽然ServerServiceInterface.aidl中接口定义遵循java规范,但唯一不同的是不要在里面添加public, private等等诸如此类的修饰符。在ServerServiceInterface.aidl中定义一个getHelloWorld()的方法,注意:此方法就是随后服务端暴露给客户端,且将要提供给客户端使用的接口,如下图:
如果ServerServiceInterface.aidl源代码文件中没有写错误,那么Eclipse会自动在gen目录下生成一个名字完全一致、相对应的ServerServiceInterface.java文件。不需要关心ServerServiceInterface.java源代码文件中的具体内容。
(第2步)自己写一个类ServerService.java,继承自Service,在ServerService.java类内部再写一个ServerServiceInstance.java类继承自ServerServiceInterface.java中的Stub类,在此类中实现getHelloWorld()方法。
给出ServerService.java的全部源代码如下:
package zhangphil.aidl.server;
import android.app.Service;
import android.content.Intent;
import android.os.IBinder;
public class ServerService extends Service {
public class ServerServiceInstance extends ServerServiceInterface.Stub {
//此方法供客户端调用,返回客户端一个 Hello , World ! 字符串。
@Override
public String getHelloWorld() {
return "Hello , World !";
}
}
@Override
public IBinder onBind(Intent intent) {
//必须返回一个ServerServiceInstance实例、对象,供客户端使用
ServerServiceInstance mServerServiceInstance = new ServerServiceInstance();
return mServerServiceInstance;
}
}
AI 代码解读
(第3步)写一个服务端的主Activity。本例为使代码简单,主Activity中不做任何过多与AIDL无关的代码,MainActivity仅作一个启动App的“容器”而已:
package zhangphil.aidl.server;
import android.app.Activity;
public class MainActivity extends Activity {
//为了使Demo代码简洁短小不繁冗,索性把主Activity都注释掉。
// @Override
// protected void onCreate(Bundle savedInstanceState) {
// super.onCreate(savedInstanceState);
// }
}
AI 代码解读
相对应的AndroidManifest.xml文件:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="zhangphil.aidl.server"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="16" />
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name="zhangphil.aidl.server.MainActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<service android:name="zhangphil.aidl.server.ServerService" >
<intent-filter>
<!-- action android:name的具体值可以任意给定,但必须保证客户端调用时和此处定义的一致。
通常使用形如 ACTION_AIDL_SERVER_SERVICE或者com.xxx.xxx等等这种样式。
-->
<action android:name="start_zhangphil_aidl_server_service_action" />
</intent-filter>
</service>
</application>
</manifest>
AI 代码解读
服务端AndroidManifest.xml没什么特别的地方,唯一的重点是需要在此文件中写明在‘ 第(2)步 ’中的写的service:
<service android:name="zhangphil.aidl.server.ServerService" >
<intent-filter>
<!-- action android:name的具体值可以任意给定,但必须保证客户端调用时和此处定义的一致。
通常使用形如 ACTION_AIDL_SERVER_SERVICE或者com.xxx.xxx等等这种样式。
-->
<action android:name="start_zhangphil_aidl_server_service_action" />
</intent-filter>
</service>
AI 代码解读
以上是服务端。
下面是客户端。
(第4步)Eclipse中再创建一个名字为client的客户端app。把上面服务端server项目工程中gen目录下自动生成的ServerServiceInterface.java源代码文件原封不动、保持原貌(包括包结构)复制、粘贴到客户端src目录下:
(第5步)到这里基本上大功告成。接下来只需要在客户端中bind到服务端的service,然后调用getHelloWorld()方法即可,这里面要用到Android的ServiceConnection。简单期间,就在客户端的MainActivity中bindService,把ServiceConnection中的关键方法重写,客户端MainActivity代码:
package zhangphil.aidl.client;
import zhangphil.aidl.server.ServerServiceInterface;
import android.os.Bundle;
import android.os.IBinder;
import android.util.Log;
import android.app.Activity;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.ServiceConnection;
public class MainActivity extends Activity {
private ServerServiceInterface mServerServiceInterface;
private ServiceConnection serviceConnection = new ServiceConnection() {
@Override
public void onServiceConnected(ComponentName name, IBinder service) {
mServerServiceInterface = ServerServiceInterface.Stub.asInterface(service);
try {
String hi=mServerServiceInterface.getHelloWorld();
Log.d(this.getClass().getName(),hi);
} catch (Exception e) {
e.printStackTrace();
}
}
@Override
public void onServiceDisconnected(ComponentName name) {
}
};
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//构造Intent的值必须和所调用的服务端定义的值相同。
//本例中就是Server端AndroidManifest.xml中定义service时的那个action name
bindService(new Intent("start_zhangphil_aidl_server_service_action"), serviceConnection, Context.BIND_AUTO_CREATE);
}
}
AI 代码解读
在第5步中关键点有两个:
(1)构造ServiceConnection,在ServiceConnection中Override onServiceConnected()方法。如果客户端连接服务端进程成功,那么onServiceConnected()将被回调。
(2)调用bindService()发起连接到服务进程端。
以上完成后,首先启动server,然后再启动client,client端的LogCat输出:
一个最简单的Android IPC AIDL之hello world完成!