Android OpenMobileAPI SEService 綁定失敗：jar 包版本不匹配解決實戰

錯誤現象

實例化 SEService 時，onServiceDisconnection() 回調返回 bindingSuccessful: false，無法建立與 Secure Element (SE) 的連接。

根本原因

專案引用的 org.simalliance.openmobileapi jar 包與測試手機系統內建的 OMAPI 實現版本不一致，導致 AIDL 介面不匹配，ServiceConnected 回調未被觸發。

解決方案：使用手機系統自帶 jar 包

1. 確認手機廠商提供完整系統源碼或可提取框架 jar。
2. 從手機系統映像中提取 org.simalliance.openmobileapi.jar（通常位於 /system/framework/）。
3. 替換專案 libs 目錄下的舊 jar 包，或在 Android Studio 中作為模組依賴導入。
4. 重新編譯執行，SEService 即可正確實例化並觸發 onServiceConnected。

核心原理

OMAPI 屬於系統級服務，其 AIDL 介面由手機廠商定製。唯有使用與目標手機系統版本完全一致的 jar 包，才能保證跨進程通訊 (IPC) 協議匹配。

避坑指南

• 不要盲目從網路下載通用版 jar 包。
• 若無法獲取系統源碼，嘗試聯繫手機廠商技術支援獲取對應版本 SDK。
• 測試時優先使用同品牌、同系統版本的多台設備驗證相容性。