基于AIDL编程实现Android远程Service服务
Posted Tr0e
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了基于AIDL编程实现Android远程Service服务相关的知识,希望对你有一定的参考价值。
文章目录
前言
Service 作为 android 四大组件之一,应用非常广泛。
远程服务与本地服务最大的区别是:远程 Service 与调用者不在同一个进程里(即远程 Service 是运行在另外一个进程);而本地服务则是与调用者运行在同一个进程里。二者区别的详细区别如下图:
本地Service
先来看看 Android 普通 Service 的使用。
异步消息处理机制
郭霖解释得很清晰:
服务与活动的通信
直接看看《Android第一行代码》里面的示例:
【圈重点】service 服务的 onBind() 方法通过绑定自定义的 Binder 继承类对象,结合服务与活动绑定后将自动调用执行的 onServiceConnected() 函数,可定义活动与服务的交互动作。
远程Service
Android 系统中的进程之间不能共享内存,因此,需要提供一些机制在不同进程之间进行数据通信。为了使其他的应用程序也可以访问本应用程序提供的服务,Android 系统采用了远程过程调用(Remote Procedure Call,RPC)方式来实现。与很多其他的基于 RPC 的解决方案一样,Android 使用一种接口定义语言(Interface Definition Language,IDL)来公开服务的接口。为了克服 Linux 中 IPC (Inter-Process Communication,即跨进程通信)各种方式的缺点,在 Android 中引入了 Binder 机制,而 AIDL 即是 Binder 机制实现 Android IPC 时使用的工具。
【More】关于 Android 跨进程通信:Android跨进程通信Binder机制与AIDL实例。
Binder与AIDL基础
Binder 与 AIDL 的作用范围:
- Binder:如果是在一个应用里实现远程调用,使用Binder即可,没必要使用AIDL(比如上面演示的本地Service代码);
- AIDL:如果涉及到在多个应用程序之间使用IPC通信,并且在服务又有多线程业务处理,这时可以使用AIDL。
Binder 跨进程通信机制 模型 基于 Client - Server 模式:
Client-ServiceManager-Server时序图如下:
Binder 从代码的角度来说,是 Android 系统源码中的一个类,它实现了 IBinder 接口;从 IPC 角度来说,Binder 是 Android 中的一种跨进程通信方式;从 Android Framework 角度来讲,Binder 是 ServiceManager 连接各种 Manager(ActivityManager、WindowManager 等等)和相应 ManagerService 的桥梁;从 Android 应用层来说,Binder 是客户端和服务端进行通信的媒介,当 bindService 的时候,服务端会返回一个包含了服务端业务调用的 Binder 对象,通过这个 Binder 对象,客户端就可以和服务端进行通信,这里的服务包括普通服务和基于 AIDL 的服务。
AIDL Service服务端
在多进程通信中,存在两个进程角色(以最简单的为例):服务器端和客户端。以下是两个进程角色的具体使用步骤:
服务器端(Service)
- 新建定义AIDL文件,并声明该服务需要向客户端提供的接口;
- 在 Service 子类中定义内部类 A 实现 AIDL 中定义的接口方法,并定义 Service 生命周期的方法(onCreat()、onBind()等),重点是在 onBind() 方法中 return 返回 A 类的对象;
- 在 AndroidMainfest.xml 中注册服务且声明为远程服务。
客户端(Client)
- 拷贝服务端的 AIDL 文件到 aidl 目录下;
- 通过Intent指定服务端的服务名称和所在包,绑定远程Service;
- 使用 Stub.asInterface 接口获取服务器的 Binder,根据需要调用服务提供的接口方法。
接下来,通过一个具体实例来介绍远程 Service 的使用。主要实现的是通过 AIDL 自定义的远程服务,给客户端 APP 提供登录接口和图书价格查询的接口。
(1)新建一个带了空 MainActivity 的 Android 项目 com.bwshen.aidlservice,先来看下最终的项目结构(需要编写的文件有 aidl 文件 IMyBookManager.aidl 、图书类 book.java、服务类 AIDLService.java):
(2)先来创建 aidl 接口文件 IMyBookManager.aidl ,在 app 上点击右键->新建->AIDL->AIDL文件(将自动创建 aidl 文件夹),定义两个服务接口分别为用于登录的 login() 和用于图书查询的 queryByName(),具体代码如下:
// IMyBookManager.aidl
package com.bwshen.aidlservice;
// Declare any non-default types here with import statements
import com.bwshen.aidlservice.Book;
//需要说明我们引入的book 是个序列化的类。
parcelable Book;
interface IMyBookManager
/**
* Demonstrates some basic types that you can use as parameters
* and return values in AIDL.
*/
void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat,double aDouble, String aString);
String login(String userName, String pwd);
Book queryByName(String bookName);
(3)创建图书类 book.java 文件,由于需要通过 AIDL 接口返回给调用者,所以这个类需要进行序列化,故需要实现 Parcelable 接口:
package com.bwshen.aidlservice;
import android.os.Parcel;
import android.os.Parcelable;
public class Book implements Parcelable
private int price;
private String name = "";
public Book()
protected Book(Parcel in)
price = in.readInt();
name = in.readString();
public static final Creator<Book> CREATOR = new Creator<Book>()
@Override
public Book createFromParcel(Parcel in)
return new Book(in);
@Override
public Book[] newArray(int size)
return new Book[size];
;
public int getPrice()
return price;
public void setPrice(int price)
this.price = price;
public String getName()
return name;
public void setName(String name)
this.name = name;
@Override
public String toString()
return "\\n图书名称:" + name + "\\n图书价格:" + price;
@Override
public int describeContents()
return 0;
@Override
public void writeToParcel(Parcel dest, int flags)
dest.writeInt(price);
dest.writeString(name);
(4)此时对项目进行编译 Build->Make Project,系统便会帮我们自动生成步骤 1 的图示所标出来的 com/bwshen/aidlservice/IMyBookManager.java 文件,该文件的内容及作用此处暂时先忽略,本文文末会单独重点分析。
(5)创建 AIDLService 类,并使用内部类 MyBookManager 继承 IMyBookManager.Stub、实现 IMyBookManager.aidl 对外提供的接口,并通过 service 的 onbind() 函数返回 MyBookManager 类的对象,如下:
package com.bwshen.aidlservice.service;
import android.app.Service;
import android.content.Intent;
import android.os.IBinder;
import android.os.RemoteException;
import com.bwshen.aidlservice.Book;
import com.bwshen.aidlservice.IMyBookManager;
public class AIDLService extends Service
MyBookManager bookManager = new MyBookManager();
public AIDLService()
@Override
public IBinder onBind(Intent intent)
return bookManager;
public class MyBookManager extends IMyBookManager.Stub
@Override
public void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat, double aDouble, String aString) throws RemoteException
@Override
public String login(String userName, String pwd) throws RemoteException
if(userName.equalsIgnoreCase("admin") && pwd.equalsIgnoreCase("123456"))
return "success";
return "error";
@Override
public Book queryByName(String bookName) throws RemoteException
Book book = new Book();
book.setName(bookName);
book.setPrice(100);
return book;
(6)最后在 AndroidManifest.xml 中将服务配置为远程服务:
<service
android:name=".service.AIDLService"
android:enabled="true"
android:exported="true"
android:process=":remote">
<intent-filter>
<action android:name="com.bwshen.aidlservice.bookService"/>
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</service>
至此,提供远程 Service 服务的 APP 准备完毕。可以修改下主活动的页面,展示如下:
AIDL Service客户端
搭建完远程 Service 服务端 APP,下面来搭建一个连接远程 Service 并调用服务接口实现登录、图书价格查询功能的客户端 APP。
(1)同样新建一个空 Activity 的 Android 项目 com.bwshen.aidlclient,先来看看最终项目完整的结构:
(2)由上可知整个项目中需要自行编写的三个文件(MainActivity.java、IMyBookManager.aidl、Book.java)有两个直接从服务端 APP 完整拷贝过来即可,而 IMyBookManager.java 文件则由编译项目时自动生成、无需理会,故这里主要看下 MainActivity 的代码(需注意下面代码会导入 import com.bwshen.aidlservice.IMyBookManager,故需要拷贝完 IMyBookManager.aidl 文件后先编译下项目):
package com.bwshen.aidlclient;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.ServiceConnection;
import android.os.Bundle;
import android.os.IBinder;
import android.os.RemoteException;
import android.text.method.ScrollingMovementMethod;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
import com.bwshen.aidlservice.Book;
import com.bwshen.aidlservice.IMyBookManager;
public class MainActivity extends AppCompatActivity
private Button btnConnection;
private EditText etName;
private EditText etPwd;
private Button btnLogin;
private TextView tvBookInfo;
private Button btnQuery;
private EditText etBookName;
private boolean islogin=false;
/**
* 该类的导入,需要先编译项目,将aidl文件进行编译后映射,才能成功识别并导出com.bwshen.aidlservice.IMyBookManager
*/
private IMyBookManager bookManager = null;
private ServiceConnection conn = new ServiceConnection()
@Override
public void onServiceConnected(ComponentName name, IBinder service)
bookManager = IMyBookManager.Stub.asInterface(service);
Toast.makeText(MainActivity.this, "服务连接成功!", Toast.LENGTH_SHORT).show();
@Override
public void onServiceDisconnected(ComponentName name)
bookManager = null;
;
@Override
protected void onCreate(Bundle savedInstanceState)
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
etBookName = findViewById(R.id.etBookName);
etName = findViewById(R.id.etName);
etPwd = findViewById(R.id.etPwd);
btnLogin = findViewById(R.id.btnLogin);
btnConnection = findViewById(R.id.btnConnection);
btnQuery = findViewById(R.id.btnQuery);
tvBookInfo = findViewById(R.id.tvBookInfo);
tvBookInfo.setMovementMethod(ScrollingMovementMethod.getInstance());
connect();
private void connect()
btnConnection.setOnClickListener(new View.OnClickListener()
@Override
public void onClick(View v)
if(bookManager != null)
Toast.makeText(MainActivity.this, "服务连接成功!", Toast.LENGTH_SHORT).show();
else
Intent intent = new Intent();
intent.setAction("com.bwshen.aidlservice.bookService");
intent.setPackage("com.bwshen.aidlservice");
bindService(intent, conn, Context.BIND_AUTO_CREATE);
);
btnLogin.setOnClickListener(new View.OnClickListener()
@Override
public void onClick(View v)
if(bookManager == null)
Toast.makeText(MainActivity.this, "还没有绑定服务!", Toast.LENGTH_SHORT).show();
return;
if(etName.getText().toString().isEmpty() || etPwd.getText().toString().isEmpty())
Toast.makeText(MainActivity.this, "用户名或密码不能为空!", Toast.LENGTH_SHORT).show();
return;
try
String resStr = bookManager.login(etName.getText().toString(), etPwd.getText().toString());
if(resStr.compareToIgnoreCase("success") == 0)
islogin=true;
Toast.makeText(MainActivity.this, "登录成功!", Toast.LENGTH_SHORT).show();
else
Toast.makeText(MainActivity.this, "登录失败!", Toast.LENGTH_SHORT).show();
throw new RemoteException("登录失败");
catch (RemoteException e)
e.printStackTrace();
Toast.makeText(MainActivity.this, "登录失败!", Toast.LENGTH_SHORT).show();
);
btnQuery.setOnClickListener(new View.OnClickListener()
@Override
public void onClick(View v)
if(bookManager == null || !islogin)
Toast.makeText(MainActivity.this, "请先绑定服务并登录!", Toast.LENGTH_LONG).show();
return;
if(etBookName.getText().toString().isEmpty())
Toast.makeText(MainActivity.this, "请输入您要查找的图书!", Toast.LENGTH_LONG).show();
return;
try
Book book = bookManager.queryByName(etBookName.getText().toString());
if(以上是关于基于AIDL编程实现Android远程Service服务的主要内容,如果未能解决你的问题,请参考以下文章