Trang này cung cấp thông tin chi tiết về các tính năng nâng cao không bắt buộc dành cho tiện ích có sẵn kể từ Android 12 (API cấp 31). Đây là những tính năng không bắt buộc nhưng rất đơn giản để triển khai và cải thiện trải nghiệm của người dùng trên tiện ích.
Sử dụng màu động
Kể từ Android 12, một tiện ích có thể sử dụng màu giao diện của thiết bị cho các nút, nền và các thành phần khác. Điều này mang đến các hiệu ứng chuyển đổi và tính nhất quán mượt mà hơn trên nhiều tiện ích.
Có hai cách để tạo được màu động:
Sử dụng giao diện mặc định của hệ thống (
@android:style/Theme.DeviceDefault.DayNight
) trong bố cục gốc.Sử dụng giao diện Material 3 (
Theme.Material3.DynamicColors.DayNight
) trong thư viện Thành phần Material cho Android, có trong thư viện Thành phần Material cho Android phiên bản 1.6.0.
Sau khi giao diện được đặt trong bố cục gốc, bạn có thể sử dụng các thuộc tính màu phổ biến trong gốc hoặc bất kỳ phần tử con nào của nó để chọn màu động.
Sau đây là một số ví dụ về thuộc tính màu sắc mà bạn có thể sử dụng:
?attr/primary
?attr/primaryContainer
?attr/onPrimary
?attr/onPrimaryContainer
Trong ví dụ sau đây khi sử dụng giao diện Material 3, màu giao diện của thiết bị là "tím". Màu nhấn và nền tiện ích thích ứng với chế độ sáng và tối, như minh hoạ trong hình 1 và 2.
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="?attr/colorPrimaryContainer"
android:theme="@style/Theme.Material3.DynamicColors.DayNight">
<ImageView
...
app:tint="?attr/colorPrimaryContainer"
android:src="@drawable/ic_partly_cloudy" />
<!-- Other widget content. -->
</LinearLayout>
Khả năng tương thích ngược cho màu động
Màu động chỉ có trên các thiết bị chạy Android 12 trở lên. Để cung cấp giao diện tuỳ chỉnh cho các phiên bản thấp hơn, hãy tạo giao diện mặc định với màu sắc tuỳ chỉnh và bộ hạn định mới (values-v31
) bằng cách sử dụng các thuộc tính giao diện mặc định.
Dưới đây là ví dụ về cách sử dụng giao diện Material 3:
/values/styles.xml
<resources>
<style name="MyWidgetTheme" parent="Theme.Material3.DynamicColors.DayNight">
<!-- Override default colorBackground attribute with custom color. -->
<item name="android:colorBackground">@color/my_background_color</item>
<!-- Add other colors/attributes. -->
</style>
</resources>
/values-v31/styles.xml
<resources>
<!-- Do not override any color attribute. -->
<style name="MyWidgetTheme" parent="Theme.Material3.DynamicColors.DayNight" />
</resources>
/layout/my_widget_layout.xml
<resources>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
...
android:background="?android:attr/colorBackground"
android:theme="@style/MyWidgetTheme" />
</resources>
Bật tính năng hỗ trợ thoại
Hành động trong ứng dụng cho phép Trợ lý Google hiển thị các tiện ích theo lệnh thoại có liên quan của người dùng. Bằng cách định cấu hình tiện ích để phản hồi các ý định tích hợp (BII), ứng dụng của bạn có thể chủ động hiển thị các tiện ích trên nền tảng Trợ lý như Android và Android Auto. Người dùng có thể ghim các tiện ích do Trợ lý hiển thị cho trình chạy của họ, khuyến khích người dùng tương tác trong tương lai.
Ví dụ: bạn có thể định cấu hình tiện ích tóm tắt bài tập thể dục cho ứng dụng tập thể dục để thực hiện lệnh thoại của người dùng kích hoạt BII GET_EXERCISE_OBSERVATION
. Trợ lý chủ động hiển thị tiện ích của bạn khi người dùng kích hoạt BII này bằng cách đưa ra các yêu cầu như "Ok Google, tuần này tôi chạy được bao nhiêu dặm trên ExampleApp rồi?"
Có rất nhiều BII bao gồm một số danh mục tương tác của người dùng, cho phép hầu hết mọi ứng dụng Android đều cải thiện các tiện ích dành cho giọng nói. Để bắt đầu, hãy xem bài viết Tích hợp Hành động trong ứng dụng với các tiện ích Android.
Cải thiện trải nghiệm bộ chọn tiện ích của ứng dụng
Android 12 cho phép bạn cải thiện trải nghiệm bộ chọn tiện ích cho ứng dụng của mình bằng cách thêm bản xem trước tiện ích động và nội dung mô tả tiện ích.
Thêm bản xem trước tiện ích có thể mở rộng vào bộ chọn tiện ích
Kể từ Android 12, bản xem trước tiện ích hiển thị trong bộ chọn tiện ích sẽ có thể mở rộng. Bạn cung cấp tệp này dưới dạng bố cục XML được đặt thành kích thước mặc định của tiện ích. Trước đây, bản xem trước tiện ích là một tài nguyên có thể vẽ tĩnh, trong một số trường hợp dẫn đến việc bản xem trước phản ánh không chính xác cách các tiện ích xuất hiện khi chúng được thêm vào màn hình chính.
Để triển khai bản xem trước tiện ích có thể mở rộng, hãy sử dụng thuộc tính previewLayout
của phần tử appwidget-provider
để cung cấp bố cục XML:
<appwidget-provider
android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>
Bạn nên sử dụng bố cục giống như tiện ích thực tế, với các giá trị mặc định hoặc giá trị kiểm thử thực tế. Hầu hết các ứng dụng đều dùng cùng một previewLayout
và initialLayout
. Để được hướng dẫn về cách tạo bố cục xem trước chính xác, hãy xem phần sau trên trang này.
Bạn nên chỉ định cả hai thuộc tính previewLayout
và previewImage
để ứng dụng có thể quay lại sử dụng previewImage
nếu thiết bị của người dùng không hỗ trợ previewLayout
. Thuộc tính previewLayout
được ưu tiên hơn thuộc tính previewImage
.
Phương pháp đề xuất để xây dựng bản xem trước chính xác
Để triển khai bản xem trước tiện ích có thể mở rộng, hãy sử dụng thuộc tính previewLayout
của phần tử appwidget-provider
để cung cấp bố cục XML:
<appwidget-provider
...
android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>
Để hiển thị bản xem trước chính xác, bạn có thể trực tiếp cung cấp bố cục tiện ích thực tế với các giá trị mặc định bằng cách hoàn tất các bước sau:
Đặt
android:text="@string/my_widget_item_fake_1"
cho các phần tửTextView
.Đặt hình ảnh hoặc biểu tượng mặc định/phần giữ chỗ, chẳng hạn như
android:src="@drawable/my_widget_icon"
, cho các thành phầnImageView
.
Nếu không có giá trị mặc định, bản xem trước có thể hiển thị giá trị không chính xác hoặc trống. Một lợi ích quan trọng của phương pháp này là bạn có thể cung cấp nội dung xem trước đã bản địa hoá.
Để biết các phương pháp đề xuất cho bản xem trước phức tạp hơn có chứa ListView
, GridView
hoặc StackView
, hãy xem bài viết Tạo bản xem trước chính xác có chứa các mục động để biết thông tin chi tiết.
Khả năng tương thích ngược với bản xem trước tiện ích có thể mở rộng
Để cho phép bộ chọn tiện ích trên Android 11 (API cấp 30) trở xuống hiển thị bản xem trước của tiện ích, hãy chỉ định thuộc tính previewImage
.
Nếu bạn thay đổi giao diện của tiện ích, hãy cập nhật hình ảnh xem trước.
Thêm nội dung mô tả cho tiện ích của bạn
Kể từ Android 12, hãy cung cấp nội dung mô tả cho bộ chọn tiện ích để hiển thị cho tiện ích của bạn.
Cung cấp nội dung mô tả cho tiện ích bằng cách sử dụng thuộc tính description
của phần tử <appwidget-provider>
:
<appwidget-provider
android:description="@string/my_widget_description">
</appwidget-provider>
Bạn có thể sử dụng thuộc tính descriptionRes
trên các phiên bản Android trước, nhưng bộ chọn tiện ích sẽ bỏ qua thuộc tính này.
Giúp quá trình chuyển đổi diễn ra suôn sẻ hơn
Kể từ Android 12, trình chạy sẽ chuyển đổi mượt mà hơn khi người dùng khởi chạy ứng dụng từ một tiện ích.
Để bật hiệu ứng chuyển đổi được cải tiến này, hãy sử dụng @android:id/background
hoặc android.R.id.background
để xác định phần tử nền của bạn:
// Top-level layout of the widget.
<LinearLayout
android:id="@android:id/background">
</LinearLayout>
Ứng dụng của bạn có thể sử dụng @android:id/background
trên các phiên bản Android trước mà không bị lỗi, nhưng thuộc tính này sẽ bị bỏ qua.
Sử dụng tính năng sửa đổi thời gian chạy của RemoteViews
Kể từ Android 12, bạn có thể tận dụng một số phương thức RemoteViews
cho phép sửa đổi các thuộc tính RemoteViews
trong thời gian chạy. Hãy xem tài liệu tham khảo API RemoteViews
để biết danh sách đầy đủ các phương thức đã thêm.
Ví dụ về mã sau đây cho thấy cách sử dụng một vài phương thức trong số này.
Kotlin
// Set the colors of a progress bar at runtime. remoteView.setColorStateList(R.id.progress, "setProgressTintList", createProgressColorStateList()) // Specify exact sizes for margins. remoteView.setViewLayoutMargin(R.id.text, RemoteViews.MARGIN_END, 8f, TypedValue.COMPLEX_UNIT_DP)
Java
// Set the colors of a progress bar at runtime. remoteView.setColorStateList(R.id.progress, "setProgressTintList", createProgressColorStateList()); // Specify exact sizes for margins. remoteView.setViewLayoutMargin(R.id.text, RemoteViews.MARGIN_END, 8f, TypedValue.COMPLEX_UNIT_DP);