Gói thư viện hỗ trợ

Lưu ý: Với bản phát hành Thư viện hỗ trợ 28.0.0, gói android.support đã đóng gói các thư viện không được dùng nữa và được thay thế bằng Jetpack phiên bản riêng lẻ thư viện được đóng gói dưới dạng androidx. Phiên bản 1.0.0 ban đầu bản phát hành thư viện Jetpack tương đương với Thư viện hỗ trợ 28.0.0 và cung cấp một điểm xuất phát để di chuyển sang androidx mới đóng gói.

Các thư viện đóng gói android.support hiện có sẽ tiếp tục hoạt động; tuy nhiên, chúng sẽ không nhận được bản cập nhật vượt quá 28.0.0 và sẽ không tương thích với các thư viện Jetpack mới. Hiện vật lịch sử (những phiên bản từ 27 trở về trước và được đóng gói dưới dạng android.support) vẫn sẽ có mặt trên Google Maven. Tất cả cấu phần phần mềm mới sẽ được đóng gói dưới dạng androidx và sẽ yêu cầu di chuyển từ android.support thành androidx.

Bạn nên sử dụng thư viện androidx trong tất cả dự án mới. Bạn cũng nên cân nhắc việc di chuyển các dự án hiện có để đảm bảo chúng tiếp tục nhận được các bản sửa lỗi và cải tiến khác về thư viện.

Thư viện hỗ trợ Android chứa một số gói thư viện có thể đưa vào được trong ứng dụng của bạn. Mỗi thư viện trong số này hỗ trợ một loạt nền tảng Android cụ thể các phiên bản và bộ tính năng.

Để sử dụng bất kỳ thư viện nào sau đây, bạn phải tải các tệp thư viện xuống Cài đặt SDK Android. Làm theo hướng dẫn để tải Thư viện hỗ trợ xuống trong Thiết lập Thư viện hỗ trợ để hoàn thành bước này. Bạn phải thực hiện các bước bổ sung để thêm một Thư viện hỗ trợ cụ thể vào ứng dụng của bạn. Hãy xem cuối mỗi phần thư viện dưới đây để biết thông tin quan trọng về cách đưa thư viện vào ứng dụng của bạn.

Lưu ý: Phiên bản SDK tối thiểu dành cho tất cả dịch vụ hỗ trợ gói thư viện ít nhất là API cấp 14. Một số gói yêu cầu API cao hơn như được nêu bên dưới.

Thư viện hỗ trợ v4

Các thư viện này bao gồm bộ API lớn nhất so với các thư viện khác, bao gồm hỗ trợ cho các thành phần ứng dụng, tính năng giao diện người dùng, khả năng hỗ trợ tiếp cận, xử lý dữ liệu, kết nối mạng và lập trình phần mềm tiện ích.

Để biết thông tin đầy đủ, chi tiết về các lớp và phương thức do các thư viện hỗ trợ phiên bản 4, hãy xem gói android.support.v4 trong tài liệu tham khảo API.

Lưu ý: Trước bản sửa đổi Thư viện hỗ trợ 24.2.0, có một thư viện hỗ trợ v4 đơn. Thư viện đó được chia thành nhiều mô-đun để nâng cao hiệu quả. Để có khả năng tương thích ngược, nếu bạn liệt kê support-v4 trong tập lệnh Gradle, ứng dụng của bạn sẽ bao gồm tất cả các mô-đun v4. Tuy nhiên, để giảm kích thước ứng dụng, bạn chỉ nên liệt kê các mô-đun cụ thể mà ứng dụng của bạn cần.

thư viện khả năng tương thích v4

Cung cấp trình bao bọc khả năng tương thích cho một số API khung, chẳng hạn như Context.obtainDrawable() và View.performAccessibilityAction()

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:support-compat:28.0.0

thư viện Core-utils phiên bản 4

Cung cấp một số lớp tiện ích, chẳng hạn như AsyncTaskLoader và PermissionChecker.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau: 

com.android.support:support-core-utils:28.0.0

thư viện giao diện người dùng lõi phiên bản 4

Triển khai nhiều thành phần liên quan đến giao diện người dùng, chẳng hạn như ViewPager, NestedScrollView và ExploreByTouchHelper.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau: 

com.android.support:support-core-ui:28.0.0

thư viện media-compat phiên bản 4

Điều chỉnh cho phiên bản cũ các phần của khung media bao gồm MediaBrowser và MediaSession.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau: 

com.android.support:support-media-compat:28.0.0

thư viện mảnh v4

Bổ sung tính năng hỗ trợ đóng gói giao diện người dùng và chức năng bằng mảnh, cho phép ứng dụng cung cấp bố cục điều chỉnh giữa kích thước nhỏ và thiết bị có màn hình lớn. Mô-đun này có các phần phụ thuộc trên compat, core-utils, core-ui và media-compat.

Lưu ý: Thư viện hỗ trợ phiên bản 13 cung cấp một lớp FragmentCompat. Phiên bản 4 Lớp Fragment là một lớp độc lập cung cấp các bản sửa lỗi được thêm vào trong các phiên bản nền tảng sau này, trong khi Lớp FragmentCompat v13 cung cấp miếng đệm tương thích cho việc triển khai khung của Fragment.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau: 

com.android.support:support-fragment:28.0.0

Thư viện hỗ trợ Multidex

Thư viện này hỗ trợ xây dựng các ứng dụng có nhiều tệp có thể thực thi Dalvik (DEX). Các ứng dụng tham chiếu đến hơn 65536 phương thức bắt buộc phải sử dụng cấu hình multidex. Cho thông tin khác về cách sử dụng multidex, hãy xem Xây dựng ứng dụng bằng hơn 64 nghìn phương pháp.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau: 

com.android.support:multidex:1.0.0

Thư viện hỗ trợ v7

Các thư viện này cung cấp các bộ tính năng cụ thể và có thể được đưa vào ứng dụng của bạn độc lập với nhau.

thư viện appcompat phiên bản 7 Một phần của Android Jetpack.

Lưu ý: Thư viện appcompat đã di chuyển vào Thư viện AndroidX, là một Android Jetpack. Xem công cụ này được sử dụng trong Ứng dụng minh hoạ Sunflower.

Thư viện này hỗ trợ thêm cho Người dùng Thanh thao tác thiết kế giao diện . Thư viện này bao gồm hỗ trợ cho giao diện người dùng Material Design thực tế.

Lưu ý: Thư viện này phụ thuộc vào Thư viện hỗ trợ v4.

Dưới đây là một số lớp chính có trong thư viện appcompat của v7:

  • ActionBar – Cung cấp cách triển khai thanh thao tác mẫu giao diện người dùng. Để biết thêm thông tin về cách sử dụng Thanh tác vụ, hãy xem Hướng dẫn cho nhà phát triển về Thanh thao tác.
  • AppCompatActivity – Thêm một lớp hoạt động ứng dụng có thể được dùng làm lớp cơ sở cho các hoạt động sử dụng thanh thao tác của Thư viện hỗ trợ trong quá trình triển khai.
  • AppCompatDialog – Thêm một lớp hộp thoại có thể dùng làm cơ sở cho các hộp thoại theo chủ đề AppCompat.
  • ShareActionProvider - Thêm hỗ trợ cho tiêu chuẩn hành động chia sẻ (chẳng hạn như email hoặc đăng lên các ứng dụng xã hội) có thể được đưa vào thuộc tính thanh tác vụ.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:appcompat-v7:28.0.0

thư viện chế độ xem thẻ phiên bản 7

Thư viện này hỗ trợ thêm cho CardView giúp bạn hiển thị thông tin bên trong các thẻ có giao diện nhất quán trên bất kỳ ứng dụng nào. Các thẻ này hữu ích cho Material Design và được sử dụng rộng rãi trong bố cục cho các ứng dụng TV.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:cardview-v7:28.0.0

thư viện layoutlayout phiên bản 7

Sau khi bạn tải Thư viện hỗ trợ Android xuống, thư viện này sẽ thêm tính năng hỗ trợ cho GridLayout lớp cho phép bạn sắp xếp các thành phần trên giao diện người dùng bằng cách sử dụng một lưới gồm các ô hình chữ nhật. Để biết thông tin chi tiết về các API thư viện layoutlayout v7, hãy xem Gói android.support.v7.widget trong tài liệu tham khảo API.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:gridlayout-v7:28.0.0

thư viện mediarouter v7

Thư viện này cung cấp MediaRouter, MediaRouteProvider và các lớp nội dung nghe nhìn có liên quan hỗ trợ Google Cast.

Nhìn chung, các API trong thư viện mediarouter v7 cung cấp một phương tiện kiểm soát việc định tuyến các kênh và luồng truyền thông từ thiết bị hiện tại đến màn hình bên ngoài, loa và các thiết bị đích khác. Thư viện bao gồm Các API để xuất bản nhà cung cấp định tuyến nội dung đa phương tiện dành riêng cho ứng dụng, để khám phá và chọn thiết bị đích, để kiểm tra trạng thái nội dung nghe nhìn, v.v. Để biết thông tin chi tiết thông tin về API thư viện mediarouter v7, hãy xem Gói android.support.v7.media trong API tham chiếu.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:mediarouter-v7:28.0.0

API thư viện mediarouter v7 được giới thiệu trong Thư viện hỗ trợ r18 có thể thay đổi trong các bản sửa đổi sau này của Thư viện hỗ trợ. Lúc này chúng tôi khuyên bạn chỉ nên sử dụng thư viện liên quan đến Google Cast.

thư viện bảng khung hiển thị v7

Thư viện hỗ trợ bảng khung hiển thị v7 bao gồm Lớp Palette cho phép bạn trích xuất các màu nổi bật từ một hình ảnh. Ví dụ: ứng dụng âm nhạc có thể sử dụng Đối tượng Palette để trích xuất các màu chính từ bìa đĩa nhạc rồi sử dụng những màu đó để tạo nên một bài hát được phối màu thẻ tiêu đề.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:palette-v7:28.0.0

thư viện recyclerview v7

Thư viện recyclerview sẽ thêm RecyclerView . Lớp này cung cấp hỗ trợ cho RecyclerView tiện ích con, một chế độ xem để hiển thị hiệu quả các tập dữ liệu lớn bằng cách cung cấp một cửa sổ giới hạn các mục dữ liệu.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:recyclerview-v7:28.0.0

Thư viện hỗ trợ lựa chọn ưu tiên v7

Chiến lược phát hành đĩa đơn lựa chọn ưu tiên gói cung cấp API để hỗ trợ việc thêm đối tượng lựa chọn ưu tiên, chẳng hạn như CheckBoxPreference và ListPreference cho người dùng sửa đổi chế độ cài đặt giao diện người dùng.

Thư viện Lựa chọn ưu tiên v7 hỗ trợ thêm các giao diện, chẳng hạn như Preference.OnPreferenceChangeListener và Preference.OnPreferenceClickListener và các lớp, chẳng hạn như CheckBoxPreference và ListPreference.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:preference-v7:28.0.0

Thư viện hỗ trợ phiên bản 8

Thư viện này cung cấp các bộ tính năng cụ thể và có thể được đưa vào ứng dụng của bạn một cách độc lập với các thư viện khác.

thư viện RenderScript v8

Thư viện này hỗ trợ thêm cho phép tính RenderScript khung. Các API này có trong gói android.support.v8.renderscript. Bạn xin lưu ý rằng các bước để đưa những API này vào ứng dụng của bạn rất khác biệt với các API thư viện hỗ trợ khác. Để biết thêm thông tin về cách sử dụng các API này trong ứng dụng của mình, hãy xem RenderScript hướng dẫn cho nhà phát triển.

Lưu ý: Android có hỗ trợ việc sử dụng RenderScript với thư viện hỗ trợ Các bản dựng dựa trên Studio và Gradle. Chiến lược phát hành đĩa đơn thư viện RenderScript nằm trong thư mục build-tools/$VERSION/renderscript/.

Ví dụ sau đây cho thấy các thuộc tính của tập lệnh bản dựng Gradle cho thư viện này:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Thư viện hỗ trợ phiên bản 13

Thư viện này hỗ trợ thêm cho mẫu giao diện người dùng Fragment với lớp (FragmentCompat) và khả năng hỗ trợ mảnh bổ sung khác. Để biết thêm thông tin về mảnh, hãy xem Hướng dẫn cho nhà phát triển về Mảnh. Để biết thông tin chi tiết thông tin về các API Thư viện hỗ trợ phiên bản 13, hãy xem gói android.support.v13 trong tài liệu tham khảo API.

Lưu ý: Thư viện mảnh phiên bản 4 cung cấp một lớp Fragment. Phiên bản 4 Lớp Fragment là một lớp độc lập cung cấp các bản sửa lỗi được thêm vào trong các phiên bản nền tảng sau này, trong khi Lớp FragmentCompat v13 cung cấp miếng đệm tương thích cho việc triển khai khung của Fragment.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:support-v13:28.0.0

Thư viện hỗ trợ lựa chọn ưu tiên phiên bản 14

Gói android.support.v14.preference cung cấp các API để thêm tính năng hỗ trợ cho các giao diện ưu tiên như PreferenceFragment.OnPreferenceStartFragmentCallback và PreferenceFragment.OnPreferenceStartScreenCallback, cùng với các lớp học, chẳng hạn như MultiSelectListPreference và PreferenceFragment. Để biết thông tin chi tiết thông tin về API Thư viện hỗ trợ lựa chọn ưu tiên phiên bản 14, hãy xem lựa chọn ưu tiên trong tài liệu tham khảo API.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:preference-v14:28.0.0

Thư viện hỗ trợ lựa chọn ưu tiên phiên bản 17 cho TV

Gói android.support.v17.preference cung cấp các API để cung cấp lựa chọn ưu tiên giao diện trên thiết bị TV, bao gồm cả tính năng hỗ trợ LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener giao diện và lớp, chẳng hạn như BaseLeanbackPreferenceFragment và LeanbackPreferenceFragment. Để biết thông tin chi tiết thông tin về API Thư viện hỗ trợ lựa chọn ưu tiên v17, hãy xem lựa chọn ưu tiên trong tài liệu tham khảo API.

Gói này yêu cầu API cấp 17 trở lên. Tập lệnh bản dựng Gradle giá trị nhận dạng phần phụ thuộc cho thư viện này như sau:

 com.android.support:preference-leanback-v17:28.0.0

Thư viện Leanback phiên bản 17

Gói android.support.v17.leanback cung cấp các API để hỗ trợ xây dựng giao diện người dùng trên các thiết bị TV. Cửa sổ này cung cấp một số tiện ích quan trọng cho ứng dụng TV. Có một số lớp đáng chú ý như sau:

Gói này yêu cầu API cấp 17 trở lên. Tập lệnh bản dựng Gradle giá trị nhận dạng phần phụ thuộc cho thư viện này như sau:

com.android.support:leanback-v17:28.0.0

Thư viện vectơ vẽ được

Hỗ trợ đồ hoạ vectơ tĩnh.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này có dạng là sau:

com.android.support:support-vector-drawable:28.0.0

Thư viện vectơ vẽ được ở dạng động

Hỗ trợ đồ hoạ vectơ động.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này có dạng là sau:

com.android.support:animated-vector-drawable:28.0.0

Thư viện hỗ trợ chú thích

Chú thích gói cung cấp các API để hỗ trợ việc thêm siêu dữ liệu chú thích vào ứng dụng.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:support-annotations:28.0.0

Thư viện hỗ trợ thiết kế

Chiến lược phát hành đĩa đơn Gói Thiết kế cung cấp API để hỗ trợ việc thêm các thành phần và mẫu Material Design vào ứng dụng của bạn.

Thư viện Design Support (Hỗ trợ thiết kế) hỗ trợ thêm nhiều thành phần và mẫu Material Design cho để nhà phát triển ứng dụng dựa vào đó, chẳng hạn như ngăn điều hướng, nút hành động nổi (FAB), thanh thông báo nhanh và thẻ.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:design:28.0.0

Thư viện hỗ trợ thẻ tuỳ chỉnh

Chiến lược phát hành đĩa đơn Thẻ tuỳ chỉnh gói cung cấp các API để hỗ trợ việc thêm và quản lý các thẻ tuỳ chỉnh trong ứng dụng của bạn.

Thư viện hỗ trợ Thẻ tuỳ chỉnh hỗ trợ thêm nhiều lớp, chẳng hạn như Thẻ tuỳ chỉnh Dịch vụ và Thẻ tuỳ chỉnh Lệnh gọi lại.

Gói này yêu cầu API cấp 15 trở lên. Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:customtabs:28.0.0

Thư viện hỗ trợ Percent

Chiến lược phát hành đĩa đơn Phần trăm gói cung cấp các API để hỗ trợ việc thêm và quản lý dựa trên tỷ lệ phần trăm trong ứng dụng của bạn.

Lưu ý: Kể từ bản phát hành 26.0.0, thư viện phần trăm hỗ trợ sẽ ngừng hoạt động. Các ứng dụng của mô-đun này cần di chuyển sang ConstraintLayout mới được cung cấp dưới dạng cấu phần phần mềm riêng biệt trong Trình quản lý SDK.

Thư viện phần trăm hỗ trợ sẽ thêm dịch vụ hỗ trợ cho Giao diện PercentLayoutHelper.PercentLayoutParams và nhiều lớp khác nhau, chẳng hạn như PercentFrameLayout và PercentCompatLayout.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:percent:28.0.0

Thư viện hỗ trợ ExifInterface

Thẻ Exif lưu trữ thông tin như hướng, ngày và giờ, camera và vị trí trực tiếp trong tệp JPEG hoặc RAW. ExifInterface hỗ trợ tách lớp để đọc thông tin Exif từ JPEG và thô (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW và RAF) được định dạng và đặt thông tin Exif trên tệp hình ảnh JPEG.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau: 

com.android.support:exifinterface:28.0.0

Thư viện hỗ trợ đề xuất ứng dụng cho TV

Chiến lược phát hành đĩa đơn Ứng dụng Nội dung đề xuất gói cung cấp các API để hỗ trợ việc thêm đề xuất nội dung trong ứng dụng chạy trên thiết bị TV.

Thư viện ứng dụng hỗ trợ thêm các chú giải, chẳng hạn như ContentĐề xuất.ContentMaturity và các lớp khác nhau, chẳng hạn như ContentRecommended và Đề xuất mở rộng.

Gói này yêu cầu API cấp 21 trở lên. Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau:

com.android.support:recommendation:28.0.0

Thư viện giao diện người dùng Wear

Thư viện này có các API để xây dựng giao diện người dùng cho ứng dụng Wear. Các API này, có trong android.support.wear.Widget, thay thế các API tương ứng trong Thư viện hỗ trợ thiết bị đeo.

Để biết thêm thông tin, hãy xem Sử dụng Thư viện giao diện người dùng Wear.

Giá trị nhận dạng phần phụ thuộc của tập lệnh bản dựng Gradle cho thư viện này như sau: 

com.android.support:wear:28.0.0