萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android AIDL 跨進程通訊 (IPC) 實戰:傳遞基本類型完整教學

什麼是 AIDL?

AIDL (Android Interface Definition Language) 定義跨進程通訊介面。編譯器自動生成實現 IBinder 的 Stub 類,處理序列化/反序列化 (marshalling),讓客戶端像呼叫本地方法一樣呼叫遠端 Service 方法。

AIDL 語法規則

  • 副檔名 .aidl,置於 src/main/aidl/ (Gradle 自動識別)。
  • 定義介面,無需 public/private,預設公開。
  • **預設支援類型**:基本型別、String、CharSequence、List、Map (元素需為支援類型)、Parcelable 實現類、其他 AIDL 介面。
  • 參數方向標籤:in (預設)、out、inout,指定資料流向優化序列化。

步驟 1:定義 AIDL 介面

src/main/aidl/com/example/aidlservicedemo/domain/IDog.aidl

package com.example.aidlservicedemo.domain;

interface IDog {
    String getName();
    int getAge();
}

步驟 2:Service 實現 Stub

public class BaseTypeService extends Service {
    private static final String TAG = "AIDLService";
    private final IDog.Stub binder = new IDog.Stub() {
        private final String[] names = {"小白", "旺財", "小黑"};
        private final int[] ages = {1, 2, 3};
        private final Random random = new Random();

        @Override public String getName() throws RemoteException {
            return names[random.nextInt(names.length)];
        }

        @Override public int getAge() throws RemoteException {
            return ages[random.nextInt(ages.length)];
        }
    };

    @Override public void onCreate() {
        super.onCreate();
        Log.i(TAG, "Service Created");
    }

    @Override public IBinder onBind(Intent intent) {
        Log.i(TAG, "Client Bound");
        return binder;
    }
}

步驟 3:Manifest 宣告 Service (需 exported=true 供跨應用)

<service
    android:name=".BaseTypeService"
    android:exported="true"
    android:process=":remote"> <!-- 獨立進程模擬跨進程 -->
    <intent-filter>
        <action android:name="com.example.aidlservicedemo.BaseTypeService" />
    </intent-filter>
</service>

步驟 4:客戶端綁定並呼叫

public class BaseTypeActivity extends AppCompatActivity {
    private IDog dogService;
    private final ServiceConnection conn = new ServiceConnection() {
        @Override public void onServiceConnected(ComponentName name, IBinder binder) {
            dogService = IDog.Stub.asInterface(binder); // 關鍵:轉為介面代理
            Toast.makeText(BaseTypeActivity.this, "服務連線成功", Toast.LENGTH_SHORT).show();
        }
        @Override public void onServiceDisconnected(ComponentName name) {
            dogService = null;
        }
    };

    @Override protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_service);

        findViewById(R.id.btn_bind).setOnClickListener(v -> {
            Intent intent = new Intent("com.example.aidlservicedemo.BaseTypeService");
            intent.setPackage("com.example.aidlservicedemo"); // 顯式 Intent
            bindService(intent, conn, Context.BIND_AUTO_CREATE);
        });

        findViewById(R.id.btn_unbind).setOnClickListener(v -> {
            if (dogService != null) {
                unbindService(conn);
                dogService = null;
            }
        });

        findViewById(R.id.btn_get).setOnClickListener(v -> {
            if (dogService == null) {
                Toast.makeText(this, "請先綁定服務", Toast.LENGTH_SHORT).show();
                return;
            }
            try {
                String name = dogService.getName();
                int age = dogService.getAge();
                Toast.makeText(this, "Name: " + name + ", Age: " + age, Toast.LENGTH_SHORT).show();
            } catch (RemoteException e) {
                Log.e("Client", "遠端呼叫失敗", e);
                Toast.makeText(this, "呼叫失敗:" + e.getMessage(), Toast.LENGTH_SHORT).show();
            }
        });
    }

    @Override protected void onDestroy() {
        super.onDestroy();
        if (dogService != null) unbindService(conn);
    }
}

關鍵點總結

  1. 同一 AIDL 文件:服務端與客戶端**必須擁有完全相同的 .aidl 文件** (包名、介面名、方法簽名),建議建立共用 Module 或手動複製。
  2. Stub.asInterface():將 IBinder 轉為介面代理,內部實現 transact() 跨進程通訊。
  3. RemoteException:所有遠端呼叫必須捕獲,進程死亡、超時、序列化失敗皆拋出此異常。
  4. 單向調用:若方法回傳 void 且標註 oneway,呼叫端不阻塞,系統佇列處理 (僅適用 Service 同進程或特定場景)。

進階:自動生成代碼結構解析

編譯後 gen/.../IDog.java 包含:

  • 介面 IDog (原定義)
  • 抽象類 Stub extends Binder implements IDog:實現 onTransact() 解析 Parcel、分發呼叫、回寫結果。
  • 代理類 Proxy implements IDog:客戶端持有,將呼叫封裝為 Parcel 發送。

現代替代:Binder 直接使用或 Messenger

簡單單向訊息可用 Messenger (內部封裝 Handler),無需編寫 AIDL。複雜高效能場景可直接繼承 Binder 實現自訂協議。

copyright © 萬盛學電腦網 all rights reserved