AIDL学习

Faiz..

于 2025-08-05 22:05:56 发布

阅读量346

点赞数 12

CC 4.0 BY-SA版权

文章标签：学习

本文链接：https://blog.youkuaiyun.com/decade777555/article/details/149906878

一、项目准备

1. 创建主项目（服务端 + 客户端可在同一项目，也可分开，这里以单项目多模块为例）

2. 在 Manifest 中注册 Service（关键：指定独立进程）

四、编写客户端 Activity（绑定服务并通信）

阶段 3：客户端绑定服务（跨进程连接建立）

一、项目准备

1. 创建主项目（服务端 + 客户端可在同一项目，也可分开，这里以单项目多模块为例）

打开 Android Studio，新建 Empty Activity 项目，命名为 AIDLDemo，包名默认 com.example.aidldemo，语言选 Java。
项目结构采用 单应用内跨进程（通过不同进程启动服务），无需创建多模块。

二、创建 AIDL 接口文件（核心步骤）

AIDL 文件是跨进程通信的 “协议”，服务端和客户端需完全一致（包名、内容）。

1. 创建 AIDL 目录和文件

路径：在 app/src/main 目录右键 → New → Folder → AIDL Folder，默认路径即可（自动生成 aidl 目录）。
在 aidl 目录下创建与 Java 代码相同的包名（保持包结构一致）：
右键 aidl → New → Package，输入 com.example.aidldemo。
在该包下创建 AIDL 接口文件：
右键包名 → New → AIDL File，命名为 IMyAidlInterface.aidl。

2. 编写 AIDL 接口内容

文件路径：app/src/main/aidl/com/example/aidldemo/IMyAidlInterface.aidl

// IMyAidlInterface.aidl
package com.example.aidldemo;

// 定义跨进程调用的接口方法
interface IMyAidlInterface {
    // 示例：加法计算
    int add(int a, int b);
    // 示例：获取服务端信息
    String getServiceInfo();
}

3. 同步 AIDL 文件

点击菜单栏 Build → Make Project，系统会自动在 app/build/generated/aidl_source_output_dir 目录生成对应的 Java 接口文件（无需手动修改）。

三、实现服务端 Service

服务端需创建 Service 并实现 AIDL 接口，通过 onBind 返回接口实例。

1. 创建 Service 类

文件路径：app/src/main/java/com/example/aidldemo/MyAidlService.java

package com.example.aidldemo;

import android.app.Service;
import android.content.Intent;
import android.os.IBinder;
import android.os.RemoteException;
import android.util.Log;

// 服务端 Service，实现 AIDL 接口
public class MyAidlService extends Service {
    private static final String TAG = "MyAidlService";

    // 创建 AIDL 接口的实现类（Stub 是自动生成的抽象类）
    private final IMyAidlInterface.Stub mBinder = new IMyAidlInterface.Stub() {
        @Override
        public int add(int a, int b) throws RemoteException {
            Log.d(TAG, "客户端调用 add 方法：a=" + a + ", b=" + b);
            return a + b; // 实现加法逻辑
        }

        @Override
        public String getServiceInfo() throws RemoteException {
            Log.d(TAG, "客户端调用 getServiceInfo 方法");
            return "这是来自服务端的消息：AIDL 通信成功！";
        }
    };

    @Override
    public void onCreate() {
        super.onCreate();
        Log.d(TAG, "Service 已创建");
    }

    // 返回 AIDL 接口实例，供客户端绑定
    @Override
    public IBinder onBind(Intent intent) {
        Log.d(TAG, "客户端绑定服务");
        return mBinder;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        Log.d(TAG, "Service 已销毁");
    }
}

2. 在 Manifest 中注册 Service（关键：指定独立进程）

文件路径：app/src/main/AndroidManifest.xml
在 <application> 标签内添加 Service 声明，并通过 android:process 指定独立进程（模拟跨进程场景）：

<service
    android:name=".MyAidlService"
    android:enabled="true"
    android:exported="true"
    android:process=":remote"> <!-- 关键：指定独立进程，名称任意，以冒号开头表示私有进程 -->
    <intent-filter>
        <action android:name="com.example.aidldemo.AIDL_SERVICE" /> <!-- 自定义 Action，供客户端绑定 -->
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</service>

四、编写客户端 Activity（绑定服务并通信）

客户端需绑定服务端 Service，通过 AIDL 接口调用服务端方法。

1. 创建布局文件

文件路径：app/src/main/res/layout/activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="20dp"
    android:gravity="center_horizontal">

    <Button
        android:id="@+id/btn_bind"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="绑定服务" />

    <Button
        android:id="@+id/btn_add"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="调用加法方法"
        android:layout_marginTop="20dp" />

    <Button
        android:id="@+id/btn_get_info"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="获取服务信息"
        android:layout_marginTop="20dp" />

    <TextView
        android:id="@+id/tv_result"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:textSize="16sp" />
</LinearLayout>

2. 编写客户端 Activity 代码

文件路径：app/src/main/java/com/example/aidldemo/MainActivity.java

package com.example.aidldemo;

import android.content.ComponentName;
import android.content.Intent;
import android.content.ServiceConnection;
import android.os.Bundle;
import android.os.IBinder;
import android.os.RemoteException;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;

import androidx.appcompat.app.AppCompatActivity;

// 客户端 Activity，绑定服务并通过 AIDL 通信
public class MainActivity extends AppCompatActivity {
    private static final String TAG = "MainActivity";
    private IMyAidlInterface mAidlInterface; // AIDL 接口实例
    private boolean isBound = false; // 服务是否已绑定
    private TextView tvResult;

    // 服务连接回调，监控绑定状态
    private ServiceConnection mServiceConnection = new ServiceConnection() {
        @Override
        public void onServiceConnected(ComponentName name, IBinder service) {
            // 绑定成功：通过 IBinder 获取 AIDL 接口实例
            mAidlInterface = IMyAidlInterface.Stub.asInterface(service);
            isBound = true;
            Log.d(TAG, "服务绑定成功");
            tvResult.setText("服务绑定成功，可调用方法");
        }

        @Override
        public void onServiceDisconnected(ComponentName name) {
            // 服务意外断开（如崩溃）
            mAidlInterface = null;
            isBound = false;
            Log.d(TAG, "服务断开连接");
            tvResult.setText("服务已断开");
        }
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        tvResult = findViewById(R.id.tv_result);

        // 绑定服务按钮
        findViewById(R.id.btn_bind).setOnClickListener(v -> bindToService());

        // 调用加法方法按钮
        findViewById(R.id.btn_add).setOnClickListener(v -> callAddMethod());

        // 获取服务信息按钮
        findViewById(R.id.btn_get_info).setOnClickListener(v -> callGetInfoMethod());
    }

    // 绑定服务端 Service
    private void bindToService() {
        if (isBound) {
            Toast.makeText(this, "服务已绑定", Toast.LENGTH_SHORT).show();
            return;
        }
        Intent intent = new Intent();
        intent.setAction("com.example.aidldemo.AIDL_SERVICE"); // 与 Manifest 中声明的 Action 一致
        intent.setPackage(getPackageName()); // 指定服务端包名（当前应用包名）
        // 绑定服务：BIND_AUTO_CREATE 表示若服务未启动则自动创建
        bindService(intent, mServiceConnection, BIND_AUTO_CREATE);
    }

    // 调用服务端的 add 方法
    private void callAddMethod() {
        if (!isBound || mAidlInterface == null) {
            Toast.makeText(this, "请先绑定服务", Toast.LENGTH_SHORT).show();
            return;
        }
        try {
            int result = mAidlInterface.add(100, 200); // 跨进程调用加法
            String text = "100 + 200 = " + result;
            tvResult.setText(text);
            Log.d(TAG, text);
        } catch (RemoteException e) {
            e.printStackTrace();
            tvResult.setText("调用 add 方法失败：" + e.getMessage());
        }
    }

    // 调用服务端的 getServiceInfo 方法
    private void callGetInfoMethod() {
        if (!isBound || mAidlInterface == null) {
            Toast.makeText(this, "请先绑定服务", Toast.LENGTH_SHORT).show();
            return;
        }
        try {
            String info = mAidlInterface.getServiceInfo(); // 跨进程调用获取信息
            tvResult.setText(info);
            Log.d(TAG, "服务信息：" + info);
        } catch (RemoteException e) {
            e.printStackTrace();
            tvResult.setText("调用 getServiceInfo 方法失败：" + e.getMessage());
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 解绑服务，避免内存泄漏
        if (isBound) {
            unbindService(mServiceConnection);
            isBound = false;
            Log.d(TAG, "服务已解绑");
        }
    }
}

五、运行与验证

1. 运行项目

点击 Android Studio 运行按钮，将应用安装到模拟器或真机。