Cho phép người dùng định cấu hình tiện ích ứng dụng

Bạn có thể định cấu hình tiện ích ứng dụng. Ví dụ: tiện ích đồng hồ có thể cho phép người dùng định cấu hình múi giờ để hiển thị.

Nếu bạn muốn cho phép người dùng định cấu hình chế độ cài đặt của tiện ích, hãy tạo một cấu hình tiện ích Activity.

Khai báo hoạt động cấu hình

Việc khai báo hoạt động cấu hình trong tệp kê khai và liên kết hoạt động đó bên trong siêu dữ liệu XML của nhà cung cấp là giống nhau trên cả tiện ích ứng dụng dựa trên Khung hiển thị và tiện ích ứng dụng dựa trên Glance.

Để tìm hiểu cách khai báo hoạt động cấu hình, hãy xem phần Khai báo hoạt động cấu hình trong tài liệu về cấu hình Glance.

Triển khai hoạt động cấu hình

Vì hoạt động cấu hình là các thành phần tiêu chuẩn được trình chạy nền tảng gọi, nên các phương thức gọi lại trong vòng đời cơ bản của chúng phải tuân theo quy tắc giá trị trả về của hệ thống.

Để tìm hiểu cách triển khai hoạt động cấu hình, hãy xem phần Triển khai hoạt động cấu hình ưu tiên Compose trong tài liệu về Glance.

Cập nhật tiện ích từ hoạt động cấu hình

Trong các tiện ích dựa trên Khung hiển thị truyền thống, bạn cập nhật tiện ích sau khi hoàn tất cấu hình bằng cách sử dụng AppWidgetManager và một thực thể bố cục RemoteViews.

Nếu bạn đang xây dựng một tiện ích dựa trên Khung hiển thị cũ và cần cập nhật bố cục RemoteViews, hãy tham khảo mã mẫu Cập nhật khung hiển thị truyền thống trên GitHub. Đối với các tiện ích hiện đại ưu tiên Compose, hãy xem phần Cập nhật từ hoạt động cấu hình trong tài liệu về Glance.

Các lựa chọn cấu hình tiện ích

Hành vi của tiện ích (chẳng hạn như cho phép định cấu hình lại sau hoặc bỏ qua hoàn toàn các bước thiết lập cấu hình ban đầu) được đăng ký bên trong các thuộc tính siêu dữ liệu bằng cách sử dụng cờ Android 12 tiêu chuẩn.

Để tìm hiểu cách tận dụng các tuỳ chọn tiện ích động, hãy xem phần Tuỳ chọn cấu hình tiện ích ưu tiên Compose trong tài liệu về cấu hình Glance.

Cho phép người dùng định cấu hình lại các tiện ích đã đặt

Để hiểu cách thêm trình kích hoạt thiết lập có thể định cấu hình lại tuỳ chỉnh, hãy xem phần Cho phép người dùng định cấu hình lại Place Widgets trong tài liệu về Glance.

Sử dụng cấu hình mặc định của tiện ích

Để tìm hiểu cách bỏ qua các bước thiết lập cấu hình theo mặc định, hãy xem phần Sử dụng cấu hình mặc định của tiện ích trong tài liệu về Glance.