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; } }
(第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); // } }
相对应的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>
服务端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>
以上是服务端。
下面是客户端。
(第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); } }
在第5步中关键点有两个:
(1)构造ServiceConnection,在ServiceConnection中Override onServiceConnected()方法。如果客户端连接服务端进程成功,那么onServiceConnected()将被回调。
(2)调用bindService()发起连接到服务进程端。
以上完成后,首先启动server,然后再启动client,client端的LogCat输出:
一个最简单的Android IPC AIDL之hello world完成!