Thiết lập thư viện hỗ trợ

Lưu ý: Với bản phát hành Android 9.0 (API cấp 28), có một phiên bản mới của thư viện hỗ trợ có tên là AndroidX là một phần của Jetpack. Thư viện AndroidX chứa thư viện hỗ trợ hiện có và cũng bao gồm các thành phần Jetpack mới nhất.

Bạn có thể tiếp tục sử dụng thư viện hỗ trợ. Các cấu phần phần mềm 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.*) sẽ vẫn có mặt trên Google Maven. Tuy nhiên, tất cả hoạt động phát triển thư viện mới sẽ xảy ra trong thư viện AndroidX.

Bạn nên sử dụng thư viện AndroidX trong tất cả các dự án mới. Bạn cũng nên cân nhắc di chuyển các dự án hiện có sang AndroidX.

Cách thiết lập Thư viện hỗ trợ Android trong dự án phát triển phụ thuộc vào những tính năng bạn muốn sử dụng, cũng như loại phiên bản nền tảng Android mà bạn muốn hỗ trợ bằng .

Tài liệu này hướng dẫn bạn tải gói Thư viện hỗ trợ xuống và thêm thư viện vào môi trường phát triển.

Các thư viện hỗ trợ hiện đã có sẵn thông qua Maven của Google kho lưu trữ. Chúng tôi không còn hỗ trợ việc tải thư viện xuống thông qua SDK nữa Người quản lý của Google và chức năng đó sẽ sớm bị xóa.

Chọn thư viện hỗ trợ

Trước khi thêm Thư viện hỗ trợ vào ứng dụng, hãy quyết định xem bạn muốn đưa tính năng nào vào và phiên bản Android thấp nhất mà bạn muốn hỗ trợ. Để biết thêm thông tin về các tính năng do các thư viện khác nhau cung cấp, hãy xem Tính năng của Thư viện hỗ trợ.

Thêm thư viện hỗ trợ

Để sử dụng Thư viện hỗ trợ, bạn phải sửa đổi Các phần phụ thuộc classpath trong môi trường phát triển. Bạn phải thực hiện quy trình này để từng Thư viện hỗ trợ mà bạn muốn sử dụng.

Cách thêm Thư viện hỗ trợ vào dự án ứng dụng:

1. Đưa kho lưu trữ Maven của Google vào trong tệp lưu trữ của dự án Tệp settings.gradle.

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
   
           // If you're using a version of Gradle lower than 4.1, you must
           // instead use:
           //
           // maven {
           //     url 'https://maven.google.com'
           // }
       }
   }
   

2. Đối với mỗi mô-đun mà bạn muốn sử dụng Thư viện hỗ trợ, hãy thêm thư viện vào Khối dependencies trong tệp build.gradle của mô-đun. Cho ví dụ: để thêm thư viện Core-utils v4, hãy thêm đoạn mã sau:

   dependencies {
       ...
       implementation "com.android.support:support-core-utils:28.0.0"
   }
   

Thận trọng: Sử dụng phần phụ thuộc động (ví dụ: palette-v7:23.0.+) có thể khiến phiên bản cập nhật không mong muốn và sự không tương thích hồi quy. Chúng tôi khuyên bạn nên chỉ định rõ ràng phiên bản thư viện (ví dụ: palette-v7:28.0.0).

Sử dụng API Thư viện hỗ trợ

Các lớp của Thư viện hỗ trợ cung cấp hỗ trợ cho các API khung hiện có thường có cùng tên với lớp khung nhưng nằm trong các gói lớp android.support, hoặc có hậu tố *Compat.

Lưu ý: Sau khi đưa Thư viện hỗ trợ vào dự án ứng dụng của bạn, chúng tôi bạn nên rút gọn, làm rối mã nguồn và tối ưu hoá ứng dụng của bạn để phát hành. Ngoài việc bảo vệ mã nguồn bằng tính năng làm rối mã nguồn, rút gọn sẽ xoá các lớp không dùng đến khỏi mọi thư viện mà bạn đưa vào ứng dụng, giúp giữ cho càng nhỏ càng tốt.

Hướng dẫn thêm về cách sử dụng một số tính năng của Thư viện hỗ trợ được cung cấp trong nhà phát triển Android lớp đào tạo, hướng dẫn và mẫu. Để biết thêm thông tin về các lớp và phương thức riêng lẻ của Thư viện hỗ trợ, hãy xem các gói android.support trong tài liệu tham khảo API.

Các thay đổi trong nội dung khai báo trong tệp kê khai

Nếu bạn tăng khả năng tương thích ngược của ứng dụng hiện có lên một phiên bản phiên bản API Android có Thư viện hỗ trợ, hãy nhớ cập nhật phiên bản tệp kê khai. Cụ thể, bạn nên cập nhật android:minSdkVersion phần tử của <uses-sdk> trong tệp kê khai sang số phiên bản mới thấp hơn, dưới dạng được hiển thị bên dưới:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

Cài đặt tệp kê khai cho Google Play biết rằng ứng dụng của bạn có thể được cài đặt trên các thiết bị chạy Android 4.0 (API cấp 14) trở lên.

Nếu bạn đang sử dụng tệp bản dựng Gradle, chế độ cài đặt minSdkVersion trong tệp bản dựng ghi đè chế độ cài đặt tệp kê khai.

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

Trong trường hợp này, chế độ cài đặt tệp bản dựng cho Google Play biết rằng biến thể bản dựng mặc định của có thể được cài đặt trên thiết bị Android 4.1 (API cấp 16) trở lên. Để biết thêm thông tin về biến thể bản dựng, hãy xem Tổng quan về hệ thống xây dựng.

Lưu ý: Nếu bạn bao gồm một số thư viện hỗ trợ, thì thuộc tính phiên bản SDK tối thiểu phải là phiên bản cao nhất mà bất kỳ các thư viện được chỉ định. Ví dụ: nếu ứng dụng của bạn có cả thư viện Hỗ trợ lựa chọn ưu tiên phiên bản 14 và Thư viện Leanback phiên bản 17, mức tối thiểu Phiên bản SDK phải từ 17 trở lên.