1. 為什么 Android 進(jìn)程間通信總在真機(jī)聯(lián)調(diào)時(shí)翻車(chē)Android 進(jìn)程間通信IPCInter-Process Communication底層跑的是 Binder 機(jī)制應(yīng)用層能摸到的入口其實(shí)就三類(lèi)Intent 傳參、Messenger 輕量跨進(jìn)程、AIDL 復(fù)雜接口。Intent 適合 Activity/Service/Broadcast 之間丟一個(gè) Bundle 就走M(jìn)essenger 把 Binder 包了一層 Handler-Message天然串行、不用自己寫(xiě) .aidlAIDL 則是給需要并發(fā)、需要回調(diào)、需要傳 Parcelable 對(duì)象的場(chǎng)景準(zhǔn)備的。問(wèn)題在于很多人本地寫(xiě)完 Demo 能跑一上真機(jī)、一拆多進(jìn)程就出問(wèn)題android:process配了但 Service 沒(méi)起來(lái)、Messenger 的replyTo忘了賦值導(dǎo)致服務(wù)端回不了消息、AIDL 的 Parcelable 類(lèi)沒(méi)在 aidl 目錄聲明、oneway用錯(cuò)方向把主線程卡死。更麻煩的是跨進(jìn)程調(diào)用往往還要連一個(gè)遠(yuǎn)端能力比如模型推理、統(tǒng)一鑒權(quán)Key 散落在客戶(hù)端和服務(wù)端兩邊聯(lián)調(diào)時(shí)根本不知道是哪一段斷的。這篇就按 Intent → Messenger → AIDL 三條鏈路把可復(fù)制的 AndroidManifest、AIDL 骨架、Messenger 回調(diào)配置全部給出來(lái)并且用 TaoToken 的統(tǒng)一 Key/API 通道做一次端到端驗(yàn)證讓你能確認(rèn)「跨進(jìn)程調(diào)用 遠(yuǎn)端請(qǐng)求」整條鏈路是通的。適合已經(jīng)會(huì)寫(xiě) Service、但一碰多進(jìn)程就頭大的 Android 開(kāi)發(fā)者。2. 先把 TaoToken 的 Key 通道準(zhǔn)備好跨進(jìn)程驗(yàn)證最怕的就是「本地 IPC 通了但遠(yuǎn)端 401」。所以先把統(tǒng)一 Key 通道搭好后面三條鏈路都復(fù)用它。TaoToken 在這里扮演的角色是你不需要在客戶(hù)端和服務(wù)端各維護(hù)一套模型/接口憑證而是通過(guò)一個(gè)統(tǒng)一的 API 通道去調(diào)用。官網(wǎng)入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 這個(gè)不加 UTM。操作順序是這樣的先登錄控制臺(tái) https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 頁(yè)面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 創(chuàng)建一個(gè) Key。這個(gè) Key 就是后面客戶(hù)端跨進(jìn)程調(diào)用時(shí)攜帶的憑證。注意Key 不要硬編碼進(jìn) AIDL 接口或 Messenger 的 Bundle 里明文傳遞。正確做法是客戶(hù)端持有 Key服務(wù)端只負(fù)責(zé)轉(zhuǎn)發(fā)請(qǐng)求或者由服務(wù)端統(tǒng)一持有、客戶(hù)端通過(guò) IPC 請(qǐng)求服務(wù)端代發(fā)。本文為了演示鏈路采用「客戶(hù)端持有 Key通過(guò) IPC 把請(qǐng)求參數(shù)傳給服務(wù)端服務(wù)端代發(fā)」的方式。如果你只是想先驗(yàn)證模型通道是否可用可以直接用模型對(duì)話頁(yè)面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 發(fā)一條消息確認(rèn) Key 有效。長(zhǎng)期做編碼類(lèi) Agent 的可以看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入細(xì)節(jié)都在文檔 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里。3. 可復(fù)制配置Manifest、Messenger 回調(diào)、AIDL 骨架3.1 AndroidManifest 多進(jìn)程配置先讓 Service 跑在獨(dú)立進(jìn)程這是所有 IPC 驗(yàn)證的前提。manifest xmlns:androidhttp://schemas.android.com/apk/res/android packagecom.example.ipcdemo application android:allowBackuptrue android:labelIpcDemo !-- 主進(jìn)程 Activity -- activity android:name.ClientActivity intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity !-- Messenger 服務(wù)端獨(dú)立進(jìn)程 -- service android:name.messenger.ServerService android:process:remote_messenger android:exportedfalse / !-- AIDL 服務(wù)端獨(dú)立進(jìn)程 -- service android:name.aidl.AidlServerService android:process:remote_aidl android:exportedfalse intent-filter action android:namecom.example.ipcdemo.aidl.ServerService / /intent-filter /service /application /manifestandroid:process:remote_messenger里的冒號(hào)表示這是應(yīng)用私有進(jìn)程不會(huì)和其他應(yīng)用沖突。exportedfalse保證只有本應(yīng)用能綁定避免被外部應(yīng)用調(diào)用。3.2 Messenger 回調(diào)配置Messenger 的核心是「雙向信使」客戶(hù)端拿服務(wù)端的 Messenger 發(fā)請(qǐng)求服務(wù)端拿客戶(hù)端的replyTo回消息。服務(wù)端代碼public class ServerService extends Service { public static final int MSG_BIND 0; public static final int MSG_SAY_HELLO 1; private Messenger sMessenger; private Messenger cMessenger; Override public void onCreate() { super.onCreate(); sMessenger new Messenger(new ServerHandler(getMainLooper())); } Override public IBinder onBind(Intent intent) { return sMessenger.getBinder(); } class ServerHandler extends Handler { ServerHandler(Looper looper) { super(looper); } Override public void handleMessage(Message msg) { switch (msg.what) { case MSG_BIND: cMessenger msg.replyTo; reply(MSG_BIND, server: connect succeed); break; case MSG_SAY_HELLO: reply(MSG_SAY_HELLO, server: hello from remote process); break; default: super.handleMessage(msg); } } } private void reply(int what, String content) { if (cMessenger null) return; Bundle data new Bundle(); data.putString(content, content); Message msg Message.obtain(null, what); msg.setData(data); try { cMessenger.send(msg); } catch (RemoteException e) { e.printStackTrace(); } } }客戶(hù)端綁定并設(shè)置replyToprivate final ServiceConnection conn new ServiceConnection() { Override public void onServiceConnected(ComponentName name, IBinder service) { sMessenger new Messenger(service); cMessenger new Messenger(new ClientHandler(getMainLooper())); Message msg Message.obtain(null, ServerService.MSG_BIND); msg.replyTo cMessenger; // 關(guān)鍵把客戶(hù)端信使交給服務(wù)端 try { sMessenger.send(msg); } catch (RemoteException e) { e.printStackTrace(); } } Override public void onServiceDisconnected(ComponentName name) { sMessenger null; } };msg.replyTo cMessenger這一行是 Messenger 雙向通信的命門(mén)漏了它服務(wù)端就永遠(yuǎn)回不了消息。3.3 AIDL 接口骨架AIDL 適合需要并發(fā)和回調(diào)的場(chǎng)景。先定義 Parcelable 和接口。QCEmail.aidlpackage com.example.ipcdemo.aidl; parcelable QCEmail;ICallback.aidl用oneway讓服務(wù)端通知客戶(hù)端時(shí)不阻塞package com.example.ipcdemo.aidl; oneway interface ICallback { void onEmailReceived(String subject); }IServer.aidlpackage com.example.ipcdemo.aidl; import com.example.ipcdemo.aidl.QCEmail; import com.example.ipcdemo.aidl.ICallback; interface IServer { QCEmail getEmail(); boolean registerCallback(ICallback callback); boolean unregisterCallback(); }對(duì)應(yīng)的QCEmail.java必須實(shí)現(xiàn) Parcelable并且放在和 aidl 相同的包路徑下public class QCEmail implements Parcelable { public String subject; public String body; public QCEmail(String subject, String body) { this.subject subject; this.body body; } protected QCEmail(Parcel in) { subject in.readString(); body in.readString(); } public static final CreatorQCEmail CREATOR new CreatorQCEmail() { Override public QCEmail createFromParcel(Parcel in) { return new QCEmail(in); } Override public QCEmail[] newArray(int size) { return new QCEmail[size]; } }; Override public int describeContents() { return 0; } Override public void writeToParcel(Parcel dest, int flags) { dest.writeString(subject); dest.writeString(body); } }服務(wù)端實(shí)現(xiàn) Stubpublic class AidlServerService extends Service { private QCEmail mEmail new QCEmail(welcome, hello from aidl); private ICallback mCallback; private final IServer.Stub mBinder new IServer.Stub() { Override public QCEmail getEmail() { return mEmail; } Override public boolean registerCallback(ICallback callback) { mCallback callback; return mCallback ! null; } Override public boolean unregisterCallback() { mCallback null; return true; } }; Override public IBinder onBind(Intent intent) { return mBinder; } }客戶(hù)端通過(guò)IServer.Stub.asInterface(service)拿到接口就能像調(diào)本地方法一樣跨進(jìn)程調(diào)用。4. 驗(yàn)證請(qǐng)求跑通一次跨進(jìn)程 遠(yuǎn)端調(diào)用三條鏈路里AIDL 最能體現(xiàn)「復(fù)雜接口 回調(diào)」所以用它做端到端驗(yàn)證。思路是客戶(hù)端通過(guò) AIDL 請(qǐng)求服務(wù)端服務(wù)端拿到請(qǐng)求后用 TaoToken 的統(tǒng)一 Key 通道發(fā)一次遠(yuǎn)端請(qǐng)求再把結(jié)果通過(guò)回調(diào)返回客戶(hù)端。服務(wù)端在getEmail()里發(fā)起遠(yuǎn)端請(qǐng)求這里用 OkHttp 示意Override public QCEmail getEmail() { try { Request request new Request.Builder() .url(https://taotoken.net/api/v1/chat/completions) .addHeader(Authorization, Bearer BuildConfig.TAOTOKEN_KEY) .addHeader(Content-Type, application/json) .post(RequestBody.create( {\model\:\gpt-4o-mini\,\messages\:[{\role\:\user\,\content\:\ping\}]}, MediaType.parse(application/json))) .build(); Response response client.newCall(request).execute(); String body response.body() ! null ? response.body().string() : ; return new QCEmail(remote-ok, body); } catch (IOException e) { return new QCEmail(remote-fail, e.getMessage()); } }客戶(hù)端調(diào)用并打印結(jié)果private final ServiceConnection aidlConn new ServiceConnection() { Override public void onServiceConnected(ComponentName name, IBinder service) { IServer server IServer.Stub.asInterface(service); try { server.registerCallback(new ICallback.Stub() { Override public void onEmailReceived(String subject) { Log.d(IPC, callback: subject); } }); QCEmail email server.getEmail(); Log.d(IPC, subject email.subject , body email.body); } catch (RemoteException e) { e.printStackTrace(); } } Override public void onServiceDisconnected(ComponentName name) {} };綁定服務(wù)Intent intent new Intent(this, AidlServerService.class); bindService(intent, aidlConn, Context.BIND_AUTO_CREATE);跑起來(lái)后Logcat 里應(yīng)該能看到subjectremote-ok說(shuō)明 AIDL 跨進(jìn)程調(diào)用成功并且服務(wù)端用統(tǒng)一 Key 通道拿到了遠(yuǎn)端響應(yīng)。如果只想快速確認(rèn)模型通道本身是否通可以先用模型對(duì)話頁(yè)面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 發(fā)一條消息對(duì)照。5. 本篇常見(jiàn)錯(cuò)排查Service 沒(méi)起來(lái)onServiceConnected不回調(diào)。先看 Manifest 里android:process是否寫(xiě)對(duì)再看bindService的 Intent 是否匹配。AIDL 服務(wù)端如果用了intent-filter客戶(hù)端用顯式 Intent 更穩(wěn)。Messenger 服務(wù)端收不到消息。九成是msg.replyTo沒(méi)賦值或者客戶(hù)端cMessenger在onServiceConnected之前就用了。把cMessenger的初始化放在綁定之前。AIDL 編譯報(bào)couldnt find import for class。Parcelable 類(lèi)的 .aidl 聲明文件和 .java 實(shí)現(xiàn)必須在同一包路徑下且 .java 要能被編譯到。檢查src/main/aidl和src/main/java的包名是否一致。oneway用反了導(dǎo)致主線程卡頓。oneway只加在不需要等待返回值的接口上比如服務(wù)端通知客戶(hù)端的回調(diào)。如果加在需要返回值的getEmail()上編譯直接報(bào)錯(cuò)。遠(yuǎn)端請(qǐng)求 401。檢查 Key 是否從 API Keys 頁(yè)面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 正確復(fù)制Header 里Bearer后面有沒(méi)有多余空格。接入細(xì)節(jié)對(duì)照文檔 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite ?？邕M(jìn)程傳大對(duì)象 OOM。Binder 事務(wù)緩沖區(qū)約 1MBParcelable 對(duì)象別塞大圖或長(zhǎng)文本超過(guò)就改用文件或 ContentProvider 中轉(zhuǎn)。6. 選型建議與后續(xù)接入Intent 適合一次性傳參和啟動(dòng)組件別拿它做高頻通信Messenger 適合請(qǐng)求量不大、不需要并發(fā)的場(chǎng)景代碼量最少AIDL 適合需要并發(fā)、回調(diào)、傳自定義對(duì)象的復(fù)雜接口。三條鏈路都可以復(fù)用同一套 TaoToken Key 通道區(qū)別只在于請(qǐng)求從哪個(gè)進(jìn)程發(fā)出。如果你后面要把這套鏈路接到編碼類(lèi) Agent 或長(zhǎng)期運(yùn)行的跨進(jìn)程服務(wù)上可以看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。ClaudeCode 相關(guān)的接入在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite ?？刂婆_(tái) https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 里可以隨時(shí)輪換 Key避免把長(zhǎng)期憑證寫(xiě)死在客戶(hù)端。實(shí)測(cè)下來(lái)最容易踩的坑不是 AIDL 語(yǔ)法而是replyTo和android:process這兩個(gè)配置項(xiàng)。把這兩處盯死剩下的就是按接口簽名填實(shí)現(xiàn)。