本頁詳細說明可用的小工具強化功能 從 Android 12 (API 級別 31) 開始。這些功能為選用功能 提供簡便的使用體驗以及小工具使用體驗。
使用動態色彩
從 Android 12 開始,小工具可以使用裝置主題顏色 適用於按鈕、背景及其他元件這可提供更流暢的轉場效果,並確保不同小工具的一致性。
動態色彩有兩種設定方式:
使用系統的預設主題 (
@android:style/Theme.DeviceDefault.DayNight
)。使用 Android 適用的 Material 元件程式庫中的 Material 3 主題 (
Theme.Material3.DynamicColors.DayNight
),該主題自 Android 適用的 Material 元件 v1.6.0 起提供。
在根版面配置中設定主題後,您就可以在 從根或其任何子項擷取動態色彩。
以下是一些可以使用的顏色屬性範例:
?attr/primary
?attr/primaryContainer
?attr/onPrimary
?attr/onPrimaryContainer
在以下使用 Material 3 主題的示例中,裝置的主題顏色是 「紫色」。強調色和小工具背景,可配合淺色和深色的亮度調整 就像圖 1 和圖 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>
動態色彩的回溯相容性
動態色彩僅適用於搭載 Android 12 的裝置
或更高版本。如要為較舊版本提供自訂主題,請使用自訂顏色建立預設主題,並使用預設主題屬性建立新的限定詞 (values-v31
)。
以下是使用 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>
啟用語音支援功能
讓 Google 助理支援應用程式動作 顯示小工具以回應相關使用者語音指令。透過設定 回應內建意圖 (BII) 的小工具, 應用程式可以主動在 Android 和 iOS 等 Google 助理介面顯示小工具 Android Auto使用者可以選擇固定 Google 助理顯示的小工具 啟動器,提高日後的互動性。
舉例來說,您可以為健身應用程式設定健身摘要小工具,以便執行使用者觸發 GET_EXERCISE_OBSERVATION
BII 的語音指令。當使用者透過「Ok Google,我這個禮拜在 ExampleApp 跑了幾英里?」這類要求觸發這個 BII 時,Google 助理會主動顯示您的小工具。
有數十個 BII 涵蓋多個類別的使用者互動,幾乎所有 Android 應用程式都能透過這些 BII 強化其語音小工具。如要開始使用,請參閱「整合應用程式動作與 Android 小工具」。
改善應用程式的小工具挑選器體驗
在 Android 12 中,您可以新增動態小工具預覽畫面和小工具說明,改善應用程式的小工具挑選器體驗。
在小工具挑選器中新增可調整的小工具預覽畫面
自 Android 12 起,小工具預覽畫面會顯示在 小工具挑選器是可擴充的您可以將其提供為 XML 版面配置,並設為小工具的預設大小。先前,小工具預覽為靜態可繪製資源 某些情況導致預覽畫面無法正確反映小工具在 系統會將他們新增到主畫面。
如要實作可擴充的小工具預覽,請使用
previewLayout
的 appwidget-provider
元素屬性,改為提供 XML 版面配置:
<appwidget-provider
android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>
建議您使用與實際小工具相同的版面配置,並設定實際的預設值或測試值。大多數應用程式都使用相同的 previewLayout
和 initialLayout
。如要瞭解如何建立準確的預覽版面配置,請參閱本頁的下一個部分。
建議您同時指定 previewLayout
和 previewImage
屬性,這樣如果使用者的裝置不支援 previewLayout
,應用程式就能改用 previewImage
。previewLayout
屬性的優先順序高於 previewImage
屬性。
建構準確預覽畫面的建議做法
如要實作可調整大小的小工具預覽畫面,請使用 appwidget-provider
元素的 previewLayout
屬性提供 XML 版面配置:
<appwidget-provider
...
android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>
如要顯示準確的預覽畫面,您可以直接完成下列步驟,為實際的小工具版面配置提供預設值:
正在為
TextView
設定「android:text="@string/my_widget_item_fake_1"
」 元素。設定預設或預留位置圖片或圖示,例如
android:src="@drawable/my_widget_icon"
,適用於ImageView
元件。
如果沒有預設值,預覽畫面可能會顯示不正確或空白的值。這種做法的重要優點是,您可以提供經過本地化的預覽內容。
如要進一步瞭解包含 ListView
、GridView
或 StackView
的複雜預覽畫面建議做法,請參閱「建立包含動態項目的精確預覽畫面」一文。
回溯相容性,可使用可調整大小的小工具預覽畫面
如要讓 Android 11 (API 級別 30) 以下版本的小工具挑選器顯示小工具的預覽畫面,請指定 previewImage
屬性。
如果變更小工具的外觀,請更新預覽圖片。
新增小工具的說明
從 Android 12 開始,請為小工具挑選器提供說明,以便顯示小工具。
使用 <appwidget-provider>
元素的 description
屬性,為小工具提供說明:
<appwidget-provider
android:description="@string/my_widget_description">
</appwidget-provider>
您可以在舊版 Android 上使用 descriptionRes
屬性,但小工具挑選器會忽略該屬性。
啟用更流暢的轉場效果
從 Android 12 開始,啟動器可讓轉場效果更加順暢 當使用者透過小工具啟動應用程式時。
如要啟用這種改善過的轉場效果,請使用 @android:id/background
或 android.R.id.background
來識別背景元素:
// Top-level layout of the widget.
<LinearLayout
android:id="@android:id/background">
</LinearLayout>
您的應用程式可以在舊版 Android 上使用 @android:id/background
但系統會忽略該屬性
使用執行階段修改 RemoteViews
從 Android 12 開始,您可以使用多種功能
支援 RemoteViews
執行階段修改的 RemoteViews
方法
屬性。查看 RemoteViews
API
完整的新增方法清單的參考資料。
以下程式碼範例說明如何使用其中幾種方法。
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);