Android进程间通信(IPC)的AIDL机制:Hello World示例

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完成!




郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。