Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

Kiến trúc thông tin
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Android 8.0 giới thiệu một cấu trúc thông tin mới cho ứng dụng Cài đặt để đơn giản hoá cách sắp xếp các chế độ cài đặt và giúp người dùng dễ dàng nhanh chóng tìm các chế độ cài đặt để tuỳ chỉnh thiết bị Android của mình. Android 9 có một số cải tiến để cung cấp thêm Chức năng cài đặt và cách triển khai dễ dàng hơn.

Ví dụ và nguồn

Hầu hết các trang trong phần Cài đặt hiện được triển khai bằng khung mới. Một ví dụ điển hình là DisplaySettings:packages/apps/Settings/src/com/android/settings/DisplaySettings.java

Dưới đây là danh sách đường dẫn tệp cho các thành phần quan trọng:

CategoryKey: packages/SettingsLib/src/com/android/settingslib/drawer/CategoryKey.java
DashboardFragmentRegistry: packages/apps/Settings/src/com/android/settings/dashboard/DashboardFragmentRegistry.java
DashboardFragment: packages/apps/Settings/src/com/android/settings/dashboard/DashboardFragment.java
AbstractPreferenceController: frameworks/base/packages/SettingsLib/src/com/android/settingslib/core/AbstractPreferenceController.java
BasePreferenceController (được giới thiệu trong Android 9): packages/apps/Settings/src/com/android/settings/core/BasePreferenceController.java

Triển khai

Nhà sản xuất thiết bị nên điều chỉnh cấu trúc thông tin cài đặt hiện có và chèn các trang cài đặt bổ sung nếu cần để phù hợp với các tính năng dành riêng cho đối tác. Việc di chuyển các tuỳ chọn ưu tiên từ trang cũ (được triển khai dưới dạng SettingsPreferencePage) sang trang mới (được triển khai bằng DashboardFragment) có thể phức tạp. Lựa chọn ưu tiên từ trang cũ có thể không được triển khai bằng PreferenceController.

Vì vậy, khi di chuyển tuỳ chọn từ một trang cũ sang một trang mới, bạn cần tạo PreferenceController rồi di chuyển mã vào bộ điều khiển trước tạo thực thể cho công cụ này trong DashboardFragment mới. Các API mà PreferenceController yêu cầu được mô tả trong tên và được ghi lại trong Javadoc.

Bạn nên thêm một bài kiểm thử đơn vị cho mỗi PreferenceController. Nếu thay đổi được gửi đến AOSP, thì bạn phải kiểm thử đơn vị. Để biết thêm thông tin về cách viết chương trình kiểm thử dựa trên Robolectric, hãy xem tệp readme packages/apps/Settings/tests/robotests/README.md.

Kiến trúc thông tin kiểu trình bổ trợ

Mỗi mục cài đặt được triển khai dưới dạng Lựa chọn ưu tiên. Bạn có thể dễ dàng di chuyển một Lựa chọn ưu tiên từ trang này sang trang khác.

Để dễ dàng di chuyển nhiều chế độ cài đặt, Android 8.0 đã giới thiệu một mảnh máy chủ kiểu trình bổ trợ chứa các mục cài đặt. Các mục Cài đặt là được mô hình hoá dưới dạng bộ điều khiển kiểu trình bổ trợ. Do đó, trang cài đặt được tạo bởi một mảnh máy chủ lưu trữ và nhiều bộ điều khiển cài đặt.

DashboardFragment

DashboardFragment là máy chủ lưu trữ của các bộ điều khiển tuỳ chọn kiểu trình bổ trợ. Mảnh kế thừa từ PreferenceFragment và có các mối liên kết với mở rộng và cập nhật cả danh sách lựa chọn ưu tiên tĩnh và danh sách lựa chọn ưu tiên động.

Lựa chọn ưu tiên tĩnh

Danh sách lựa chọn ưu tiên tĩnh được xác định trong XML bằng thẻ <Preference>. Đáp Quá trình triển khai DashboardFragment sử dụng phương thức Phương thức getPreferenceScreenResId() để xác định tệp XML nào chứa danh sách lựa chọn ưu tiên tĩnh để hiển thị.

Lựa chọn ưu tiên linh động

Một mục động biểu thị một thẻ thông tin có ý định, dẫn đến một mục bên ngoài hoặc nội bộ Hoạt động. Thông thường, ý định này sẽ dẫn đến một trang cài đặt khác. Ví dụ: "Google" mục cài đặt trong trang chủ Cài đặt là một mục động. Động các mục được xác định trong AndroidManifest (thảo luận bên dưới) và được tải thông qua FeatureProvider (được xác định là DashboardFeatureProvider).

Chế độ cài đặt động nặng hơn chế độ cài đặt được định cấu hình tĩnh, vì vậy, thông thường, nhà phát triển nên triển khai chế độ cài đặt dưới dạng chế độ cài đặt tĩnh. Tuy nhiên, chế độ cài đặt động có thể hữu ích khi bất kỳ trường hợp nào sau đây xảy ra:

Chế độ cài đặt này không được triển khai trực tiếp trong ứng dụng Cài đặt (chẳng hạn như chèn một chế độ cài đặt do ứng dụng OEM/Nhà mạng triển khai).
Cài đặt này sẽ xuất hiện trên trang chủ Cài đặt.
Bạn đã có một Hoạt động cho chế độ cài đặt và không muốn triển khai thêm cấu hình tĩnh.

Để định cấu hình một Hoạt động dưới dạng chế độ cài đặt động, hãy làm như sau:

Đánh dấu hoạt động là chế độ cài đặt động bằng cách thêm bộ lọc ý định vào của bạn.
Cho ứng dụng Cài đặt biết ứng dụng thuộc danh mục nào. Danh mục là một hằng số được xác định trong CategoryKey.
Không bắt buộc: Thêm văn bản tóm tắt khi chế độ cài đặt hiển thị.

Dưới đây là ví dụ lấy từ ứng dụng Cài đặt cho DisplaySettings.

<activity android:name="Settings$DisplaySettingsActivity"
                   android:label="@string/display_settings"
                   android:icon="@drawable/ic_settings_display">
             <!-- Mark the activity as a dynamic setting -->
              <intent-filter>
                     <action android:name="com.android.settings.action.IA_SETTINGS" />
              </intent-filter>
             <!-- Tell Settings app which category it belongs to -->
              <meta-data android:name="com.android.settings.category"
                     android:value="com.android.settings.category.ia.homepage" />
             <!-- Add a summary text when the setting is displayed -->
              <meta-data android:name="com.android.settings.summary"
                     android:resource="@string/display_dashboard_summary"/>
             </activity>

Tại thời điểm kết xuất, mảnh sẽ yêu cầu danh sách Lựa chọn ưu tiên từ cả XML tĩnh và chế độ cài đặt động được xác định trong AndroidManifest. Cho dù PreferenceController được xác định trong mã Java hay trong XML, DashboardFragment đều quản lý logic xử lý của từng chế độ cài đặt thông qua PreferenceController (xem phần thảo luận bên dưới). Sau đó được hiển thị trong giao diện người dùng dưới dạng danh sách kết hợp.

PreferenceController

Có sự khác biệt giữa việc triển khai PreferenceController trong Android 9 và Android 8.x, như mô tả trong phần này.

Bản phát hành PreferenceController trong Android 9

PreferenceController chứa tất cả logic để tương tác với tuỳ chọn, bao gồm cả việc hiển thị, cập nhật, lập chỉ mục tìm kiếm, v.v.

Giao diện của PreferenceController được xác định là BasePreferenceController. Ví dụ: xem mã trong packages/apps/Settings/src/com/android/settings/core/ BasePreferenceController.java

BasePreferenceController có một số lớp con, mỗi lớp liên kết đến một kiểu giao diện người dùng cụ thể mà ứng dụng Cài đặt hỗ trợ theo mặc định. Để ví dụ: TogglePreferenceController có một API liên kết trực tiếp về cách người dùng sẽ tương tác với giao diện người dùng lựa chọn ưu tiên dựa trên nút bật/tắt.

BasePreferenceController có các API như getAvailabilityStatus(), displayPreference(), handlePreferenceTreeClicked(),, v.v. Tài liệu chi tiết về từng API nằm trong lớp giao diện.

Một hạn chế khi triển khai BasePreferenceController (và các lớp con của lớp này như TogglePreferenceController) là chữ ký hàm khởi tạo phải khớp với một trong những nội dung sau:

public MyController(Context context, String key) {}
public MyController(Context context) {}

Trong khi cài đặt một tuỳ chọn ưu tiên cho mảnh, trang tổng quan cung cấp một phương thức để đính kèm PreferenceController trước thời gian hiển thị. Tại thời điểm cài đặt, trình điều khiển được kết nối với mảnh để tất cả các sự kiện liên quan trong tương lai đều được gửi đến trình điều khiển.

DashboardFragment lưu giữ danh sách PreferenceController trên màn hình. Tại phần onCreate(), tất cả bộ điều khiển sẽ được gọi cho getAvailabilityStatus() và nếu phương thức này trả về giá trị true, displayPreference() được gọi để xử lý logic hiển thị. getAvailabilityStatus() cũng quan trọng để cho khung Cài đặt biết những mục nào có sẵn trong quá trình tìm kiếm.

PreferenceController trong các bản phát hành Android 8.x

PreferenceController chứa tất cả logic để tương tác với tuỳ chọn, bao gồm cả việc hiển thị, cập nhật, lập chỉ mục tìm kiếm, v.v.

Tương ứng với các lượt tương tác ưu tiên, giao diện của PreferenceController có các API isAvailable(), displayPreference(), handlePreferenceTreeClicked(), v.v. Bạn có thể tìm thấy tài liệu chi tiết về từng API trong lớp giao diện.

Trong khi cài đặt một lựa chọn ưu tiên cho mảnh, trang tổng quan sẽ cung cấp một phương thức để đính kèm một PreferenceController trước thời gian hiển thị. Tại thời điểm cài đặt, trình điều khiển được kết nối với mảnh để tất cả các sự kiện liên quan trong tương lai đều được gửi đến trình điều khiển.

DashboardFragment lưu giữ danh sách PreferenceControllers trên màn hình. Tại onCreate() của mảnh, tất cả trình điều khiển sẽ được gọi cho phương thức isAvailable() và nếu phương thức này trả về true, displayPreference() sẽ được gọi để xử lý logic hiển thị.

Sử dụng DashboardFragment

Di chuyển một tuỳ chọn ưu tiên từ trang A sang trang B

Nếu lựa chọn ưu tiên được liệt kê tĩnh trong XML lựa chọn ưu tiên của trang gốc hãy làm theo quy trình di chuyển Tĩnh dành cho thiết bị Android bản phát hành bên dưới. Nếu không, hãy làm theo quy trình di chuyển Linh động cho bản phát hành Android của bạn.

Di chuyển tĩnh trong Android 9

Tìm tệp XML ưu tiên cho trang gốc và trang đích. Bạn có thể tìm thấy thông tin này trong phương thức getPreferenceScreenResId() của trang.
Xoá tuỳ chọn này khỏi tệp XML của trang gốc.
Thêm lựa chọn ưu tiên vào XML của trang đích.
Xoá PreferenceController cho tuỳ chọn này khỏi quá trình triển khai Java của trang ban đầu. Thường nằm trong createPreferenceControllers(). Bạn có thể khai báo bộ điều khiển trong XML trực tiếp.
Lưu ý: Lựa chọn ưu tiên có thể không có PreferenceController.
Tạo bản sao PreferenceController trong createPreferenceControllers() của trang đích. Nếu PreferenceController được xác định trong XML trong trang cũ, hãy xác định PreferenceController trong XML cho trang mới.

Di chuyển động trong Android 9

Tìm danh mục lưu trữ trang gốc và trang đích. Bạn có thể tìm thông tin này trong DashboardFragmentRegistry.
Mở tệp AndroidManifest.xml chứa chế độ cài đặt mà bạn cần di chuyển và tìm mục Hoạt động đại diện cho chế độ cài đặt này.
Đặt giá trị siêu dữ liệu của hoạt động cho com.android.settings.category vào khoá danh mục của trang mới.

Di chuyển tĩnh trong các bản phát hành Android 8.x

Tìm tệp XML ưu tiên cho trang gốc và trang đích.

getPreferenceScreenResId()

Xoá lựa chọn ưu tiên trong tệp XML của trang gốc.
Thêm tuỳ chọn vào XML của trang đích.
Xoá PreferenceController cho tuỳ chọn này trong triển khai Java của trang gốc. Thường thì thư mục này nằm trong getPreferenceControllers().

Lưu ý: Có thể lựa chọn ưu tiên không có PreferenceController.

Tạo thực thể cho PreferenceController trong thẻ của trang đích getPreferenceControllers().

Di chuyển động trong các bản phát hành Android 8.x

Tìm danh mục mà trang đích và trang gốc lưu trữ. Bạn có thể tìm thấy thông tin này trong DashboardFragmentRegistry.
Mở tệp AndroidManifest.xml chứa chế độ cài đặt bạn cần di chuyển và tìm mục Activity (Hoạt động) đại diện cho chế độ cài đặt này.
Thay đổi giá trị siêu dữ liệu của hoạt động cho com.android.settings.category, đặt điểm giá trị thành khoá danh mục của trang mới.

Tạo một tuỳ chọn ưu tiên mới trong một trang

Nếu lựa chọn ưu tiên được liệt kê tĩnh trong XML lựa chọn ưu tiên của trang gốc hãy làm theo quy trình tĩnh bên dưới. Nếu không, hãy làm theo động.

Tạo lựa chọn ưu tiên tĩnh

Tìm các tệp XML ưu tiên cho trang. Bạn có thể tìm thấy thông tin này trong phương thức getPreferenceScreenResId() của trang.
Thêm một mục Lựa chọn ưu tiên mới trong tệp XML. Hãy đảm bảo tệp này có một android:key duy nhất.
Xác định PreferenceController cho tuỳ chọn ưu tiên này trong phương thức getPreferenceControllers() của trang.
- Trong Android 8.x và trong Android 9, tạo thực thể PreferenceController cho tuỳ chọn này trong phương thức createPreferenceControllers() của trang.
  Nếu lựa chọn ưu tiên này đã tồn tại ở những nơi khác, thì có thể đã có PreferenceController cho lựa chọn đó. Bạn có thể sử dụng lại PreferenceController mà không cần tạo một PreferenceController mới.
- Kể từ Android 9, bạn có thể chọn khai báo PreferenceController trong XML bên cạnh lựa chọn ưu tiên. Ví dụ:
```
<Preference
        android:key="reset_dashboard"
        android:title="@string/reset_dashboard_title"
        settings:controller="com.android.settings.system.ResetPreferenceController"/>
```

Tạo lựa chọn ưu tiên linh động

Tìm danh mục lưu trữ trang gốc và trang đích. Bạn có thể tìm thấy thông tin này trong DashboardFragmentRegistry.
Tạo một Hoạt động mới trong AndroidManifest
Thêm siêu dữ liệu cần thiết vào Activity (Hoạt động) mới để xác định chế độ cài đặt. Thiết lập giá trị siêu dữ liệu cho com.android.settings.category với cùng một giá trị xác định ở bước 1.

Tạo một trang mới

Tạo một mảnh mới kế thừa từ DashboardFragment.
Xác định danh mục của nó trong DashboardFragmentRegistry.
Lưu ý: Bước này là không bắt buộc. Nếu bạn không cần bất kỳ tuỳ chọn động nào trong trang này, bạn không cần phải cung cấp khoá danh mục.
Làm theo các bước để thêm các chế độ cài đặt cần thiết cho trang này. Để biết thêm thông tin, hãy xem phần Triển khai.

Xác nhận kết quả

Chạy các kiểm thử robolectric trong phần Cài đặt. Tất cả các chương trình kiểm thử hiện có và mới .
Tạo và cài đặt phần Cài đặt, sau đó mở trang đang được sửa đổi theo cách thủ công. Trang sẽ cập nhật ngay lập tức.

Kiến trúc thông tin Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.