Trang này giải thích các phương pháp được đề xuất để tạo tiện ích nâng cao hơn nhằm mang lại trải nghiệm người dùng tốt hơn.
Tối ưu hoá để cập nhật nội dung tiện ích
Việc cập nhật nội dung tiện ích có thể tiêu tốn tài nguyên tính toán. Để tiết kiệm mức tiêu thụ pin, hãy tối ưu hoá loại, tần suất và thời gian cập nhật.
Các loại bản cập nhật tiện ích
Có 3 cách để cập nhật một tiện ích: cập nhật toàn bộ, cập nhật một phần và trong trường hợp tiện ích bộ sưu tập, làm mới dữ liệu. Mỗi cấp độ có chi phí tính toán và hệ quả phân chia khác nhau.
Phần sau đây mô tả từng loại cập nhật và cung cấp đoạn mã cho từng loại.
Cập nhật đầy đủ: gọi
AppWidgetManager.updateAppWidget(int, android.widget.RemoteViews)
để cập nhật đầy đủ tiện ích. Thao tác này sẽ thay thếRemoteViews
đã cung cấp trước đó bằng mộtRemoteViews
mới. Đây là lần cập nhật tiêu tốn tài nguyên tính toán nhất.Kotlin
val appWidgetManager = AppWidgetManager.getInstance(context) val remoteViews = RemoteViews(context.getPackageName(), R.layout.widgetlayout).also { setTextViewText(R.id.textview_widget_layout1, "Updated text1") setTextViewText(R.id.textview_widget_layout2, "Updated text2") } appWidgetManager.updateAppWidget(appWidgetId, remoteViews)
Java
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context); RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widgetlayout); remoteViews.setTextViewText(R.id.textview_widget_layout1, "Updated text1"); remoteViews.setTextViewText(R.id.textview_widget_layout2, "Updated text2"); appWidgetManager.updateAppWidget(appWidgetId, remoteViews);
Cập nhật một phần: gọi
AppWidgetManager.partiallyUpdateAppWidget
để cập nhật các phần của tiện ích. Thao tác này sẽ hợp nhấtRemoteViews
mới vớiRemoteViews
đã cung cấp trước đó. Phương thức này sẽ bị bỏ qua nếu tiện ích không nhận được ít nhất một bản cập nhật đầy đủ thông quaupdateAppWidget(int[], RemoteViews)
.Kotlin
val appWidgetManager = AppWidgetManager.getInstance(context) val remoteViews = RemoteViews(context.getPackageName(), R.layout.widgetlayout).also { setTextViewText(R.id.textview_widget_layout, "Updated text") } appWidgetManager.partiallyUpdateAppWidget(appWidgetId, remoteViews)
Java
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context); RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widgetlayout); remoteViews.setTextViewText(R.id.textview_widget_layout, "Updated text"); appWidgetManager.partiallyUpdateAppWidget(appWidgetId, remoteViews);
Làm mới dữ liệu bộ sưu tập: gọi
AppWidgetManager.notifyAppWidgetViewDataChanged
để vô hiệu hoá dữ liệu của khung hiển thị bộ sưu tập trong tiện ích của bạn. Thao tác này sẽ kích hoạtRemoteViewsFactory.onDataSetChanged
. Tạm thời, dữ liệu cũ sẽ hiển thị trong tiện ích này. Bạn có thể thực hiện đồng bộ các thao tác tốn kém một cách an toàn bằng phương thức này.Kotlin
val appWidgetManager = AppWidgetManager.getInstance(context) appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetId, R.id.widget_listview)
Java
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context); appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetId, R.id.widget_listview);
Bạn có thể gọi các phương thức này từ bất cứ đâu trong ứng dụng, miễn là ứng dụng đó có cùng UID với lớp AppWidgetProvider
tương ứng.
Xác định tần suất cập nhật tiện ích
Các tiện ích được cập nhật định kỳ tuỳ thuộc vào giá trị được cung cấp cho thuộc tính updatePeriodMillis
. Tiện ích có thể cập nhật theo tương tác của người dùng, nội dung cập nhật truyền tin hoặc cả hai.
Cập nhật định kỳ
Bạn có thể kiểm soát tần suất cập nhật định kỳ bằng cách chỉ định một giá trị cho AppWidgetProviderInfo.updatePeriodMillis
trong XML appwidget-provider
. Mỗi lần cập nhật sẽ kích hoạt phương thức AppWidgetProvider.onUpdate()
. Đây là nơi bạn có thể đặt mã để cập nhật tiện ích. Tuy nhiên, hãy cân nhắc các lựa chọn thay thế cho bản cập nhật broadcast receiver được mô tả trong phần sau đây nếu tiện ích của bạn cần tải dữ liệu không đồng bộ hoặc mất hơn 10 giây để cập nhật, vì sau 10 giây, hệ thống sẽ coi một BroadcastReceiver
là không phản hồi.
updatePeriodMillis
không hỗ trợ các giá trị dưới 30 phút. Tuy nhiên, nếu muốn tắt tính năng cập nhật định kỳ, bạn có thể chỉ định 0.
Bạn có thể cho phép người dùng điều chỉnh tần suất cập nhật trong cấu hình. Ví dụ: họ có thể muốn một mã cổ phiếu cập nhật 15 phút một lần hoặc chỉ 4 lần trong một ngày. Trong trường hợp này, hãy đặt updatePeriodMillis
thành 0 và sử dụng WorkManager
.
Cập nhật để phản hồi tương tác của người dùng
Sau đây là một số cách được đề xuất để cập nhật tiện ích dựa trên hoạt động tương tác của người dùng:
Từ một hoạt động của ứng dụng: gọi trực tiếp
AppWidgetManager.updateAppWidget
để phản hồi hoạt động tương tác của người dùng, chẳng hạn như thao tác nhấn của người dùng.Qua các hoạt động tương tác từ xa, chẳng hạn như thông báo hoặc tiện ích ứng dụng: tạo
PendingIntent
, sau đó cập nhật tiện ích từActivity
,Broadcast
hoặcService
đã gọi. Bạn có thể chọn mức độ ưu tiên của riêng mình. Ví dụ: nếu chọnBroadcast
choPendingIntent
, bạn có thể chọn thông báo trên nền trước để ưu tiênBroadcastReceiver
.
Cập nhật để phản hồi sự kiện phát sóng
Ví dụ về một sự kiện truyền tin yêu cầu tiện ích cập nhật là khi người dùng chụp ảnh. Trong trường hợp này, bạn muốn cập nhật tiện ích khi phát hiện thấy ảnh mới.
Bạn có thể lên lịch công việc với JobScheduler
và chỉ định một thông báo truyền tin làm điều kiện kích hoạt bằng phương thức JobInfo.Builder.addTriggerContentUri
.
Bạn cũng có thể đăng ký BroadcastReceiver
cho thông báo truyền tin, ví dụ: nghe ACTION_LOCALE_CHANGED
.
Tuy nhiên, vì phương thức này tốn tài nguyên thiết bị, nên hãy cẩn thận khi sử dụng phương thức này và chỉ nghe nội dung truyền tin cụ thể. Với sự ra mắt của giới hạn truyền tin trong Android 7.0 (API cấp 24) và Android 8.0 (API cấp 26), các ứng dụng không thể đăng ký thông báo truyền phát ngầm trong tệp kê khai, với một số ngoại lệ cụ thể.
Những điều cần cân nhắc khi cập nhật tiện ích của BroadcastReceiver
Nếu tiện ích được cập nhật từ BroadcastReceiver
, bao gồm cả AppWidgetProvider
, hãy lưu ý những điểm cần cân nhắc sau đây về thời lượng và mức độ ưu tiên của một bản cập nhật tiện ích.
Thời gian cập nhật
Theo quy tắc, hệ thống cho phép broadcast receiver (thường chạy trong luồng chính của ứng dụng) chạy tối đa 10 giây trước khi xem chúng là không phản hồi và kích hoạt lỗi Ứng dụng không phản hồi (ANR). Nếu việc cập nhật tiện ích mất nhiều thời gian hơn, hãy cân nhắc các phương án thay thế sau:
Lên lịch cho việc cần làm bằng
WorkManager
.Cho receiver thêm thời gian bằng phương thức
goAsync
. Điều này cho phép receiver thực thi trong 30 giây.
Hãy xem bài viết Các phương pháp hay nhất và cân nhắc về bảo mật để biết thêm thông tin.
Mức độ ưu tiên của bản cập nhật
Theo mặc định, các thông báo truyền tin (bao gồm cả các thông báo được tạo bằng AppWidgetProvider.onUpdate
) sẽ chạy ở dạng quy trình nền. Điều này có nghĩa là các tài nguyên hệ thống bị quá tải có thể gây ra độ trễ trong lệnh gọi broadcast receiver. Để ưu tiên thông báo truyền tin, hãy đặt thông báo đó làm quy trình ở nền trước.
Ví dụ: thêm cờ Intent.FLAG_RECEIVER_FOREGROUND
vào Intent
được truyền đến PendingIntent.getBroadcast
khi người dùng nhấn vào một phần nhất định của tiện ích.
Tạo bản xem trước chính xác bao gồm các mục động
Phần này giải thích phương pháp đề xuất để hiển thị nhiều mục trong bản xem trước tiện ích cho một tiện ích có chế độ xem bộ sưu tập – tức là tiện ích sử dụng ListView
, GridView
hoặc StackView
.
Nếu tiện ích của bạn sử dụng một trong các khung hiển thị này, việc tạo bản xem trước có thể mở rộng bằng cách trực tiếp cung cấp bố cục tiện ích thực tế sẽ làm giảm trải nghiệm khi bản xem trước tiện ích không hiển thị mục nào. Điều này xảy ra vì dữ liệu khung hiển thị bộ sưu tập được đặt động trong thời gian chạy và trông giống như hình ảnh trong hình 1.
Để bản xem trước của các tiện ích có khung hiển thị bộ sưu tập hiển thị chính xác trong bộ chọn tiện ích, bạn nên duy trì một tệp bố cục riêng được chỉ định chỉ cho bản xem trước. Tệp bố cục riêng biệt này bao gồm bố cục tiện ích thực tế và một khung hiển thị bộ sưu tập phần giữ chỗ có các mục giả mạo. Ví dụ: bạn có thể bắt chước ListView
bằng cách cung cấp phần giữ chỗ LinearLayout
có một số mục danh sách giả mạo.
Để minh hoạ ví dụ cho ListView
, hãy bắt đầu bằng một tệp bố cục riêng:
// res/layout/widget_preview.xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@drawable/widget_background"
android:orientation="vertical">
// Include the actual widget layout that contains ListView.
<include
layout="@layout/widget_view"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
// The number of fake items you include depends on the values you provide
// for minHeight or targetCellHeight in the AppWidgetProviderInfo
// definition.
<TextView android:text="@string/fake_item1"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginVertical="?attr/appWidgetInternalPadding" />
<TextView android:text="@string/fake_item2"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginVertical="?attr/appWidgetInternalPadding" />
</LinearLayout>
Chỉ định tệp bố cục xem trước khi cung cấp thuộc tính previewLayout
của siêu dữ liệu AppWidgetProviderInfo
. Bạn vẫn chỉ định bố cục tiện ích thực tế cho thuộc tính initialLayout
và sử dụng bố cục tiện ích thực tế khi tạo RemoteViews
trong thời gian chạy.
<appwidget-provider
previewLayout="@layout/widget_previe"
initialLayout="@layout/widget_view" />
Mục danh sách phức tạp
Ví dụ trong phần trước cung cấp các mục danh sách giả mạo, vì các mục trong danh sách là đối tượng TextView
. Việc cung cấp các mục giả mạo có thể phức tạp hơn nếu các mục đó có bố cục phức tạp.
Hãy xem xét một mục danh sách được xác định trong widget_list_item.xml
và bao gồm 2 đối tượng TextView
:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<TextView android:id="@id/title"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/fake_title" />
<TextView android:id="@id/content"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/fake_content" />
</LinearLayout>
Để cung cấp các mục danh sách giả mạo, bạn có thể đưa bố cục vào nhiều lần, nhưng điều này khiến mỗi mục trong danh sách giống hệt nhau. Để cung cấp các mục danh sách riêng biệt, hãy làm theo các bước sau:
Tạo một tập hợp các thuộc tính cho các giá trị văn bản:
<resources> <attr name="widgetTitle" format="string" /> <attr name="widgetContent" format="string" /> </resources>
Sử dụng các thuộc tính này để thiết lập văn bản:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="wrap_content"> <TextView android:id="@id/title" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="?widgetTitle" /> <TextView android:id="@id/content" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="?widgetContent" /> </LinearLayout>
Tạo nhiều kiểu tuỳ ý đối với bản xem trước. Xác định lại các giá trị trong từng kiểu:
<resources> <style name="Theme.Widget.ListItem"> <item name="widgetTitle"></item> <item name="widgetContent"></item> </style> <style name="Theme.Widget.ListItem.Preview1"> <item name="widgetTitle">Fake Title 1</item> <item name="widgetContent">Fake content 1</item> </style> <style name="Theme.Widget.ListItem.Preview2"> <item name="widgetTitle">Fake title 2</item> <item name="widgetContent">Fake content 2</item> </style> </resources>
Áp dụng kiểu cho các mục giả mạo trong bố cục xem trước:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="wrap_content" ...> <include layout="@layout/widget_view" ... /> <include layout="@layout/widget_list_item" android:theme="@style/Theme.Widget.ListItem.Preview1" /> <include layout="@layout/widget_list_item" android:theme="@style/Theme.Widget.ListItem.Preview2" /> </LinearLayout>