API 級別:10
Android 2.3.4 (GINGERBREAD_MR1
)
是一種維護版本,加入多項錯誤修正和修補程式
升級至 Android 2.3 平台,且自 Android 2.3.3 版以來皆無任何 API 變更。此外,
Android 2.3.4 版為行動裝置提供 Open Accessory API 支援,
選擇透過選用的 Open Accessory Library。
對於開發人員而言,Android 2.3.4 平台可做為 Android SDK 的可下載元件使用。可下載的平台包含 Android 程式庫和系統映像檔,以及一組模擬器外觀等。如要開始針對 Android 2.3.4 進行開發或測試 使用 Android SDK Manager 將這個平台下載到 SDK。
API 總覽
Android 2.3.4 為應用程式提供與 Android 2.3.3 (API 級別 10) 相同的架構 API。如需 API 摘要,請參閱 Android 2.3.3 版本資訊。
開啟配件程式庫
Open Accessory 是一種新功能,可將連結的周邊裝置與平台上執行的應用程式整合。功能 是以 Google Cloud Platform 內建的 USB (通用序列匯流排) 堆疊為基礎 API 已開放應用程式存取連接至 Android 裝置的周邊裝置 以 USB 主機的形式連接配件
開放式配件是在 Android 3.1 (API 級別 12) 中推出,但透過選用的外部程式庫 (開放式配件程式庫),也適用於搭載 Android 2.3.4 的裝置。這個程式庫會公開一個架構 API 可讓應用程式探索、通訊及管理各式各樣的裝置 透過 USB 連接的類型它也針對 Android 2.3.4 中未直接公開給應用程式的 Android 平台部分,提供 API 實作。
任何裝置都可以選擇使用開放式配件程式庫。裝置 製造商可選擇是否要在 或是排除該產品這個程式庫與 Android 3.1 具有前瞻相容性, 根據 Android 2.3.4 開發的應用程式可以在裝置上執行 搭載 Android 3.1 (前提是這些裝置支援 USB 配件)
Open Accessory Library 提供的 API 是以 Open Accessory 為基礎 API。在大多數情況下,您可以使用相同的技術和 API。不過,在 Android 2.3.4 上開發 Open Accessory 程式庫的方式有所不同 將標準 USB API 從標準 USB API 中移除
- 取得
UsbManager
物件 - 取得UsbManager
物件 使用getInstance()
輔助方法,而非getSystemService()
例如:Kotlin
val manager = UsbManager.getInstance(this)
Java
UsbManager manager = UsbManager.getInstance(this);
- 從已篩選的意圖中取得
UsbAccessory
:當您使用意圖篩選器篩選已連結的裝置或配件時,UsbAccessory
物件會包含在傳遞至應用程式意圖內。如果您使用的是外掛程式庫,可以按照下列方式取得UsbAccessory
物件:Kotlin
val accessory = UsbManager.getAccessory(intent)
Java
UsbAccessory accessory = UsbManager.getAccessory(intent)
- 不支援 USB 主機 — Android 2.3.4 和開放式配件程式庫不支援 USB 主機模式 (例如透過
UsbDevice
),但 Android 3.1 支援 USB 主機模式。搭載 Android 2.3.4 的 Android 裝置無法做為 USB 主機運作。這個程式庫可讓 Android 裝置僅做為周邊裝置使用,而連接的配件則可做為 USB 主機 (透過UsbAccessory
) 使用。
如要使用 Open Accessory Library 開發應用程式,您需要:
- Android SDK 工具的最新版本
- 最新版 Google API 外掛程式,其中包含 本身 (用於連結)
- 搭載 Android 2.3.4 (或 Android 3.1) 且支援 USB 配件的實際硬體裝置,可用於針對已連結裝置進行執行階段測試
如需有關如何開發與 USB 配件互動的應用程式的完整討論,請參閱相關的開發人員說明文件。
此外,開發人員也可以要求在 Google Play 上進行篩選,讓裝置不支援適當配件的使用者無法使用應用程式。如要要求篩選功能,請在應用程式資訊清單中加入下列元素:
<uses-feature android:name="android.hardware.usb.accessory" android:required="true">
API 級別
Android 2.3.4 平台「不會」增加 API 級別,而是與 Android 2.3.3 使用相同的 API 級別,即 API 級別 10。
如要在應用程式中使用 API 級別 10 中導入的 API, 您需要針對 最新版的 Google API 外掛程式,當中也包含 配件資料庫。
視需求而定,您可能還需要在應用程式資訊清單的 <uses-sdk>
元素中加入 android:minSdkVersion="10"
屬性。如果應用程式僅設計用於在 Android 2.3.3 以上版本上執行,宣告此屬性可防止應用程式在舊版平台上安裝。
詳情請參閱「什麼是 API 級別?」。