Lưu ý: Khi phát hành Thư viện hỗ trợ 28.0.0, các thư viện được đóng gói android.support sẽ ngừng hoạt động và được thay thế bằng các thư viện Jetpack có phiên bản riêng lẻ được đóng gói dưới dạng androidx. Bản phát hành 1.0.0 ban đầu của các thư viện Jetpack cung cấp tính tương đương với Thư viện hỗ trợ 28.0.0 và cung cấp điểm bắt đầu để di chuyển sang hoạt động đóng gói androidx mới.
Các thư viện hiện có được đóng gói bằng android.support sẽ tiếp tục hoạt động; tuy nhiên, các thư viện này sẽ không nhận được bất kỳ bản cập nhật nào sau phiên bản 28.0.0 và sẽ không tương thích với các thư viện Jetpack mới.
Các cấu phần phần mềm cũ (những cấu phần có phiên bản 27 trở về trước và được đóng gói dưới dạng android.support) sẽ vẫn có 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 sang androidx.
Bạn nên sử dụng các thư viện androidx trong tất cả cá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 các dự án đó tiếp tục nhận được bản sửa lỗi và các điểm cải tiến khác của thư viện.
Thư viện hỗ trợ Android chứa một số gói thư viện mà bạn có thể đưa vào ứng dụng của mình. Mỗi thư viện trong số này hỗ trợ một phạm vi cụ thể các phiên bản nền tảng Android 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 bản cài đặt Android SDK. Làm theo hướng dẫn tải Thư viện hỗ trợ trong phần Thiết lập Thư viện hỗ trợ để hoàn tất bước này. Bạn phải thực hiện các bước bổ sung để đưa một Thư viện hỗ trợ cụ thể vào ứng dụng của mình. Xem phần cuối của mỗi phần thư viện bên dưới để 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 cho tất cả các gói thư viện hỗ trợ là ít nhất API cấp 14. Một số gói yêu cầu cấp độ API cao hơn, như lư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 cả việc hỗ trợ 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, khả năng kết nối mạng và các tiện ích lập trình.
Để biết thông tin đầy đủ và chi tiết về các lớp và phương thức do thư viện hỗ trợ v4 cung cấp, 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 24.2.0 của Thư viện hỗ trợ, chỉ có một thư viện hỗ trợ v4. Thư viện đó được chia thành nhiều mô-đun để cải thiện hiệu quả. Để đảm bảo 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 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 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 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 core-ui 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 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 v4
Backport các phần của khung media, bao gồm cả MediaBrowser và MediaSession.
Giá trị nhận dạng phần phụ thuộc 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
Thêm tính năng hỗ trợ đóng gói giao diện người dùng và chức năng bằng các mảnh, cho phép các ứng dụng cung cấp bố cục điều chỉnh giữa thiết bị có màn hình nhỏ và lớn. Mô-đun này có các phần phụ thuộc vào compat, core-utils, core-ui và media-compat.
Lưu ý: Thư viện hỗ trợ v13 cung cấp một lớp FragmentCompat. Lớp Fragment v4 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 các lớp tương thích cho việc triển khai khung của lớp Fragment.
Giá trị nhận dạng phần phụ thuộc 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ợ việc tạo ứng dụng bằng nhiều tệp có thể thực thi Dalvik (DEX). Những ứng dụng tham chiếu đến hơn 65.536 phương thức phải sử dụng cấu hình multidex. Để biết thêm thông tin về cách sử dụng multidex, hãy xem bài viết Tạo ứng dụng có hơn 64.000 phương thức.
Giá trị nhận dạng phần phụ thuộc 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 những 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 nhau.
Thư viện appcompat v7 Một phần của Android Jetpack.
Lưu ý:Thư viện appcompat đã di chuyển vào thư viện AndroidX. Đây là một thành phần Android Jetpack. Xem cách sử dụng trong ứng dụng minh hoạ Sunflower.
Thư viện này hỗ trợ thêm cho Thanh thao tác trong mẫu thiết kế giao diện người dùng. Thư viện này hỗ trợ các hoạt động triển khai giao diện người dùng Material Design.
Lưu ý: Thư viện này phụ thuộc vào Thư viện hỗ trợ phiên bản 4.
Sau đây là một số lớp chính có trong thư viện appcompat v7:
ActionBar– Cung cấp một cách triển khai mẫu giao diện người dùng của thanh thao tác. Để biết thêm thông tin về cách sử dụng Thanh thao tác, hãy xem hướng dẫn dành cho nhà phát triển về Thanh thao tác.AppCompatActivity– Thêm một lớp hoạt động của ứng dụng có thể dùng làm lớp cơ sở cho các hoạt động sử dụng chế độ triển khai thanh thao tác của Thư viện hỗ trợ.AppCompatDialog– Thêm một lớp hộp thoại có thể dùng làm lớp cơ sở cho các hộp thoại theo chủ đề AppCompat.ShareActionProvider– Thêm tính năng hỗ trợ cho một thao tác chia sẻ chuẩn hoá (chẳng hạn như gửi email hoặc đăng lên các ứng dụng mạng xã hội) có thể được đưa vào một thanh thao tác.
Giá trị nhận dạng phần phụ thuộc 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 cardview v7
Thư viện này bổ sung khả năng hỗ trợ cho tiện ích CardView, cho phép bạn hiện thông tin bên trong các thẻ có giao diện nhất quán trên mọi ứng dụng. Các thẻ này rất hữu ích cho việc triển khai thiết kế theo ngôn ngữ Material và được sử dụng rộng rãi trong bố cục cho các ứng dụng truyền hình.
Giá trị nhận dạng phần phụ thuộc 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 gridlayout v7
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 lớp GridLayout. Lớp này cho phép bạn sắp xếp các phần tử trên giao diện người dùng bằng cách sử dụng một lưới các ô hình chữ nhật.
Để biết thông tin chi tiết về các API thư viện gridlayout 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 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 phiên bản 7 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 nội dung nghe nhìn từ thiết bị hiện tại đến các màn hình, loa và thiết bị đích bên ngoài khác. Thư viện này bao gồm các API để xuất bản nhà cung cấp tuyến đường truyền phát nội dung nghe nhì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 về các API thư viện mediarouter phiên bản 7, hãy xem gói android.support.v7.media trong tài liệu tham khảo về API.
Giá trị nhận dạng phần phụ thuộc 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
Các 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ợ. Hiện tại, bạn chỉ nên sử dụng thư viện này khi kết nối với Google Cast.
Thư viện bảng màu v7
Thư viện hỗ trợ bảng màu v7 bao gồm lớp Palette, cho phép bạn trích xuất các màu sắc nổi bật từ một hình ảnh. Ví dụ: một ứng dụng âm nhạc có thể dùng đối tượng Palette để trích xuất các màu chính từ một ảnh bìa album và dùng những màu đó để tạo một thẻ tiêu đề bài hát có màu sắc phối hợp.
Giá trị nhận dạng phần phụ thuộc 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 phiên bản 7
Thư viện recyclerview sẽ thêm lớp RecyclerView. Lớp này hỗ trợ tiện ích RecyclerView, một khung hiển thị để 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 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ợ v7 cho các lựa chọn ưu tiên
Gói preference cung cấp các API để hỗ trợ việc thêm các đối tượng lựa chọn ưu tiên, chẳng hạn như CheckBoxPreference và ListPreference, để người dùng sửa đổi chế độ cài đặt giao diện người dùng.
Thư viện v7 Preference bổ sung hỗ trợ cho 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 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ợ v8
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 khung tính toán RenderScript. Các API này có trong gói android.support.v8.renderscript. Bạn cần 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 so 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 bạn, hãy xem hướng dẫn dành cho nhà phát triển về RenderScript.
Lưu ý: Android Studio và các bản dựng dựa trên Gradle có hỗ trợ việc sử dụng RenderScript với thư viện hỗ trợ. 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ợ v13
Thư viện này bổ sung tính năng hỗ trợ cho mẫu giao diện người dùng Mảnh bằng lớp (FragmentCompat) và các lớp hỗ trợ mảnh bổ sung. Để biết thêm thông tin về mảnh, hãy xem hướng dẫn dành cho nhà phát triển về Mảnh. Để biết thông tin chi tiết về 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 v4 cung cấp một lớp Fragment. Lớp Fragment v4 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 các lớp tương thích cho việc triển khai khung của lớp Fragment.
Giá trị nhận dạng phần phụ thuộc 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 v14
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 lựa chọn ưu tiên, chẳng hạn như PreferenceFragment.OnPreferenceStartFragmentCallback và PreferenceFragment.OnPreferenceStartScreenCallback, cùng với các lớp, chẳng hạn như MultiSelectListPreference và PreferenceFragment. Để biết thông tin chi tiết về các API Thư viện hỗ trợ lựa chọn ưu tiên phiên bản 14, hãy xem gói 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 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 v17 cho TV
Gói android.support.v17.preference cung cấp các API để cung cấp giao diện lựa chọn ưu tiên trên các thiết bị TV, bao gồm cả khả năng hỗ trợ giao diện và các lớp LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener, chẳng hạn như BaseLeanbackPreferenceFragment và LeanbackPreferenceFragment. Để biết thông tin chi tiết về các API Thư viện hỗ trợ lựa chọn ưu tiên phiên bản 17, hãy xem gói 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. 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-leanback-v17:28.0.0
Thư viện Leanback v17
Gói android.support.v17.leanback cung cấp các API để hỗ trợ việc xây dựng giao diện người dùng trên các thiết bị TV. Thư viện này cung cấp một số tiện ích quan trọng cho các ứng dụng truyền hình. Một số lớp học đáng chú ý bao gồm:
BrowseFragment– Một mảnh để tạo bố cục chính cho việc duyệt xem các danh mục và hàng của các mục nội dung nghe nhìn.DetailsFragment– Một mảnh (fragment) trình bao bọc cho màn hình chi tiết Leanback.PlaybackOverlayFragment– Một lớp con củaDetailsFragmentđể hiển thị các chế độ phát và nội dung liên quan.SearchFragment– Một mảnh để xử lý các lượt tìm kiếm. Mảnh này nhận yêu cầu tìm kiếm của người dùng và truyền yêu cầu đó đếnSearchResultProviderdo ứng dụng cung cấp.SearchResultProvidersẽ trả về kết quả tìm kiếm choSearchFragment, kết quả này sẽ hiển thị các kết quả đó thànhRowsFragment.
Gói này yêu cầu API cấp 17 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: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 tập lệnh bản dựng Gradle cho thư viện này như 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 tập lệnh bản dựng Gradle cho thư viện này như sau:
com.android.support:animated-vector-drawable:28.0.0
Thư viện hỗ trợ chú giải
Gói Chú giải cung cấp các API để hỗ trợ việc thêm siêu dữ liệu chú giải vào các ứng dụng của bạn.
Giá trị nhận dạng phần phụ thuộc 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ế
Gói Design cung cấp các 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 Hỗ trợ thiết kế bổ sung chế độ hỗ trợ cho nhiều thành phần và mẫu thiết kế theo phong cách Material Design để các nhà phát triển ứng dụng có thể xây dựng, chẳng hạn như ngăn điều hướng, nút hành động nổi (FAB), thanh thông báo và thẻ.
Giá trị nhận dạng phần phụ thuộc 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
Gói Thẻ tuỳ chỉnh cung cấp các API để hỗ trợ việc thêm và quản lý thẻ tuỳ chỉnh trong ứng dụng của bạn.
Thư viện Hỗ trợ thẻ tuỳ chỉnh bổ sung tính năng hỗ trợ cho nhiều lớp, chẳng hạn như Dịch vụ Thẻ tuỳ chỉnh và Lệnh gọi lại Thẻ tuỳ chỉnh.
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 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ợ phần trăm
Gói Percent cung cấp các API để hỗ trợ việc thêm và quản lý các phương diện 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 hỗ trợ tỷ lệ phần trăm không được dùng nữa.
Các ứng dụng của mô-đun này nên di chuyển sang tiện ích ConstraintLayout mới. Tiện ích này được cung cấp dưới dạng một cấu phần phần mềm riêng biệt trong Trình quản lý SDK.
Thư viện Hỗ trợ theo tỷ lệ phần trăm bổ sung khả năng hỗ trợ cho giao diện PercentLayoutHelper.PercentLayoutParams và nhiều lớp, chẳng hạn như PercentFrameLayout và PercentRelativeLayout.
Giá trị nhận dạng phần phụ thuộc 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ờ, thông tin về camera và vị trí ngay trong tệp JPEG hoặc RAW. Lớp ExifInterface tách riêng hoạt động hỗ trợ đọc thông tin Exif từ các tệp có định dạng JPEG và thô (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW và RAF), đồng thời thiết lập thông tin Exif trên các tệp hình ảnh JPEG.
Giá trị nhận dạng phần phụ thuộc 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
Gói Đề xuất ứng dụng cung cấp các API để hỗ trợ việc thêm đề xuất nội dung vào ứng dụng đang chạy trên thiết bị TV.
Thư viện Ứng dụng bổ sung tính năng hỗ trợ cho các chú thích, chẳng hạn như ContentRecommendation.ContentMaturity và nhiều lớp, chẳng hạn như ContentRecommendation và RecommendationExtender.
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 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 cho thiết bị đeo
Thư viện này có các API để xây dựng giao diện người dùng cho các ứng dụng Wear. Các API có trong gói android.support.wear.widget sẽ 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 bài viết 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 tập lệnh bản dựng Gradle cho thư viện này như sau:
com.android.support:wear:28.0.0