Android进程间通信（IPC）的AIDL机制：Hello World示例

太过爱你忘了你带给我的痛 2023-10-16 21:06 0阅读 0赞

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()**的方法，注意：此方法就是随后服务端暴露给客户端，且将要提供给客户端使用的接口，如下图：

![Center][]

如果ServerServiceInterface.aidl源代码文件中没有写错误，那么Eclipse会自动在gen目录下生成一个名字完全一致、相对应的ServerServiceInterface.java文件。不需要关心ServerServiceInterface.java源代码文件中的具体内容。

![Center 1][]

（第2步）自己写一个类ServerService.java，继承自Service，在ServerService.java类内部再写一个ServerServiceInstance.java类继承自ServerServiceInterface.java中的Stub类，在此类中实现getHelloWorld()方法。

![Center 2][]

给出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="start_zhangphil_aidl_server_service_action" />
                </intent-filter>
            </service>
            
        </application>
    
    </manifest>

服务端AndroidManifest.xml没什么特别的地方，唯一的重点是需要在此文件中写明在‘ 第（2）步 ’中的写的service：

以上是服务端。

下面是客户端。

（第4步）Eclipse中再创建一个名字为client的客户端app。把上面服务端server项目工程中gen目录下自动生成的ServerServiceInterface.java源代码文件原封不动、保持原貌（包括包结构）复制、粘贴到客户端src目录下：

![Center 3][]

（第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输出：

![Center 4][]

一个最简单的Android IPC AIDL之hello world完成！

[Center]: https://img-blog.csdn.net/20150218141619840?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvemhhbmdwaGls/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 1]: https://img-blog.csdn.net/20150218142050158?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvemhhbmdwaGls/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 2]: https://img-blog.csdn.net/20150218142525139?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvemhhbmdwaGls/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 3]: https://img-blog.csdn.net/20150218144755119?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvemhhbmdwaGls/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 4]: https://img-blog.csdn.net/20150218150331321?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvemhhbmdwaGls/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center