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 trongcreatePreferenceControllers()
. 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
trongcreatePreferenceControllers()
của trang đích. NếuPreferenceController
được xác định trong XML trong trang cũ, hãy xác địnhPreferenceController
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. Bạn có thể tìm thấy thông tin này qua phương thức
- 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 tronggetPreferenceControllers()
. - Tạo thực thể cho
PreferenceController
trong thẻ của trang đíchgetPreferenceControllers()
.
getPreferenceScreenResId()
của trang.
Lưu ý: Có thể lựa chọn ưu tiên không có
PreferenceController
.
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ứcgetPreferenceControllers()
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ứccreatePreferenceControllers()
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ạiPreferenceController
mà không cần tạo mộtPreferenceController
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"/>
- Trong Android 8.x và trong Android 9,
tạo thực thể
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.