API Android 3.2

Cấp độ API: 13

Android 3.2 (HONEYCOMB_MR2) là một bản phát hành nền tảng gia tăng, bổ sung các tính năng mới cho người dùng và nhà phát triển. Các phần dưới đây cung cấp thông tin tổng quan về các tính năng mới và API dành cho nhà phát triển.

Đối với các nhà phát triển, nền tảng Android 3.2 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 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 3.2, hãy sử dụng Trình quản lý SDK Android để tải nền tảng xuống SDK của bạn.

Nền tảng nổi bật

Tính năng mới dành cho người dùng

• Tối ưu hoá cho nhiều loại máy tính bảng hơn

  Android 3.2 bao gồm nhiều điểm tối ưu hoá trên hệ thống nhằm đảm bảo trải nghiệm người dùng tuyệt vời trên nhiều loại thiết bị máy tính bảng.

• Tính năng thu phóng tương thích cho ứng dụng có kích thước cố định

  Android 3.2 ra mắt chế độ thu phóng tương thích mới, mang đến cho người dùng một cách mới để xem các ứng dụng có kích thước cố định trên các thiết bị lớn hơn. Chế độ mới cung cấp một giải pháp thay thế theo tỷ lệ pixel so với giao diện người dùng tiêu chuẩn kéo dài cho các ứng dụng không được thiết kế để chạy trên kích thước màn hình lớn hơn, chẳng hạn như máy tính bảng. Người dùng có thể truy cập vào chế độ mới thông qua biểu tượng trình đơn trên thanh hệ thống đối với các ứng dụng cần hỗ trợ tương thích.

• Đồng bộ hoá nội dung nghe nhìn từ thẻ SD

  Trên các thiết bị hỗ trợ thẻ SD, người dùng hiện có thể tải tệp phương tiện trực tiếp từ thẻ SD vào các ứng dụng sử dụng tệp đó. Một cơ sở hệ thống cho phép các ứng dụng truy cập vào các tệp từ kho phương tiện của hệ thống.

Các tính năng mới dành cho nhà phát triển

• API mở rộng để quản lý tính năng hỗ trợ màn hình

  Android 3.2 giới thiệu các tiện ích cho API hỗ trợ màn hình của nền tảng này để mang lại cho nhà phát triển thêm nhiều cách quản lý giao diện người dùng của ứng dụng trên các thiết bị chạy Android. API này bao gồm các bộ hạn định tài nguyên mới và các thuộc tính tệp kê khai mới cho phép bạn kiểm soát chính xác hơn cách ứng dụng hiển thị ở nhiều kích thước, thay vì dựa vào các danh mục kích thước chung.

  Để đảm bảo khả năng hiển thị tốt nhất có thể cho các ứng dụng có kích thước cố định và các ứng dụng có khả năng hỗ trợ hạn chế cho nhiều kích thước màn hình, nền tảng này cũng cung cấp một chế độ tương thích với tính năng thu phóng mới. Chế độ này hiển thị giao diện người dùng trên một khu vực màn hình nhỏ hơn, sau đó điều chỉnh theo tỷ lệ để lấp đầy không gian có sẵn trên màn hình. Để biết thêm thông tin về API hỗ trợ màn hình và các chế độ kiểm soát mà API này cung cấp, hãy xem các phần bên dưới.

Tổng quan về API

API hỗ trợ màn hình

Android 3.2 giới thiệu các API hỗ trợ màn hình mới giúp bạn có nhiều quyền kiểm soát hơn đối với cách ứng dụng tương ứng hiển thị trên nhiều kích thước màn hình. API này được xây dựng dựa trên API hỗ trợ màn hình hiện có, bao gồm cả mô hình mật độ màn hình tổng quát của nền tảng, nhưng mở rộng API này bằng khả năng nhắm mục tiêu chính xác các phạm vi màn hình cụ thể theo kích thước, được đo bằng đơn vị pixel không phụ thuộc vào mật độ (chẳng hạn như 600 dp hoặc 720 dp chiều rộng), thay vì theo kích thước màn hình tổng quát (chẳng hạn như lớn hoặc rất lớn)

Khi thiết kế giao diện người dùng của ứng dụng, bạn vẫn có thể dựa vào nền tảng để cung cấp tính năng trừu tượng mật độ, nghĩa là các ứng dụng không cần bù đắp sự khác biệt về mật độ pixel thực tế trên các thiết bị. Bạn có thể thiết kế giao diện người dùng của ứng dụng theo không gian chiều ngang hoặc chiều dọc có sẵn. Nền tảng này cho biết lượng không gian có sẵn bằng cách sử dụng 3 đặc điểm mới: smallestWidth, width và height.

• smallestWidth của màn hình là kích thước tối thiểu cơ bản, được đo bằng đơn vị pixel không phụ thuộc vào mật độ ("dp"). Trong chiều cao hoặc chiều rộng của màn hình, chiều ngắn hơn trong hai chiều đó. Đối với màn hình ở hướng dọc, kích thước nhỏ nhất thường dựa trên chiều rộng, còn ở hướng ngang, kích thước nhỏ nhất sẽ dựa trên chiều cao. Trong mọi trường hợp, smallestWidth được lấy từ một đặc điểm cố định của màn hình và giá trị này không thay đổi, bất kể hướng. smallestWidth rất quan trọng đối với các ứng dụng vì thuộc tính này thể hiện chiều rộng ngắn nhất có thể mà giao diện người dùng của ứng dụng cần được vẽ, không bao gồm các khu vực màn hình do hệ thống đặt trước.
• Ngược lại, chiều rộng và chiều cao của màn hình thể hiện không gian theo chiều ngang hoặc chiều dọc hiện có cho bố cục ứng dụng, được đo bằng đơn vị "dp", không bao gồm các khu vực màn hình do hệ thống đặt trước. Chiều rộng và chiều cao của màn hình thay đổi khi người dùng chuyển đổi hướng giữa chế độ ngang và dọc.

API hỗ trợ màn hình mới được thiết kế để cho phép bạn quản lý giao diện người dùng của ứng dụng theo smallestWidth của màn hình hiện tại. Bạn cũng có thể quản lý giao diện người dùng theo chiều rộng hoặc chiều cao hiện tại, nếu cần. Đối với những mục đích đó, API cung cấp các công cụ sau:

• Bộ hạn định tài nguyên mới cho bố cục nhắm mục tiêu và các tài nguyên khác có chiều rộng, chiều rộng hoặc chiều cao nhỏ nhất và
• Các thuộc tính tệp kê khai mới, để chỉ định phạm vi tương thích tối đa với màn hình của ứng dụng

Ngoài ra, các ứng dụng vẫn có thể truy vấn hệ thống và quản lý giao diện người dùng cũng như tải tài nguyên trong thời gian chạy, như trong các phiên bản trước của nền tảng.

Vì API mới cho phép bạn nhắm đến màn hình trực tiếp hơn thông qua smallestWidth, chiều rộng và chiều cao, nên bạn nên tìm hiểu các đặc điểm điển hình của các loại màn hình khác nhau. Bảng dưới đây đưa ra một số ví dụ, được đo bằng đơn vị "dp".

Bảng 1. Các thiết bị thông thường, có mật độ và kích thước tính bằng dp.

Các phần dưới đây cung cấp thêm thông tin về các bộ hạn định màn hình và thuộc tính tệp kê khai mới. Để biết thông tin đầy đủ về cách sử dụng API hỗ trợ màn hình, hãy xem phần Hỗ trợ nhiều màn hình.

Bộ hạn định tài nguyên mới để hỗ trợ màn hình

Bộ hạn định tài nguyên mới trong Android 3.2 cho phép bạn nhắm mục tiêu bố cục tốt hơn cho các phạm vi kích thước màn hình. Bằng cách sử dụng bộ hạn định, bạn có thể tạo cấu hình tài nguyên được thiết kế cho một smallestWidth tối thiểu, chiều rộng hiện tại hoặc chiều cao hiện tại cụ thể, được đo bằng pixel không phụ thuộc vào mật độ.

Các bộ hạn định mới là:

• swNNNdp – Chỉ định smallestWidth tối thiểu mà tài nguyên sẽ được sử dụng, được đo bằng đơn vị "dp". Như đã đề cập ở trên, chiều rộng nhỏ nhất của màn hình là hằng số, bất kể hướng. Ví dụ: sw320dp, sw720dp, sw720dp.
• wNNNdp và hNNNdp – Chỉ định chiều rộng hoặc chiều cao tối thiểu mà tài nguyên sẽ được sử dụng, được đo bằng đơn vị "dp". Như đã đề cập ở trên, chiều rộng và chiều cao của màn hình tương ứng với hướng của màn hình và thay đổi bất cứ khi nào hướng thay đổi. Ví dụ: w320dp, w720dp, h1024dp.

Bạn cũng có thể tạo nhiều cấu hình tài nguyên trùng lặp nếu cần. Ví dụ: bạn có thể gắn thẻ một số tài nguyên để sử dụng trên mọi màn hình rộng hơn 480 dp, một số tài nguyên khác để sử dụng trên màn hình rộng hơn 600 dp và một số tài nguyên khác để sử dụng trên màn hình rộng hơn 720 dp. Khi nhiều cấu hình tài nguyên đủ điều kiện cho một màn hình nhất định, hệ thống sẽ chọn cấu hình phù hợp nhất. Để kiểm soát chính xác tài nguyên nào được tải trên một màn hình nhất định, bạn có thể gắn thẻ tài nguyên bằng một bộ hạn định hoặc kết hợp một số bộ hạn định mới hoặc hiện có.

Dựa trên các phương diện thông thường được liệt kê ở trên, sau đây là một số ví dụ về cách bạn có thể sử dụng bộ hạn định mới:

res/layout/main_activity.xml   # For phones
res/layout-sw600dp/main_activity.xml   # For 7” tablets
res/layout-sw720dp/main_activity.xml   # For 10” tablets
res/layout-w600dp/main_activity.xml   # Multi-pane when enough width
res/layout-sw600dp-w720dp/main_activity.xml   # For large width

Các phiên bản cũ của nền tảng sẽ bỏ qua các bộ hạn định mới, vì vậy, bạn có thể kết hợp các bộ hạn định đó nếu cần để đảm bảo ứng dụng của mình trông đẹp mắt trên mọi thiết bị. Dưới đây là một số ví dụ:

res/layout/main_activity.xml   # For phones
res/layout-xlarge/main_activity.xml   # For pre-3.2 tablets
res/layout-sw600dp/main_activity.xml   # For 3.2 and up tablets

Để biết thông tin đầy đủ về cách sử dụng bộ hạn định mới, hãy xem phần Sử dụng bộ hạn định kích thước mới.

Các thuộc tính tệp kê khai mới để tương thích với kích thước màn hình

Khung này cung cấp một tập hợp các thuộc tính tệp kê khai <supports-screens> mới cho phép bạn quản lý khả năng hỗ trợ của ứng dụng đối với nhiều kích thước màn hình. Cụ thể, bạn có thể chỉ định màn hình lớn nhất và nhỏ nhất mà ứng dụng của bạn được thiết kế để chạy, cũng như màn hình lớn nhất mà ứng dụng được thiết kế để chạy mà không cần chế độ tương thích màn hình mới của hệ thống. Giống như bộ hạn định tài nguyên được mô tả ở trên, các thuộc tính tệp kê khai mới chỉ định phạm vi màn hình mà ứng dụng hỗ trợ, như được chỉ định bởi smallestWidth.

Sau đây là các thuộc tính tệp kê khai mới để hỗ trợ màn hình:

• android:compatibleWidthLimitDp="numDp" – Thuộc tính này cho phép bạn chỉ định Chiều rộng nhỏ nhất tối đa mà ứng dụng có thể chạy mà không cần chế độ tương thích. Nếu màn hình hiện tại lớn hơn giá trị được chỉ định, hệ thống sẽ hiển thị ứng dụng ở chế độ bình thường nhưng cho phép người dùng tuỳ ý chuyển sang chế độ tương thích thông qua chế độ cài đặt trong thanh hệ thống.
• android:largestWidthLimitDp="numDp" – Thuộc tính này cho phép bạn chỉ định chiều rộng nhỏ nhất tối đa mà ứng dụng được thiết kế để chạy. Nếu màn hình hiện tại lớn hơn giá trị được chỉ định, hệ thống sẽ buộc ứng dụng chuyển sang chế độ tương thích với màn hình để đảm bảo hiển thị tốt nhất trên màn hình hiện tại.
• android:requiresSmallestWidthDp="numDp" – Thuộc tính này cho phép bạn chỉ định smallestWidth tối thiểu mà ứng dụng có thể chạy. Nếu màn hình hiện tại nhỏ hơn giá trị đã chỉ định, hệ thống sẽ coi ứng dụng đó không tương thích với thiết bị, nhưng không ngăn cài đặt và chạy ứng dụng.

Lưu ý: Google Play hiện không lọc ứng dụng dựa trên bất kỳ thuộc tính nào ở trên. Chúng tôi sẽ thêm tính năng hỗ trợ lọc trong bản phát hành nền tảng sau này. Các ứng dụng yêu cầu lọc dựa trên kích thước màn hình có thể sử dụng các thuộc tính <supports-screens> hiện có.

Để biết thông tin đầy đủ về cách sử dụng các thuộc tính mới, hãy xem phần Khai báo tính năng hỗ trợ kích thước màn hình.

Chế độ tương thích màn hình

Android 3.2 cung cấp chế độ tương thích màn hình mới cho các ứng dụng khai báo rõ ràng rằng các ứng dụng đó không hỗ trợ màn hình lớn như màn hình đang chạy. Chế độ "thu phóng" mới này có tỷ lệ pixel – chế độ này hiển thị ứng dụng trong một khu vực màn hình nhỏ hơn, sau đó điều chỉnh tỷ lệ pixel để lấp đầy màn hình hiện tại.

Theo mặc định, hệ thống cung cấp chế độ tương thích với màn hình dưới dạng tuỳ chọn cho người dùng, đối với các ứng dụng yêu cầu chế độ này. Người dùng có thể bật và tắt chế độ thu phóng bằng cách sử dụng một nút điều khiển có sẵn trong thanh hệ thống.

Vì chế độ tương thích màn hình mới có thể không phù hợp với tất cả ứng dụng, nên nền tảng cho phép ứng dụng tắt chế độ này bằng cách sử dụng các thuộc tính tệp kê khai. Khi ứng dụng tắt, hệ thống sẽ không cung cấp chế độ tương thích "thu phóng" cho người dùng khi ứng dụng đang chạy.

Lưu ý: Để biết thông tin quan trọng về cách kiểm soát chế độ tương thích trong ứng dụng, vui lòng xem bài viết Chế độ mới cho ứng dụng trên màn hình lớn trên Blog dành cho nhà phát triển Android.

Mật độ màn hình mới cho TV 720p và các thiết bị tương tự

Để đáp ứng nhu cầu của các ứng dụng chạy trên TV 720p hoặc tương tự với màn hình có mật độ trung bình, Android 3.2 giới thiệu một mật độ tổng quát mới, tvdpi, với dpi xấp xỉ 213. Các ứng dụng có thể truy vấn mật độ mới trong densityDpi và có thể sử dụng bộ hạn định tvdpi mới để gắn thẻ tài nguyên cho TV và các thiết bị tương tự. Ví dụ:

res/drawable-tvdpi/my_icon.png   # Bitmap for tv density

Nhìn chung, các ứng dụng không cần phải hoạt động với mật độ này. Đối với các trường hợp cần đầu ra cho màn hình 720p, nền tảng có thể tự động điều chỉnh tỷ lệ các thành phần trên giao diện người dùng.

Khung giao diện người dùng

• Mảnh
  • Lớp Fragment.SavedState mới lưu giữ thông tin trạng thái được truy xuất từ một thực thể của mảnh thông qua saveFragmentInstanceState().
  • Phương thức mới saveFragmentInstanceState() lưu trạng thái thực thể hiện tại của Mảnh đã cho. Bạn có thể sử dụng trạng thái này sau khi tạo một thực thể mới của Mảnh khớp với trạng thái hiện tại.
  • Phương thức mới setInitialSavedState() đặt trạng thái đã lưu ban đầu cho một Mảnh khi được tạo lần đầu.
  • Phương thức gọi lại onViewCreated() mới thông báo cho Mảnh rằng onCreateView() đã trả về, nhưng trước khi bất kỳ trạng thái đã lưu nào được khôi phục trong Chế độ xem.
  • Phương thức isDetached() xác định xem Mảnh đã được tách khỏi giao diện người dùng một cách rõ ràng hay chưa.
  • Các phương thức attach() và detach() mới cho phép ứng dụng đính kèm lại hoặc tách rời các mảnh trong giao diện người dùng.
  • Phương thức nạp chồng setCustomAnimations() mới cho phép bạn đặt các tài nguyên ảnh động cụ thể để chạy cho các thao tác nhập/thoát và cụ thể là khi bật ngăn xếp lui. Cách triển khai hiện tại không tính đến hành vi khác nhau của các mảnh khi bật ngăn xếp lui.
• Thông tin về kích thước màn hình trong ActivityInfo và ApplicationInfo
  • ActivityInfo thêm CONFIG_SCREEN_SIZE và CONFIG_SMALLEST_SCREEN_SIZE dưới dạng mặt nạ bit trong configChanges. Các bit này cho biết liệu một Hoạt động có thể tự xử lý kích thước màn hình và kích thước màn hình nhỏ nhất hay không.
  • ApplicationInfo thêm các trường largestWidthLimitDp, compatibleWidthLimitDp và requiresSmallestWidthDp, bắt nguồn từ các thuộc tính <supports-screens> tương ứng trong tệp kê khai ứng dụng.
• Các trình trợ giúp để lấy kích thước màn hình từ WindowManager
  • Các phương thức mới getSize() và getRectSize() cho phép các ứng dụng có được kích thước thô của màn hình.
• Các kiểu "3D" công khai mới
  • Nền tảng hiện hiển thị nhiều kiểu "thực tế ảo" công khai cho văn bản, tiện ích thanh thao tác và thẻ, v.v. Hãy xem R.style để xem danh sách đầy đủ.
• LocalActivityManager, ActivityGroup và LocalActivityManager hiện không dùng nữa
  • Các ứng dụng mới nên sử dụng Mảnh thay vì các lớp này. Để tiếp tục chạy trên các phiên bản nền tảng cũ, bạn có thể sử dụng Thư viện hỗ trợ v4 (thư viện tương thích) có trong SDK Android. Thư viện hỗ trợ v4 cung cấp một phiên bản API Mảnh tương thích với Android 1.6 (API cấp 4).
  • Đối với các ứng dụng phát triển dựa trên Android 3.0 (API cấp 11) trở lên, các thẻ thường được trình bày trong giao diện người dùng bằng cách sử dụng ActionBar.newTab() mới và các API liên quan để đặt thẻ trong khu vực thanh thao tác.

Khung nội dung nghe nhìn

• Các ứng dụng sử dụng trình cung cấp nội dung đa phương tiện của nền tảng (MediaStore) hiện có thể đọc dữ liệu đa phương tiện trực tiếp từ thẻ SD có thể tháo rời, nếu thiết bị hỗ trợ. Các ứng dụng cũng có thể tương tác trực tiếp với các tệp trên thẻ SD bằng cách sử dụng API MTP.

Đồ hoạ

• Tiện ích theo gói trong Point và PointF
  • Các lớp Point và PointF hiện bao gồm giao diện Parcelable và các phương thức tiện ích describeContents(), readFromParcel() và writeToParcel().

Khung IME

• Phương thức getModifiers() mới để truy xuất trạng thái hiện tại của các phím sửa đổi.

Khung USB

• Phương thức getRawDescriptors() mới để truy xuất các chỉ số mô tả USB thô cho thiết bị. Bạn có thể dùng phương thức này để truy cập vào các mã mô tả không được hỗ trợ trực tiếp thông qua các API cấp cao hơn.

Mạng

• Hằng số loại mạng
  • ConnectivityManager thêm các hằng số TYPE_ETHERNET và TYPE_BLUETOOTH.

Điện thoại

• Hằng số loại mạng NETWORK_TYPE_HSPAP mới.

Các tiện ích cốt lõi

• Tiện ích có thể phân phối
  • Giao diện mới Parcelable.ClassLoaderCreator cho phép ứng dụng nhận ClassLoader trong đó đối tượng đang được tạo.
  • adoptFd, dup() và fromFd() mới để quản lý các đối tượng ParcelFileDescriptor.
• Binder và IBinder
  • Phương thức mới dumpAsync() trong Binder và IBinder cho phép các ứng dụng kết xuất vào một tệp đã chỉ định, đảm bảo rằng mục tiêu thực thi không đồng bộ.
  • Mã giao dịch IBinder mới (TWEET_TRANSACTION) cho phép các ứng dụng gửi một dòng tweet đến đối tượng mục tiêu.

Hằng số tính năng mới

Nền tảng này thêm các hằng số tính năng phần cứng mới mà bạn có thể khai báo trong tệp kê khai ứng dụng của mình để thông báo cho các thực thể bên ngoài như Google Play về các chức năng phần cứng và phần mềm bắt buộc. Bạn khai báo các hằng số này và các hằng số tính năng khác trong phần tử tệp kê khai <uses-feature>.

Google Play lọc ứng dụng dựa trên thuộc tính <uses-feature> để đảm bảo rằng các ứng dụng đó chỉ được cung cấp cho những thiết bị đáp ứng yêu cầu của ứng dụng.

• Hằng số tính năng cho các yêu cầu về hướng ngang hoặc dọc

  Android 3.2 giới thiệu các hằng số tính năng mới cho phép ứng dụng chỉ định xem chúng có yêu cầu hiển thị theo hướng ngang, hướng dọc hay cả hai hay không. Việc khai báo các hằng số này cho biết rằng không được cài đặt ứng dụng trên một thiết bị không cung cấp hướng liên kết. Ngược lại, nếu bạn không khai báo một hoặc cả hai hằng số, thì điều này cho biết rằng ứng dụng không có lựa chọn ưu tiên cho các hướng chưa khai báo và có thể được cài đặt trên một thiết bị không cung cấp các hướng đó.

  • android.hardware.screen.landscape – Ứng dụng yêu cầu màn hình theo hướng ngang.
  • android.hardware.screen.portrait – Ứng dụng yêu cầu hiển thị theo hướng dọc.

  Thông thường, một ứng dụng thông thường hoạt động bình thường ở cả hướng ngang và dọc sẽ không cần khai báo yêu cầu về hướng. Thay vào đó, một ứng dụng chủ yếu được thiết kế cho một hướng, chẳng hạn như ứng dụng được thiết kế cho TV, có thể khai báo một trong các hằng số để đảm bảo rằng ứng dụng đó không dùng được cho các thiết bị không cung cấp hướng đó.

  Nếu bất kỳ hoạt động nào được khai báo trong yêu cầu tệp kê khai mà chúng chạy ở một hướng cụ thể, bằng thuộc tính android:screenOrientation, thì thao tác này cũng khai báo rằng ứng dụng yêu cầu hướng đó.

• Các hằng số tính năng khác
  • android.hardware.faketouch.multitouch.distinct – Ứng dụng yêu cầu hỗ trợ đầu vào cảm ứng đa điểm được mô phỏng với tính năng theo dõi riêng biệt của 2 hoặc nhiều điểm.
  • android.hardware.faketouch.multitouch.jazzhand – Ứng dụng yêu cầu hỗ trợ đầu vào cảm ứng đa điểm được mô phỏng với tính năng theo dõi riêng biệt từ 5 điểm trở lên.

Báo cáo về sự khác biệt của API

Để xem chi tiết tất cả các thay đổi về API trong Android 3.2 (API cấp 13), hãy xem Báo cáo điểm khác biệt về API.

Cấp độ API:

Nền tảng Android 3.2 cung cấp phiên bản cập nhật của API khung. API Android 3.2 được gán một giá trị nhận dạng số nguyên – 13 – lưu trữ trong chính hệ thống. Giá trị nhận dạng này, được gọi là "Cấp độ API", cho phép hệ thống xác định chính xác xem một ứng dụng có tương thích với hệ thống hay không trước khi cài đặt ứng dụng.

Để sử dụng các API được giới thiệu trong Android 3.2 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 nền tảng SDK Android 3.2. Tuỳ thuộc vào nhu cầu, bạn cũng có thể cần thêm thuộc tính android:minSdkVersion="13" vào phần tử <uses-sdk> trong tệp kê khai của ứng dụng.

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