Cải thiện tiện ích

Thử dùng Compose
Jetpack Compose là bộ công cụ giao diện người dùng được đề xuất cho Android. Tìm hiểu cách tạo các tiện ích bằng API theo kiểu Compose.
Jetpack Glance →

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 cho tiện ích, có sẵn từ Android 12 (API cấp 31). Đây là những tính năng không bắt buộc, nhưng bạn có thể dễ dàng triển khai và cải thiện trải nghiệm của người dùng về 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 giúp các hiệu ứng chuyển đổi mượt mà hơn và đảm bảo tính nhất quán trên nhiều tiện ích.

Có hai cách để đạt được màu sắc động:

Sau khi đặt giao diện 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ỳ thành phần con nào của gốc để chọn màu động.

Sau đây là một số ví dụ về thuộc tính màu mà bạn có thể sử dụng:

  • ?attr/primary
  • ?attr/primaryContainer
  • ?attr/onPrimary
  • ?attr/onPrimaryContainer

Trong ví dụ sau đây sử dụng giao diện Material 3, màu giao diện của thiết bị là "hơi tím". Màu nhấn và nền tiện ích sẽ điều chỉnh theo 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>
Tiện ích ở giao diện chế độ sáng
Hình 1. Tiện ích ở giao diện sáng.
Tiện ích ở giao diện chế độ tối
Hình 2. Tiện ích ở giao diện tối.

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 một giao diện tuỳ chỉnh cho các phiên bản thấp hơn, hãy tạo một giao diện mặc định bằng màu tuỳ chỉnh và một bộ đủ điều kiện mới (values-v31) bằng cách sử dụng các thuộc tính giao diện mặc định.

Sau đây là một ví dụ 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 chế độ hỗ trợ giọng nói

Hành động trong ứng dụng cho phép Trợ lý Google hiển thị các tiện ích để phản hồi các 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 sẵn (BII), ứng dụng của bạn có thể chủ động hiển thị các tiện ích trên các nền tảng của Trợ lý, chẳng hạn như Android và Android Auto. Người dùng có thể ghim các tiện ích do Trợ lý hiển thị vào trình chạy của họ, từ đó khuyến khích họ 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 cho ứng dụng thể dục để thực hiện các 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?"

Có hàng chục BII bao gồm nhiều 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 nâng cao các tiện ích của mì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 chọn tiện ích của ứng dụng

Android 12 cho phép bạn thêm nội dung mô tả tiện ích và bản xem trước tiện ích được điều chỉnh tỷ lệ. Android 15 cho phép bạn cải thiện trải nghiệm chọn tiện ích cho ứng dụng của mình bằng các bản xem trước tiện ích được tạo.

Để cải thiện trải nghiệm của trình chọn tiện ích trong ứng dụng, hãy cung cấp bản xem trước tiện ích đã tạo trên các thiết bị Android 15 trở lên, bản xem trước tiện ích được chia tỷ lệ (bằng cách chỉ định previewLayout) cho các thiết bị Android 12 đến Android 14 và previewImage cho các phiên bản trước đó.

Thêm bản xem trước tiện ích được tạo vào bộ chọn tiện ích

Các ứng dụng phải đặt giá trị compileSdk thành 35 trở lên trong tệp build.gradle của mô-đun để có thể cung cấp RemoteViews cho bộ chọn tiện ích trên các thiết bị chạy Android 15 trở lên. Điều này có nghĩa là các ứng dụng có thể cập nhật nội dung trong bộ chọn để thể hiện rõ hơn những gì người dùng nhìn thấy.

Các ứng dụng có thể dùng phương thức AppWidgetManager, setWidgetPreview và getWidgetPreview để cập nhật giao diện của tiện ích bằng thông tin mới nhất và được cá nhân hoá.

Tạo bản xem trước mới bằng Jetpack Glance

Glance.compose chạy một thành phần, do đó, không có hàm tạm ngưng, luồng hoặc các lệnh gọi không đồng bộ tương tự được dùng trong phần nội dung của thành phần kết hợp. Thay vào đó, bạn phải sử dụng dữ liệu hằng số.

Ví dụ sau đây sử dụng Jetpack Glance để tạo bản xem trước mới. Bạn phải có chế độ cài đặt bản dựng compileSdk từ 35 trở lên để setWidgetPreview xuất hiện dưới dạng một phương thức trong đoạn mã này.

AppWidgetManager.getInstance(appContext).setWidgetPreview(
    ComponentName(
        appContext,
        ExampleAppWidgetReceiver::class.java
    ),
    AppWidgetProviderInfo.WIDGET_CATEGORY_HOME_SCREEN,
    ExampleAppWidget().compose(
        context = appContext
    ),
)

AppWidgetSnippets.kt

Tạo bản xem trước mới mà không cần Jetpack Glance

Bạn có thể dùng RemoteViews mà không cần chế độ Xem nhanh. Ví dụ sau đây tải một tài nguyên bố cục tiện ích XML và đặt tài nguyên đó làm bản xem trước. Bạn phải có chế độ cài đặt bản dựng compileSdk từ 35 trở lên để setWidgetPreview xuất hiện dưới dạng một phương thức trong đoạn mã này.

AppWidgetManager.getInstance(appContext).setWidgetPreview(
    ComponentName(
        appContext,
        ExampleAppWidgetReceiver::class.java
    ),
    AppWidgetProviderInfo.WIDGET_CATEGORY_HOME_SCREEN,
    RemoteViews("com.example", R.layout.widget_preview)
)
AppWidgetSnippets.kt

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 xuất hiện trong bộ chọn tiện ích có thể điều chỉnh kích thước. Bạn cung cấp bố cục này dưới dạng một 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 tiện ích xuất hiện khi đượ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 một bố cục XML thay thế:

<appwidget-provider
    android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>

Bạn nên sử dụng cùng một bố cục 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 đây trên trang này.

Bạn nên chỉ định cả thuộc tính previewLayout và previewImage để ứng dụng của bạn 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.

Các phương pháp được đề xuất để tạo 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 một bố cục XML:

<appwidget-provider
    ...
    android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>
Hình ảnh cho thấy bản xem trước của tiện ích
Hình 3. Bản xem trước của một tiện ích xuất hiện trong vùng 3x3 theo mặc định nhưng có thể vừa với vùng 3x1 do bố cục XML của tiện ích.

Để 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 hoặc phần giữ chỗ, chẳng hạn như android:src="@drawable/my_widget_icon", cho các thành phần ImageView.

Nếu không có giá trị mặc định, bản xem trước có thể hiển thị các giá trị không chính xác hoặc giá trị 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 được bản địa hoá.

Để biết các phương pháp được đề xuất cho những bản xem trước phức tạp hơn có chứa ListView, GridView hoặc StackView, hãy xem phần 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 các 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 tiện ích của bạn, 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.

Đặt tên cho tiện ích

Các tiện ích phải có tên riêng biệt khi xuất hiện trong bộ chọn tiện ích.

Tên của các tiện ích được tải từ thuộc tính label của phần tử receiver trong tiện ích trong tệp AndroidManifest.xml.

<receiver
    ….
   android:label="Memories">
     ….
</receiver>

Thêm nội dung mô tả cho tiện ích

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.

Hình ảnh cho thấy bộ chọn tiện ích hiển thị một tiện ích và nội dung mô tả về tiện ích đó
Hình 4. Bộ chọn tiện ích mẫu cho thấy một tiện ích và nội dung mô tả của tiện ích đó.

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ử &lt;appwidget-provider&gt;:

<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 đây, nhưng trình chọn tiện ích sẽ bỏ qua thuộc tính này.

Bật chế độ chuyển đổi mượt mà hơn

Kể từ Android 12, trình chạy sẽ mang đến một hiệu ứng chuyển đổi mượt mà hơn khi người dùng chạy ứng dụng của bạn từ một tiện ích.

Để bật hiệu ứng chuyển đổi cải tiến này, hãy dùng @android:id/background hoặc android.R.id.background để xác định phần tử nề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 sẽ bị bỏ qua.

Sử dụng chế độ sửa đổi RemoteViews trong thời gian chạy

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 được thêm.

Ví dụ về mã sau đây cho thấy cách sử dụng một số phương thức 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);