API Android 2.3.4

Cấp độ API: 10

Android 2.3.4 (GINGERBREAD_MR1) là 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ó bất kỳ thay đổi nào về API từ Android 2.3.3. Ngoài ra, Android 2.3.4 còn hỗ trợ Open Accessory API cho 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 một 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 bộ giao diện trình mô phỏng và nhiều nội dung 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 API khung tương tự cho các ứng dụng như Android 2.3.3 (API cấp 10). Để biết nội dung 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

Phụ kiện 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 này. Tính năng này dựa trên ngăn xếp USB (Universal Serial Bus) được tích hợp trong nền tảng và một 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 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 thông qua một thư viện bên ngoài không bắt buộc, đó là 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ị kết nối qua USB. Thư viện này cũng cho phép triển khai API trên 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 sử dụng Thư viện phụ kiện mở trên mọi thiết bị cụ thể. Các nhà sản xuất thiết bị có thể chọn đưa Thư viện phụ kiện mở vào sản phẩm của họ hay loại trừ nó. Thư viện này tương thích chuyển tiếp 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 lĩnh vực, bạn có thể sử dụng cùng một kỹ thuật và API. 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 tiêu 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 qua 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 bằng bộ lọc ý định, đối tượng UsbAccessory sẽ nằm trong ý định được truyền đến ứng dụng. Nếu đ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ở không hỗ trợ chế độ lưu 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 chạy Android 2.3.4 không thể hoạt động làm máy chủ USB. 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, với phụ kiện được kết nối hoạt động như 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 Google, bao gồm cả thư viện (để liên kết)
  • Một thiết bị phần cứng thực tế chạy Android 2.3.4 (hoặc Android 3.1) có hỗ trợ phụ kiện USB, để kiểm thử trong thời gian chạy đối với các thiết bị được 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 phụ kiện USB, 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, để ứng dụng của họ không được cung cấp cho những người dùng có thiết bị không hỗ trợ phù hợp cho phụ kiện. Để 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ền tảng 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, bao gồm cả Thư viện phụ kiện mở.

Tuỳ thuộc vào nhu cầu của mình, bạn cũng có thể thêm thuộc tính android:minSdkVersion="10" vào phần tử <uses-sdk> trong tệp kê khai của ứng dụng. 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, thì việc khai báo thuộc tính này sẽ ngăn cài đặt ứng dụng trên các phiên bản trước đó 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ì?