Google Play sử dụng các thuộc tính <uses-sdk> được khai báo trong tệp kê khai ứng dụng để lọc từ các thiết bị không đáp ứng yêu cầu về phiên bản nền tảng của ứng dụng đó. Trước khi đặt các thuộc tính này, hãy đảm bảo bạn hiểu rõ bộ lọc của Google Play.

cú pháp:
<uses-sdk android:minSdkVersion="integer"
          android:targetSdkVersion="integer"
          android:maxSdkVersion="integer" />
có trong:
<manifest>
mô tả:

Cho phép bạn thể hiện khả năng tương thích của ứng dụng với một hoặc nhiều phiên bản nền tảng Android, thông qua số nguyên cấp độ API. Cấp độ API mà ứng dụng biểu thị sẽ được so sánh với Cấp độ API của một hệ thống Android nhất định vốn có thể khác nhau giữa các thiết bị Android khác nhau.

Phần tử này được dùng để chỉ định Cấp độ API, không phảisố phiên bản SDK (bộ phát triển phần mềm) hoặc nền tảng Android như tên gọi của nó. Cấp độ API luôn là một số nguyên duy nhất. Bạn không được lấy Cấp độ API từ số phiên bản Android liên kết (ví dụ: API này không giống với phiên bản chính hoặc tổng các phiên bản chính và phụ).

Đồng thời, đọc tài liệu về Tạo phiên bản cho ứng dụng của bạn.

thuộc tính:
android:minSdkVersion
Một số nguyên chỉ định Cấp độ API tối thiểu cần thiết để ứng dụng chạy. Hệ thống Android sẽ ngăn người dùng cài đặt ứng dụng nếu Cấp độ API của hệ thống thấp hơn giá trị được chỉ định trong thuộc tính này. Bạn phải luôn khai báo thuộc tính này.

Thận trọng: Nếu bạn không khai báo thuộc tính này, hệ thống sẽ giả định một giá trị mặc định là "1". Giá trị này cho biết ứng dụng của bạn tương thích với mọi phiên bản Android. Nếu ứng dụng của bạn không tương thích với tất cả các phiên bản (ví dụ: ứng dụng sử dụng API đã giới thiệu trong API cấp độ 3) và bạn chưa khai báo minSdkVersion thích hợp, thì khi được cài đặt trên hệ thống có Cấp độ API thấp hơn 3, ứng dụng sẽ gặp lỗi trong thời gian chạy khi cố gắng truy cập vào các API không được hỗ trợ. Vì lý do này, hãy nhớ khai báo Cấp độ API thích hợp trong thuộc tính minSdkVersion.

android:targetSdkVersion
Một số nguyên chỉ định Cấp độ API mà ứng dụng nhắm mục tiêu. Nếu bạn không đặt chính sách này, giá trị mặc định sẽ bằng giá trị minSdkVersion.

Thuộc tính này thông báo cho hệ thống là bạn đã kiểm thử so với phiên bản đích và hệ thống không nên cho phép bất kỳ hành vi tương thích nào duy trì khả năng tương thích chuyển tiếp của ứng dụng với phiên bản mục tiêu. Ứng dụng vẫn có thể chạy trên các phiên bản cũ hơn (xuống đến minSdkVersion).

Vì Android phát triển với mỗi phiên bản mới, một số hành vi và thậm chí giao diện có thể thay đổi. Tuy nhiên, nếu cấp độ API của nền tảng cao hơn phiên bản được targetSdkVersion của ứng dụng khai báo, hệ thống có thể kích hoạt hành vi tương thích để đảm bảo ứng dụng tiếp tục hoạt động như dự kiến. Bạn có thể tắt các hành vi tương thích đó bằng cách chỉ định targetSdkVersion để khớp với cấp độ API của nền tảng nơi hành vi đang chạy. Ví dụ: đặt giá trị này thành "11" trở lên cho phép hệ thống áp dụng một giao diện mặc định mới (Holo) cho ứng dụng của bạn khi chạy trên Android 3.0 trở lên và đồng thời tắt chế độ tương thích màn hình khi chạy trên màn hình lớn (vì hỗ trợ cho API cấp độ 11 ngầm hỗ trợ màn hình lớn).

Có nhiều hành vi tương thích mà hệ thống có thể bật dựa trên giá trị bạn đặt cho thuộc tính này. Một số hành vi nêu trên được mô tả bởi các phiên bản nền tảng tương ứng trong tệp tham chiếu Build.VERSION_CODES.

Để duy trì ứng dụng tích hợp với mỗi bản phát hành Android, bạn nên tăng giá trị của thuộc tính này để phù hợp với cấp độ API mới nhất, sau đó kiểm thử kỹ ứng dụng của bạn trên phiên bản nền tảng tương ứng.

Ra mắt trong: API cấp độ 4

android:maxSdkVersion
Một số nguyên chỉ định Cấp độ API tối đa mà ứng dụng được thiết kế để chạy.

Trên Android 1.5, 1.6, 2.0 và 2.0.1, hệ thống kiểm tra giá trị của thuộc tính này khi cài đặt ứng dụng và xác thực lại ứng dụng sau khi cập nhật hệ thống. Trong cả hai trường hợp, nếu thuộc tính maxSdkVersion của ứng dụng thấp hơn Cấp độ API mà hệ thống sử dụng, thì hệ thống sẽ không cho phép cài đặt ứng dụng. Trong trường hợp xác thực lại sau khi cập nhật hệ thống, điều này sẽ xóa ứng dụng của bạn khỏi thiết bị một cách hiệu quả.

Để minh họa cách thuộc tính này ảnh hưởng thế nào đến ứng dụng của bạn sau khi cập nhật hệ thống, hãy xem xét ví dụ sau đây:

Một ứng dụng khai báo maxSdkVersion="5" trong tệp kê khai đã được phát hành trên Google Play. Một người dùng có thiết bị đang chạy Android 1.6 (API cấp độ 4) sẽ tải xuống và cài đặt ứng dụng. Sau vài tuần, người dùng sẽ nhận được bản cập nhật hệ thống qua mạng không dây lên Android 2.0 (API cấp độ 5). Sau khi cài đặt bản cập nhật, hệ thống sẽ kiểm tra maxSdkVersion của ứng dụng và xác thực lại thành công ứng dụng đó. Ứng dụng này hoạt động như bình thường. Tuy nhiên, sau một thời gian, thiết bị nhận được một bản cập nhật hệ thống khác, lần này là lên Android 2.0.1 (API cấp độ 6). Sau khi cập nhật, hệ thống không thể xác thực lại ứng dụng đó nữa vì cấp độ API của chính hệ thống (6) hiện đã cao hơn cấp độ tối đa mà ứng dụng hỗ trợ (5). Hệ thống sẽ ngăn ứng dụng hiển thị với người dùng, xóa ứng dụng đó khỏi thiết bị.

Cảnh báo: Bạn không nên khai báo thuộc tính này. Thứ nhất, bạn không cần phải đặt thuộc tính làm phương thức chặn triển khai ứng dụng của mình trên các phiên bản nền tảng Android mới khi các phiên bản đó được phát hành. Theo thiết kế, các phiên bản mới của nền tảng hoàn toàn tương thích ngược. Ứng dụng của bạn phải hoạt động đúng cách trên các phiên bản mới, miễn là ứng dụng đó chỉ sử dụng API tiêu chuẩn và tuân thủ các phương pháp phát triển hay nhất. Thứ hai, trong một số trường hợp, việc khai báo thuộc tính có thể dẫn đến việc ứng dụng của bạn bị xóa khỏi thiết bị của người dùng sau khi cập nhật hệ thống lên cấp độ API cao hơn. Hầu hết các thiết bị mà ứng dụng của bạn có thể cài đặt được sẽ nhận bản cập nhật hệ thống định kỳ không dây. Vì vậy, bạn nên cân nhắc tác động của thiết bị đó đến ứng dụng trước khi đặt thuộc tính này.

Ra mắt trong: API cấp độ 4

Các phiên bản Android trong tương lai (ngoài Android 2.0.1) sẽ không kiểm tra hoặc thực thi thuộc tính maxSdkVersion trong quá trình cài đặt hoặc xác thực lại nữa. Tuy nhiên, Google Play sẽ tiếp tục sử dụng thuộc tính này làm bộ lọc khi hiển thị cho người dùng các ứng dụng có thể tải xuống.
ra mắt từ:
API Cấp độ 1

Cấp độ API là gì?

Cấp độ API là một giá trị số nguyên xác định duy nhất API bản sửa đổi do một phiên bản nền tảng Android cung cấp.

Nền tảng Android cung cấp một API khung mà các ứng dụng có thể sử dụng để tương tác với hệ thống Android cơ bản. API khung bao gồm:

  • Tập hợp lõi các gói và lớp
  • Tập hợp các phần tử và thuộc tính XML để khai báo tệp kê khai
  • Tập hợp các phần tử và thuộc tính XML để khai báo và truy cập các tài nguyên
  • Một tập hợp ý định
  • Một tập hợp các quyền mà ứng dụng có thể yêu cầu, cũng như quyền thực thi quyền truy cập được đưa vào hệ thống

Mỗi phiên bản kế tiếp của nền tảng Android đều có thể bao gồm nội dung cập nhật cho API khung ứng dụng Android mà nền tảng phân phối.

Các bản cập nhật cho API khung được thiết kế để API mới vẫn tương thích với các phiên bản API cũ. Điều này nghĩa là hầu hết các thay đổi trong API đều có tính bổ sung và giới thiệu chức năng mới hoặc thay thế. Khi các phần của API được nâng cấp, các phần cũ hơn đã được thay thế sẽ ngừng hoạt động nhưng không bị xóa để các ứng dụng hiện có vẫn có thể sử dụng chúng. Trong số ít trường hợp, một vài phần của API có thể được sửa đổi hoặc xóa, mặc dù thông thường, những thay đổi đó chỉ cần để đảm bảo độ mạnh của API và bảo mật ứng dụng hoặc hệ thống. Chúng tôi sẽ chuyển tất cả các phần API khác trong bản sửa đổi trước đó mà không cần sửa đổi.

API khung mà nền tảng Android phân phối được chỉ định bằng cách sử dụng giá trị nhận dạng số nguyên gọi là "Cấp độ API". Mỗi phiên bản nền tảng Android đều hỗ trợ chính xác một Cấp độ API mặc dù chức năng hỗ trợ được ngầm định cho tất cả Cấp độ API trước đó (xuống đến Cấp độ API 1). Bản phát hành ban đầu của nền tảng Android đã cung cấp API cấp độ 1 và các bản phát hành tiếp theo đã tăng cấp độ API.

Bảng bên dưới cho biết Cấp độ API được hỗ trợ theo từng phiên bản của nền tảng Android. Để biết thông tin về số lượng thiết bị tương đối đang chạy từng phiên bản, hãy xem trang tổng quan Phiên bản nền tảng.

Phiên bản nền tảngCấp độ API:VERSION_CODELưu ý
Android 13 phiên bản thử nghiệm Sự khác biệt về API:
API 32 → T Beta 1
TIRAMISU Những điểm nổi bật của nền tảng
Android 12 32 S_V2 Những điểm nổi bật của nền tảng
31 S Những điểm nổi bật của nền tảng
Android 11 30 R Những điểm nổi bật của nền tảng
Android 10 29 Q Những điểm nổi bật của nền tảng
Android 9 28 P Những điểm nổi bật của nền tảng
Android 8.1 27 O_MR1 Những điểm nổi bật của nền tảng
Android 8.0 26 O Những điểm nổi bật của nền tảng
Android 7.1.1
Android 7.1
25 N_MR1 Những điểm nổi bật của nền tảng
Android 7.0 24 N Những điểm nổi bật của nền tảng
Android 6.0 23 M Những điểm nổi bật của nền tảng
Android 5.1 22 LOLLIPOP_MR1 Những điểm nổi bật của nền tảng
Android 5.0 21 LOLLIPOP
Android 4.4W 20 KITKAT_WATCH Chỉ KitKat cho Thiết bị đeo
Android 4.4 19 KITKAT Những điểm nổi bật của nền tảng
Android 4.3 18 JELLY_BEAN_MR2 Những điểm nổi bật của nền tảng
Android 4.2, 4.2.2 17 JELLY_BEAN_MR1 Những điểm nổi bật của nền tảng
Android 4.1, 4.1.1 16 JELLY_BEAN Những điểm nổi bật của nền tảng
Android 4.0.3, 4.0.4 15 ICE_CREAM_SANDWICH_MR1 Những điểm nổi bật của nền tảng
Android 4.0, 4.0.1, 4.0.2 14 ICE_CREAM_SANDWICH
Android 3.2 13 HONEYCOMB_MR2
Android 3.1.x 12 HONEYCOMB_MR1 Những điểm nổi bật của nền tảng
Android 3.0.x 11 HONEYCOMB Những điểm nổi bật của nền tảng
Android 2.3.4
Android 2.3.3
10 GINGERBREAD_MR1 Những điểm nổi bật của nền tảng
Android 2.3.2
Android 2.3.1
Android 2.3
9 GINGERBREAD
Android 2.2.x 8 FROYO Những điểm nổi bật của nền tảng
Android 2.1.x 7 ECLAIR_MR1 Những điểm nổi bật của nền tảng
Android 2.0.1 6 ECLAIR_0_1
Android 2.0 5 ECLAIR
Android 1.6 4 DONUT Những điểm nổi bật của nền tảng
Android 1.5 3 CUPCAKE Những điểm nổi bật của nền tảng
Android 1.1 2 BASE_1_1
Android 1.0 1 BASE

Sử dụng cấp độ API trong Android

Giá trị nhận dạng cấp độ API đóng vai trò quan trọng trong việc đảm bảo trải nghiệm tốt nhất có thể cho người dùng và nhà phát triển ứng dụng:

  • API này cho phép nền tảng Android mô tả bản sửa đổi API khung tối đa mà nền tảng hỗ trợ
  • API này cho phép các ứng dụng mô tả bản sửa đổi API khung mà chúng yêu cầu
  • API này cho phép hệ thống thương lượng việc cài đặt các ứng dụng trên thiết bị của người dùng, chẳng hạn như các ứng dụng không tương thích với phiên bản đã được cài đặt.

Mỗi phiên bản nền tảng Android đều lưu trữ mã nhận dạng cấp độ API trong hệ thống Android.

Các ứng dụng có thể sử dụng phần tử tệp kê khai do API khung cung cấp –<uses-sdk> – để mô tả Cấp độ API tối thiểu và tối đa mà chúng có thể chạy, cũng như Cấp độ API ưu tiên mà các phần tử đó được thiết kế để hỗ trợ. Phần tử cung cấp ba thuộc tính chính:

  • android:minSdkVersion – Chỉ định Cấp độ API tối thiểu mà ứng dụng có thể chạy. Giá trị mặc định là "1".
  • android:targetSdkVersion – Chỉ định cấp độ API mà ứng dụng được thiết kế để chạy. Trong một số trường hợp, điều này cho phép ứng dụng sử dụng các phần tử hoặc hành vi tệp kê khai được xác định trong Cấp độ API mục tiêu thay vì chỉ bị hạn chế sử dụng các phần tử đã được xác định cho Cấp độ API tối thiểu.
  • android:maxSdkVersion – Chỉ định Cấp độ API tối đa mà ứng dụng có thể chạy. Quan trọng: Vui lòng đọc tài liệu về <uses-sdk> trước khi sử dụng thuộc tính này.

Ví dụ: để chỉ định Cấp độ API tối thiểu của hệ thống mà một ứng dụng đòi hỏi phải có để chạy, ứng dụng đó có thể đưa tệp kê khai vào phần tử <uses-sdk> có thuộc tính android:minSdkVersion. Giá trị của android:minSdkVersion sẽ là số nguyên tương ứng với Cấp độ API của phiên bản nền tảng Android ban đầu mà ứng dụng có thể chạy.

Khi người dùng cố gắng cài đặt một ứng dụng hoặc khi xác thực lại bản sao sau khi cập nhật hệ thống, trước tiên, hệ thống Android sẽ kiểm tra các thuộc tính <uses-sdk> trong tệp kê khai của ứng dụng và so sánh các giá trị với Cấp API nội bộ của chính nó. Hệ thống chỉ cho phép cài đặt bắt đầu nếu các điều kiện này được đáp ứng:

  • Nếu bạn khai báo thuộc tính android:minSdkVersion thì giá trị của thuộc tính đó phải nhỏ hơn hoặc bằng số nguyên Cấp độ API của hệ thống. Nếu không được khai báo, hệ thống sẽ giả định rằng ứng dụng yêu cầu API cấp độ 1.
  • Nếu bạn khai báo thuộc tính android:maxSdkVersion thì giá trị của thuộc tính đó phải bằng hoặc lớn hơn số nguyên Cấp độ API của hệ thống. Nếu không được khai báo, hệ thống sẽ giả định rằng ứng dụng không có Cấp độ API tối đa. Vui lòng đọc tài liệu về <uses-sdk> để biết thêm thông tin về cách hệ thống xử lý thuộc tính này.

Khi được khai báo trong tệp kê khai của một ứng dụng, phần tử <uses-sdk> sẽ có dạng như sau:

<manifest>
  <uses-sdk android:minSdkVersion="5" />
  ...
</manifest>

Lý do chính khiến một ứng dụng khai báo Cấp độ API trong android:minSdkVersion là để cho hệ thống Android biết ứng dụng đó đang sử dụng các API đã được giới thiệu trong Cấp độ API được chỉ định. Nếu ứng dụng phải cài đặt theo cách nào đó trên nền tảng có Cấp độ API thấp hơn, ứng dụng sẽ gặp lỗi thời gian chạy khi cố gắng truy cập vào các API không tồn tại. Hệ thống sẽ ngăn chặn kết quả như vậy bằng cách không cho phép cài đặt ứng dụng nếu Cấp độ API thấp nhất mà ứng dụng đòi hỏi cao hơn phiên bản nền tảng trên thiết bị mục tiêu.

Ví dụ: gói android.appwidget được giới thiệu có API Cấp độ 3. Nếu sử dụng API đó, thì một ứng dụng phải khai báo thuộc tính android:minSdkVersion có giá trị là "3". Sau đó, ứng dụng sẽ có thể cài đặt trên các nền tảng như Android 1.5 (API cấp độ 3) và Android 1.6 (API cấp độ 4), nhưng không thể cài đặt trên các nền tảng Android 1.1 (API cấp độ 2) và Android 1.0 (API cấp độ 1).

Để biết thêm thông tin về cách chỉ định yêu cầu cấp độ API của một ứng dụng, hãy xem mục <uses-sdk> trong tài liệu về tệp kê khai.

Các cân nhắc khi phát triển

Các phần dưới đây cung cấp thông tin liên quan đến cấp độ API mà bạn nên cân nhắc khi phát triển ứng dụng của mình.

Khả năng tương thích chuyển tiếp của ứng dụng

Các ứng dụng Android thường tương thích chuyển tiếp với các phiên bản mới của nền tảng Android.

Hầu hết các thay đổi đối với API khung đều mang tính bổ sung, do đó, một ứng dụng Android được phát triển sử dụng bất kỳ phiên bản cụ thể nào của API (như đã chỉ định ở cấp độ API) đều tương thích chuyển tiếp với các phiên bản sau của nền tảng Android và các cấp độ API cao hơn. Ứng dụng phải chạy được trên tất cả các phiên bản mới hơn của nền tảng Android, ngoại trừ một số trường hợp khi ứng dụng sử dụng một phần của API sau đó bị xóa vì lý do nào đó.

Khả năng tương thích chuyển tiếp rất quan trọng vì nhiều thiết bị chạy Android nhận được bản cập nhật hệ thống không dây (OTA). Người dùng có thể cài đặt ứng dụng của bạn và sử dụng thành công, sau đó nhận bản cập nhật OTA cho một phiên bản mới trên nền tảng Android. Sau khi bản cập nhật được cài đặt, ứng dụng của bạn sẽ chạy trong phiên bản chạy thực mới, nhưng phiên bản đó có API và các năng lực hệ thống mà ứng dụng của bạn phụ thuộc.

Trong một số trường hợp, những thay đổi dưới API như các thay đổi về chính hệ thống cơ bản có thể ảnh hưởng đến ứng dụng của bạn khi ứng dụng được chạy trong môi trường mới. Vì lý do đó, bạn, với vai trò nhà phát triển ứng dụng, phải hiểu rõ cách ứng dụng hiển thị và hoạt động trong từng môi trường hệ thống. Để giúp bạn kiểm thử ứng dụng của mình trên các phiên bản khác nhau của nền tảng Android, Android SDK gồm nhiều nền tảng mà bạn có thể tải xuống. Mỗi nền tảng bao gồm một hình ảnh hệ thống tương thích có thể chạy trong AVD để kiểm thử ứng dụng của bạn.

Khả năng tương thích ngược của ứng dụng

Các ứng dụng Android không nhất thiết phải tương thích ngược với các phiên bản nền tảng Android cũ hơn phiên bản đã được biên dịch.

Mỗi phiên bản mới của nền tảng Android có thể bao gồm các API khung mới, chẳng hạn như các API cho phép ứng dụng truy cập vào các tính năng mới của nền tảng hoặc thay thế các phần API hiện có. Các API mới có thể truy cập vào ứng dụng khi chạy trên nền tảng mới và như đã đề cập ở trên, cũng như khi chạy trên các phiên bản mới hơn của nền tảng được chỉ định theo Cấp độ API. Ngược lại, vì các phiên bản cũ của nền tảng không bao gồm API mới, nên các ứng dụng sử dụng API mới không thể chạy trên các nền tảng đó.

Mặc dù ít có khả năng một thiết bị chạy Android sẽ bị hạ cấp xuống phiên bản trước đó của nền tảng, nhưng quan trọng phải nhận ra là có nhiều thiết bị trong lĩnh vực này chạy các phiên bản trước đó của nền tảng. Ngay cả trong số những thiết bị nhận được bản cập nhật OTA, một số thiết bị có thể bị trễ và có thể không nhận được bản cập nhật trong khoảng thời gian đáng kể.

Chọn một phiên bản nền tảng và cấp độ API

Khi đang phát triển ứng dụng, cần chọn phiên bản nền tảng mà bạn sẽ biên dịch ứng dụng. Nhìn chung, bạn nên biên dịch ứng dụng trên phiên bản thấp nhất có thể của nền tảng mà ứng dụng của bạn có thể hỗ trợ.

Bạn có thể xác định phiên bản nền tảng thấp nhất có thể bằng cách biên dịch ứng dụng dựa theo mục tiêu bản dựng thấp hơn kế tiếp. Sau khi xác định phiên bản thấp nhất, bạn nên tạo AVD bằng cách sử dụng phiên bản nền tảng tương ứng (và Cấp độ API) và kiểm thử đầy đủ ứng dụng của bạn. Hãy nhớ khai báo một thuộc tínhnandroid:minSdkVersion trong tệp kê khai của ứng dụng và đặt giá trị của thuộc tính đó về Cấp độ API của phiên bản nền tảng.

Khai báo Cấp độ API thấp nhất

Nếu xây dựng một ứng dụng sử dụng API hoặc các tính năng hệ thống được giới thiệu trong phiên bản nền tảng mới nhất, bạn nên đặt thuộc tính android:minSdkVersion về Cấp độ API của phiên bản nền tảng mới nhất. Điều này đảm bảo người dùng sẽ chỉ có thể cài đặt ứng dụng của bạn nếu thiết bị của họ đang chạy một phiên bản tương thích của nền tảng Android. Đổi lại, điều này đảm bảo ứng dụng của bạn có thể hoạt động đúng cách trên các thiết bị của họ.

Nếu ứng dụng của bạn sử dụng các API được giới thiệu trong phiên bản nền tảng mới nhất nhưng không khai báo thuộc tính android:minSdkVersion, thì ứng dụng đó sẽ chạy đúng cách trên các thiết bị chạy phiên bản mới nhất của nền tảng, nhưng không sử dụng được trên thiết bị chạy các phiên bản cũ hơn của nền tảng. Trong trường hợp sau, ứng dụng sẽ gặp lỗi trong thời gian chạy khi cố gắng sử dụng các API không có trong các phiên bản trước đó.

Kiểm thử với các cấp độ API cao hơn

Sau khi biên dịch ứng dụng, bạn nhớ kiểm tra ứng dụng đó trên nền tảng được chỉ định trong thuộc tính android:minSdkVersion của ứng dụng. Để làm điều đó, hãy tạo một AVD sử dụng phiên bản nền tảng mà ứng dụng của bạn đòi hỏi. Ngoài ra, để đảm bảo khả năng tương thích chuyển tiếp, bạn nên chạy và kiểm thử ứng dụng trên tất cả các nền tảng sử dụng Cấp độ API cao hơn so với cấp độ API mà ứng dụng của bạn sử dụng.

Android SDK gồm nhiều phiên bản nền tảng mà bạn có thể sử dụng, bao gồm cả phiên bản mới nhất và cung cấp công cụ cập nhật có thể sử dụng để tải xuống các phiên bản nền tảng khác khi cần.

Để truy cập vào trình cập nhật, hãy sử dụng công cụ dòng lệnh android nằm trong thư mục <sdk>/tools. Bạn có thể chạy trình cập nhật SDK bằng cách thực thi android sdk. Bạn cũng có thể chỉ cần nhấp đúp vào tệp android.bat (Windows) hoặc android (OS X/Linux).

Để chạy ứng dụng của bạn dựa trên các phiên bản nền tảng khác nhau trong trình mô phỏng, hãy tạo AVD cho từng phiên bản nền tảng mà bạn muốn kiểm tra. Để biết thêm thông tin về AVD, hãy xem phần Tạo và quản lý thiết bị ảo. Nếu đang sử dụng một thiết bị thực tế để kiểm tra, hãy đảm bảo bạn biết Cấp độ API của nền tảng Android mà nó chạy. Hãy xem bảng ở đầu tài liệu này để biết danh sách các phiên bản nền tảng và Cấp độ API của các phiên bản đó.

Lọc Bộ tài liệu Tham khảo theo cấp độ API

Các trang tài liệu tham khảo về nền tảng Android cung cấp tùy chọn kiểm soát "Cấp độ API" ở khu vực trên bên trái mỗi trang. Bạn có thể sử dụng tùy chọn kiểm soát để chỉ hiển thị tài liệu cho các phần của API thực sự có thể truy cập vào ứng dụng của bạn, dựa trên Cấp độ API mà ứng dụng chỉ định trong thuộc tính android:minSdkVersion của tệp kê khai.

Để sử dụng tính năng lọc, hãy đánh dấu vào hộp đánh dấu để bật tính năng lọc, hộp này nằm ngay bên dưới hộp tìm kiếm trang. Sau đó, đặt tùy chọn kiểm soát "Lọc theo cấp độ API" thành cùng Cấp độ API do ứng dụng chỉ định. Lưu ý các API được giới thiệu ở một cấp độ API sau đó sẽ chuyển sang màu xám và nội dung của chúng sẽ được che giấu vì ứng dụng của bạn sẽ không thể truy cập vào các API đó.

Việc lọc theo Cấp độ API trong tài liệu không cung cấp chế độ xem nội dung mới hoặc được giới thiệu ở từng Cấp độ API — nó chỉ cung cấp cách xem toàn bộ API liên kết với một Cấp độ API nhất định, đồng thời loại trừ phần tử API được giới thiệu ở các cấp độ API sau.

Nếu không muốn lọc tài liệu API, bạn chỉ cần tắt tính năng đó bằng cách sử dụng hộp đánh dấu. Theo mặc định, tính năng lọc Cấp độ API sẽ bị tắt để bạn có thể xem toàn bộ API khung bất kể Cấp độ API.

Ngoài ra vui lòng lưu ý tài liệu tham khảo cho từng phần tử API cho biết Cấp độ API mà mỗi phần tử được giới thiệu. Cấp độ API cho các gói và lớp học được chỉ định là "Since <api level>" ở góc trên bên phải vùng nội dung trên mỗi trang tài liệu. Cấp độ API cho các thành viên trong lớp được chỉ định trong tiêu đề mô tả chi tiết của chúng ở lề phải.