AIDL(Android Interface Definition Language捏卓,Android接口定義語(yǔ)言):如果在一個(gè)進(jìn)程中要調(diào)用另一個(gè)進(jìn)程中對(duì)象的方法铅檩,可使用AIDL生成可序列化的參數(shù)实胸,AIDL會(huì)生成一個(gè)服務(wù)端對(duì)象的代理類,通過(guò)它客戶端實(shí)現(xiàn)間接調(diào)用服務(wù)端對(duì)象的方法。
AIDL的本質(zhì)是系統(tǒng)提供了一套可快速實(shí)現(xiàn)Binder的工具晌缘。
關(guān)鍵類和方法:
- AIDL接口:繼承IInterface饰豺。
- Stub類:Binder的實(shí)現(xiàn)類亿鲜,服務(wù)端通過(guò)這個(gè)類來(lái)提供服務(wù)。
- Proxy類:服務(wù)器的本地代理冤吨,客戶端通過(guò)這個(gè)類調(diào)用服務(wù)器的方法蒿柳。
- asInterface():客戶端調(diào)用,將服務(wù)端的返回的Binder對(duì)象漩蟆,轉(zhuǎn)換成客戶端所需要的AIDL接口類型對(duì)象垒探。
返回對(duì)象:
若客戶端和服務(wù)端位于同一進(jìn)程,則直接返回Stub對(duì)象本身怠李;
若客戶端和服務(wù)端位于不同一進(jìn)程圾叼,返回的是系統(tǒng)封裝后的Stub.proxy對(duì)象。- asBinder():根據(jù)當(dāng)前調(diào)用情況返回代理Proxy的Binder對(duì)象捺癞。
- onTransact():運(yùn)行服務(wù)端的Binder線程池中夷蚊,當(dāng)客戶端發(fā)起跨進(jìn)程請(qǐng)求時(shí),遠(yuǎn)程請(qǐng)求會(huì)通過(guò)系統(tǒng)底層封裝后交由此方法來(lái)處理髓介。
transact():運(yùn)行在客戶端惕鼓,當(dāng)客戶端發(fā)起遠(yuǎn)程請(qǐng)求的同時(shí)將當(dāng)前線程掛起。之后調(diào)用服務(wù)端的onTransact()直到遠(yuǎn)程請(qǐng)求返回版保,當(dāng)前線程才繼續(xù)執(zhí)行呜笑。
如何使用AIDL
1.先建立兩個(gè)android項(xiàng)目
創(chuàng)建一個(gè)BinderA項(xiàng)目和一個(gè)BinderB工程,BinderA項(xiàng)目調(diào)用BinderB中提供的登錄接口彻犁,在BinderB中點(diǎn)擊登錄后叫胁,登錄之后不管是否成功,BinderB都會(huì)調(diào)用BinderA中登錄返回接口汞幢,這樣就實(shí)現(xiàn)了一個(gè)雙向的通信驼鹅。
2、創(chuàng)建一個(gè)包名用來(lái)存放aidl文件
創(chuàng)建一個(gè)包名用來(lái)存放aidl文件,比如com.migill.binder森篷,在里面新建ILoginInterface.aidl文件输钩,如果需要訪問(wèn)自定義對(duì)象,還需要建立對(duì)象的aidl文件仲智,這里我們由于使用了自定義對(duì)象LoginUser买乃,所以,還需要?jiǎng)?chuàng)建LoginUser.aidl和LoginUser.java钓辆。注意剪验,這三個(gè)文件肴焊,需要都放在com.migill.binder包里。而且ILoginInterface.aidl功戚,LoginUser.aidl娶眷,LoginUser.java這三個(gè)文件在BinderA與BinderB項(xiàng)目中是一樣的。下面描述如何寫(xiě)這三個(gè)文件啸臀。
客戶端中的aidl文件與服務(wù)端中的aidl文件的包名要一樣届宠,在創(chuàng)建客戶端AIDL文件的時(shí)候是不需要把服務(wù)端提供的接口都添加進(jìn)來(lái),只需要添加需要的接口就好了
// ILoginInterface.aidl
package com.migill.binder;
import com.migill.binder.LoginUser;
interface ILoginInterface {
// 登錄
void login();
// 登錄返回
void loginCallback(boolean loginStatus, inout LoginUser loginUser);
}
說(shuō)明:
aidl中支持的參數(shù)類型為:
- 基本類型(ibyte乘粒,int豌注,long,float谓厘,double幌羞,boolean,char),String類型,CharSequence類型,List,Map竟稳。
- 其他類型必須使用import導(dǎo)入属桦,即使它們可能在同一個(gè)包里,比如這里的LoginUser他爸,盡管它和ILoginInterface在同一個(gè)包中聂宾,但是還是需要顯示的import進(jìn)來(lái)。另外诊笤,接口中的參數(shù)除了aidl支持的類型系谐,其他類型必須標(biāo)識(shí)其方向:到底是輸入還是輸出抑或兩者兼之,用in讨跟,out或者inout來(lái)表示纪他,上面的代碼我們用inout標(biāo)記,其實(shí)用in就可以晾匠,因?yàn)樗禽斎胄蛥?shù)(我的理解是BinderB現(xiàn)在是客戶端茶袒,BinderA是服務(wù)端,BinderB中的數(shù)據(jù)流入BinderA中凉馆,所以是入型參數(shù))薪寓。
在gen下面可以看到,AS為我們自動(dòng)生成了一個(gè)代理類
public static abstract class Stub extends android.os.Binder implements com.migill.binder.ILoginInterface
可見(jiàn)這個(gè)Stub類就是一個(gè)普通的Binder澜共,只不過(guò)它實(shí)現(xiàn)了我們定義的aidl接口向叉。
它還有一個(gè)靜態(tài)方法public static com.migill.binder.ILoginInterface asInterface(android.os.IBinder obj)
這個(gè)方法很有用,通過(guò)它嗦董,我們就可以在客戶端中得到MyService的實(shí)例母谎,進(jìn)而通過(guò)實(shí)例來(lái)調(diào)用其方法。
// LoginUser.aidl
package com.migill.binder;
parcelable LoginUser;
package com.migill.binder;
import android.os.Parcel;
import android.os.Parcelable;
import java.util.Locale;
public final class LoginUser implements Parcelable {
public String userName;
public String userPassWord;
public LoginUser() {
}
protected LoginUser(Parcel in) {
readFromParcel(in);
}
public void readFromParcel(Parcel in) {
userName = in.readString();
userPassWord = in.readString();
}
public static final Creator<LoginUser> CREATOR = new Creator<LoginUser>() {
@Override
public LoginUser createFromParcel(Parcel in) {
return new LoginUser(in);
}
@Override
public LoginUser[] newArray(int size) {
return new LoginUser[size];
}
};
public String getUserName() {
return userName;
}
public void setUserName(String userName) {
this.userName = userName;
}
public String getUserPassWord() {
return userPassWord;
}
public void setUserPassWord(String userPassWord) {
this.userPassWord = userPassWord;
}
@Override
public int describeContents() {
return 0;
}
@Override
public void writeToParcel(Parcel dest, int flags) {
dest.writeString(userName);
dest.writeString(userPassWord);
}
@Override
public String toString() {
return String.format(Locale.ENGLISH, "[ %s, %s ]", userName, userPassWord);
}
}
3.BinderA項(xiàng)目
MyService.java中的loginCallback()中發(fā)送了一個(gè)廣播京革,廣播在LoginActivity中接收销睁。
有個(gè)問(wèn)題就是有可能你的service只想讓某個(gè)特定的apk使用供璧,而不是所有apk都能使用,這個(gè)時(shí)候冻记,你需要重寫(xiě)Stub中的onTransact方法,根據(jù)調(diào)用者的uid來(lái)獲得其信息来惧,然后做權(quán)限認(rèn)證冗栗,如果返回true,則調(diào)用成功供搀,否則調(diào)用會(huì)失敗隅居。對(duì)于其他apk,你只要在onTransact中返回false就可以讓其無(wú)法調(diào)用MyService中的方法葛虐,這樣就可以解決這個(gè)問(wèn)題了胎源。
public class MyService extends Service {
private static String TAG = "migill_A";
private static final String PACKAGE_SAYHI = "com.migill.binder.b";
@Override
public IBinder onBind(Intent intent) {
return new ILoginInterface.Stub() {
@Override
public void login() throws RemoteException {
}
@Override
public void loginCallback(boolean loginStatus, LoginUser loginUser) throws RemoteException {
Log.e(TAG, "loginStatus: " + loginStatus + " / LoginUser: " + loginUser.toString());
sendLoginCallBackBrodcast(loginStatus, loginUser);
}
//在這里可以做權(quán)限認(rèn)證,return false意味著客戶端的調(diào)用就會(huì)失敗屿脐,比如下面涕蚤,只允許包名為com.migill.binder.a的客戶端通過(guò),
//其他apk將無(wú)法完成調(diào)用過(guò)程
public boolean onTransact(int code, Parcel data, Parcel reply, int flags)
throws RemoteException {
String packageName = null;
String[] packages = MyService.this.getPackageManager().
getPackagesForUid(getCallingUid());
if (packages != null && packages.length > 0) {
packageName = packages[0];
}
Log.e(TAG, "onTransact: " + packageName);
if (!PACKAGE_SAYHI.equals(packageName)) {
return false;
}
return super.onTransact(code, data, reply, flags);
}
};
}
private void sendLoginCallBackBrodcast(boolean loginStatus, LoginUser loginUser) {
Intent intent = new Intent("com.migill.binder.a.LOGINCAKKBACK_STATE");
intent.putExtra("loginStatus", loginStatus);
intent.putExtra("loginUser", loginUser);
sendBroadcast(intent);
}
}
AndroidManifest.xml中添加service標(biāo)簽
<!--
代表在應(yīng)用程序里的诵,當(dāng)需要該service時(shí)万栅,會(huì)自動(dòng)創(chuàng)建新的進(jìn)程。
android:process=":remote"
是否可以被系統(tǒng)實(shí)例化
android:enabled="true"
代表是否能被其他應(yīng)用隱式調(diào)用
android:exported="true"
-->
<service
android:name=".service.MyService"
android:enabled="true"
android:exported="true"
android:process=":remote">
<intent-filter>
<!-- 激活 MyService 唯一name西疤,不能重名 -->
<action android:name="BinderA_Action" />
</intent-filter>
</service>
LoginActivity綁定BinderB提供的服務(wù)烦粒,在點(diǎn)擊QQ按鈕的時(shí)候,調(diào)用BinderB中提供的登錄接口代赁。在LoginActivity定義了一個(gè)廣播接受者扰她,用于接收BinderB返回的登錄結(jié)果
public class LoginActivity extends Activity {
private static String TAG = "migill_A";
private boolean isStartRemote; // 是否開(kāi)啟跨進(jìn)程通信
private ILoginInterface iLogin; // AIDL定義接口
LoginCallbackReceiver loginCallbackReceiver;
TextView tvLogincallback;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
requestWindowFeature(Window.FEATURE_NO_TITLE); // 隱藏標(biāo)題
getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
WindowManager.LayoutParams.FLAG_FULLSCREEN); // 設(shè)置全屏
setContentView(R.layout.activity_login);
tvLogincallback = findViewById(R.id.tv_logincallback);
initBindService();//初始化
RegisterBroadcast();
}
public void RegisterBroadcast() {
IntentFilter filter = new IntentFilter();
filter.addAction("com.migill.binder.a.LOGINCAKKBACK_STATE");
loginCallbackReceiver = new LoginCallbackReceiver();
registerReceiver(loginCallbackReceiver, filter);
}
// 點(diǎn)擊事件
public void startQQLoginAction(View view) {
if (iLogin != null) {
try {
// 調(diào)用Server方法
iLogin.login();
} catch (RemoteException e) {
e.printStackTrace();
}
} else {
Toast.makeText(this, "請(qǐng)安裝QQ應(yīng)用...", Toast.LENGTH_SHORT).show();
}
}
public void initBindService() {
Intent intent = new Intent();
// 設(shè)置Server應(yīng)用Action
intent.setAction("BinderB_Action");
// 設(shè)置Server應(yīng)用包名(5.1+要求)
intent.setPackage("com.migill.binder.b");
// 開(kāi)始綁定服務(wù)
bindService(intent, conn, BIND_AUTO_CREATE);
// 標(biāo)識(shí)跨進(jìn)程綁定
isStartRemote = true;
}
// 服務(wù)連接
private ServiceConnection conn = new ServiceConnection() {
@Override
public void onServiceConnected(ComponentName name, IBinder service) {
iLogin = ILoginInterface.Stub.asInterface(service);
}
@Override
public void onServiceDisconnected(ComponentName name) {
}
};
@Override
protected void onDestroy() {
super.onDestroy();
if (isStartRemote) {
// 解綁服務(wù),一定要記得解綁服務(wù)芭碍,否則可能會(huì)報(bào)異常(服務(wù)連接資源異常)
unbindService(conn);
}
unregisterReceiver(loginCallbackReceiver);
}
private void LoginCallback(boolean loginStatus, LoginUser loginUser) {
Log.e(TAG, "LoginCallback loginStatus: " + loginStatus + " / LoginUser: " + loginUser.toString());
tvLogincallback.setText("登錄結(jié)果: " + (loginStatus==true?"登錄成功":"登錄失敗") + "\n" +
"LoginUser: " + loginUser.toString());
}
private final class LoginCallbackReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
boolean loginStatus = intent.getBooleanExtra("loginStatus", false);
LoginUser loginUser = (LoginUser) intent.getParcelableExtra("loginUser");
LoginCallback(loginStatus, loginUser);
}
}
}
4.BinderB項(xiàng)目
MyService.java中在login()中啟動(dòng)了MainActivity徒役。
public class MyService extends Service {
private static String TAG = "migill_B";
private static final String PACKAGE_SAYHI = "com.migill.binder.a";
@Override
public IBinder onBind(Intent intent) {
return new ILoginInterface.Stub() {
@Override
public void login() throws RemoteException {
Log.e(TAG, "BinderB_MyService");
// 單項(xiàng)通信有問(wèn)題,真實(shí)項(xiàng)目雙向通信豁跑,雙服務(wù)綁定
serviceStartActivity();
}
@Override
public void loginCallback(boolean loginStatus, LoginUser loginUser) throws RemoteException {
}
//在這里可以做權(quán)限認(rèn)證廉涕,return false意味著客戶端的調(diào)用就會(huì)失敗,比如下面艇拍,只允許包名為com.migill.binder.a的客戶端通過(guò)狐蜕,
//其他apk將無(wú)法完成調(diào)用過(guò)程
public boolean onTransact(int code, Parcel data, Parcel reply, int flags)
throws RemoteException {
String packageName = null;
String[] packages = MyService.this.getPackageManager().
getPackagesForUid(getCallingUid());
if (packages != null && packages.length > 0) {
packageName = packages[0];
}
Log.e(TAG, "onTransact: " + packageName);
if (!PACKAGE_SAYHI.equals(packageName)) {
return false;
}
return super.onTransact(code, data, reply, flags);
}
};
}
/**
* 在Service啟動(dòng)Activity,需要配置:.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
*/
private void serviceStartActivity() {
Intent intent = new Intent(this, MainActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
startActivity(intent);
}
}
AndroidManifest.xml中添加service標(biāo)簽
<!--
代表在應(yīng)用程序里卸夕,當(dāng)需要該service時(shí)层释,會(huì)自動(dòng)創(chuàng)建新的進(jìn)程。
android:process=":remote"
是否可以被系統(tǒng)實(shí)例化
android:enabled="true"
代表是否能被其他應(yīng)用隱式調(diào)用
android:exported="true"
-->
<service
android:name="com.migill.binder.b.service.MyService"
android:enabled="true"
android:exported="true"
android:process=":remote_service">
<intent-filter>
<!-- 激活 MyService 唯一name快集,不能重名-->
<action android:name="BinderB_Action" />
</intent-filter>
</service>
BinderA調(diào)用了BinderB提供的登錄接口贡羔,BinderB的登錄接口執(zhí)行啟動(dòng)MainActivity廉白,在BinderB項(xiàng)目的MainActivity中綁定了BinderA中提供的服務(wù)。在點(diǎn)擊登錄的時(shí)候乖寒,在調(diào)用BidnerA中登錄返回接口猴蹂。
public class MainActivity extends Activity {
private static String TAG = "migill_B";
// 模擬用戶名和密碼 的值
private final static String NAME = "migill";
private final static String PWD = "123";
private EditText nameEt;
private EditText pwdEt;
private boolean isStartRemote; // 是否開(kāi)啟跨進(jìn)程通信
private ILoginInterface iLogin; // AIDL定義接口
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
requestWindowFeature(Window.FEATURE_NO_TITLE); // 隱藏標(biāo)題
getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
WindowManager.LayoutParams.FLAG_FULLSCREEN); // 設(shè)置全屏
setContentView(R.layout.activity_main);
nameEt = findViewById(R.id.nameEt);
pwdEt = findViewById(R.id.pwdEt);
initBindService();
}
public void initBindService() {
Intent intent = new Intent();
// 設(shè)置Server應(yīng)用Action
intent.setAction("BinderA_Action");
// 設(shè)置Server應(yīng)用包名(5.1+要求)
intent.setPackage("com.migill.binder.a");
// 開(kāi)始綁定服務(wù)
bindService(intent, conn, BIND_AUTO_CREATE);
// 標(biāo)識(shí)跨進(jìn)程綁定
isStartRemote = true;
}
// 服務(wù)連接
private ServiceConnection conn = new ServiceConnection() {
@Override
public void onServiceConnected(ComponentName name, IBinder service) {
//將服務(wù)端的返回的Binder對(duì)象,轉(zhuǎn)換成客戶端所需要的AIDL接口類型對(duì)象楣嘁。
//返回對(duì)象:
//若客戶端和服務(wù)端位于同一進(jìn)程磅轻,則直接返回Stub對(duì)象本身;
//若客戶端和服務(wù)端位于不同一進(jìn)程逐虚,返回的是系統(tǒng)封裝后的Stub.proxy對(duì)象聋溜。
iLogin = ILoginInterface.Stub.asInterface(service);
}
@Override
public void onServiceDisconnected(ComponentName name) {
}
};
// 點(diǎn)擊事件
public void startLogin(View view) {
final String name = nameEt.getText().toString();
final String pwd = pwdEt.getText().toString();
if (TextUtils.isEmpty(name) || TextUtils.isEmpty(pwd)) {
showToast("請(qǐng)輸入用戶名或密碼...");
return;
}
// 模擬登錄狀態(tài)加載...
final ProgressDialog progressDialog = new ProgressDialog(this);
progressDialog.setTitle("登錄");
progressDialog.setMessage("正在登錄中...");
progressDialog.show();
new Thread(new Runnable() {
@Override
public void run() {
SystemClock.sleep(1000);
runOnUiThread(new Runnable() {
@Override
public void run() {
try {
boolean isLoginSuccess = false;
if (NAME.equals(name) && PWD.equals(pwd)) {
showToast("QQ登錄成功!");
isLoginSuccess = true;
finish();
} else {
showToast("QQ登錄失敗!");
progressDialog.dismiss();
}
LoginUser loginUser = new LoginUser();
loginUser.userName = name;
loginUser.userPassWord = pwd;
iLogin.loginCallback(isLoginSuccess, loginUser);
} catch (RemoteException e) {
e.printStackTrace();
}
}
});
}
}).start();
}
private void showToast(String text) {
Toast.makeText(this, text, Toast.LENGTH_SHORT).show();
}
@Override
protected void onDestroy() {
super.onDestroy();
if (isStartRemote) {
// 解綁服務(wù),一定要記得解綁服務(wù)叭爱,否則可能會(huì)報(bào)異常(服務(wù)連接資源異常)
unbindService(conn);
}
}
}
總結(jié):我們要先安裝BinderB項(xiàng)目撮躁,這樣BinderB就會(huì)在ServiceManager中進(jìn)行注冊(cè)。BinderA就可以在ServiceManager中通過(guò)名字查找买雾,獲取Binder對(duì)象把曼。