API Android 2.3.4

Cấp độ API: 10

Android 2.3.4 (GINGERBREAD_MR1) là một bản phát hành bảo trì bổ sung một số bản sửa lỗi và bản vá cho nền tảng Android 2.3 mà không có thay đổi nào về API so với Android 2.3.3. Ngoài ra, Android 2.3.4 mang đến hỗ trợ cho Open Accessory API đến các thiết bị di động, thông qua Thư viện phụ kiện mở (không bắt buộc).

Đối với các nhà phát triển, nền tảng Android 2.3.4 có sẵn dưới dạng thành phần có thể tải xuống cho SDK Android. Nền tảng có thể tải xuống bao gồm thư viện Android và hình ảnh hệ thống, cũng như một tập hợp giao diện trình mô phỏng và khác. Để bắt đầu phát triển hoặc kiểm thử trên Android 2.3.4, hãy sử dụng Trình quản lý SDK Android để tải nền tảng này xuống SDK của bạn.

Tổng quan về API

Android 2.3.4 cung cấp cùng một API khung cho các ứng dụng như Android 2.3.3 (API cấp 10). Để biết tóm tắt về API, hãy xem Ghi chú về phiên bản Android 2.3.3.

Mở Thư viện phụ kiện

Open Accessory (Thiết bị ngoại vi mở) là một tính năng mới để tích hợp các thiết bị ngoại vi đã kết nối với các ứng dụng chạy trên nền tảng. Khả năng này dựa trên ngăn xếp USB (Universal Serial Bus) được tích hợp vào nền tảng và API hiển thị cho các ứng dụng. Các thiết bị ngoại vi gắn vào thiết bị chạy Android dưới dạng phụ kiện sẽ kết nối dưới dạng máy chủ USB.

Phụ kiện mở được giới thiệu trong Android 3.1 (API cấp 12), nhưng được cung cấp cho các thiết bị chạy Android 2.3.4 bằng phương tiện Thư viện phụ kiện mở. Thư viện này hiển thị một API khung cho phép các ứng dụng khám phá, giao tiếp và quản lý nhiều loại thiết bị được kết nối qua USB. API này cũng cung cấp cách triển khai API đối với các phần của nền tảng Android không trực tiếp hiển thị với các ứng dụng trong Android 2.3.4.

Bạn không bắt buộc phải có Thư viện phụ kiện mở trên mọi thiết bị cụ thể. Thiết bị nhà sản xuất có thể chọn có đưa Thư viện phụ kiện mở vào hoặc loại trừ sản phẩm đó. Thư viện này tương thích ngược với Android 3.1, vì vậy, các ứng dụng được phát triển dựa trên Android 2.3.4 sẽ chạy đúng cách trên các thiết bị chạy Android 3.1, nếu các thiết bị đó hỗ trợ phụ kiện USB.

API do Thư viện phụ kiện mở cung cấp dựa trên API Phụ kiện mở được cung cấp trong Android 3.1. Trong hầu hết các khu vực, bạn có thể sử dụng các kỹ thuật và API giống nhau. Tuy nhiên, việc phát triển cho Thư viện phụ kiện mở trên Android 2.3.4 khác với API USB chuẩn ở những điểm sau:

  • Lấy đối tượng UsbManager — Để lấy đối tượng UsbManager khi sử dụng thư viện tiện ích bổ sung. hãy sử dụng phương thức trợ giúp getInstance() thay vì getSystemService() Ví dụ:

    Kotlin

    val manager = UsbManager.getInstance(this)

    Java

    UsbManager manager = UsbManager.getInstance(this);
  • Lấy UsbAccessory từ một ý định đã lọc – Khi bạn lọc tìm một thiết bị hoặc phụ kiện đã kết nối có ý định thì có chứa đối tượng UsbAccessory bên trong ý định được truyền đến ứng dụng của bạn. Nếu bạn đang sử dụng thư viện tiện ích bổ sung, bạn có thể lấy đối tượng UsbAccessory theo cách sau:

    Kotlin

    val accessory = UsbManager.getAccessory(intent)

    Java

    UsbAccessory accessory = UsbManager.getAccessory(intent)
  • Không hỗ trợ máy chủ USB — Android 2.3.4 và Thư viện phụ kiện mở có thể không hỗ trợ chế độ hỗ trợ USB (ví dụ: thông qua UsbDevice), mặc dù chế độ hỗ trợ USB được hỗ trợ trong Android 3.1. Thiết bị chạy Android 2.3.4 không thể hoạt động như USB máy chủ lưu trữ. Thư viện này cho phép thiết bị chạy Android chỉ hoạt động như một thiết bị ngoại vi, trong đó phụ kiện được kết nối hoạt động như một máy chủ USB (thông qua UsbAccessory).

Để phát triển ứng dụng bằng Thư viện phụ kiện mở, bạn cần:

  • Phiên bản mới nhất của bộ công cụ SDK Android
  • Phiên bản mới nhất của tiện ích bổ sung API của Google, bao gồm cả thư viện (để liên kết)
  • Thiết bị phần cứng thực tế chạy Android 2.3.4 (hoặc Android 3.1) có USB hỗ trợ phụ kiện, để kiểm thử trong thời gian chạy đối với các thiết bị đã kết nối

Để thảo luận đầy đủ về cách phát triển các ứng dụng tương tác với USB phụ kiện, vui lòng xem tài liệu liên quan dành cho nhà phát triển.

Ngoài ra, nhà phát triển có thể yêu cầu lọc trên Google Play, sao cho các ứng dụng của họ không được cung cấp cho người dùng có thiết bị không cung cấp giá đỡ phụ kiện thích hợp. Để yêu cầu lọc, hãy thêm phần tử dưới đây vào tệp kê khai ứng dụng:

<uses-feature
  android:name="android.hardware.usb.accessory"
  android:required="true">

Cấp độ API:

Nền tảng Android 2.3.4 không làm tăng cấp độ API – nó sử dụng cùng cấp độ API như Android 2.3.3, API cấp 10.

Để sử dụng các API được giới thiệu trong API cấp 10 trong ứng dụng, bạn cần biên dịch ứng dụng dựa trên thư viện Android được cung cấp trong phiên bản mới nhất của Tiện ích bổ sung API của Google, trong đó cũng có Thư viện phụ kiện mở.

Tuỳ thuộc vào nhu cầu, bạn có thể bạn cũng cần thêm một android:minSdkVersion="10" cho phần tử <uses-sdk> trong đơn đăng ký tệp kê khai. Nếu ứng dụng của bạn được thiết kế để chỉ chạy trên Android 2.3.3 trở lên, việc khai báo thuộc tính sẽ ngăn ứng dụng được cài đặt trước đó các phiên bản của nền tảng.

Để biết thêm thông tin, hãy đọc bài viết Cấp độ API là gì?