應用程式小工具可以設定。舉例來說,時鐘小工具可讓使用者設定要顯示的時區。
如要讓使用者調整小工具設定,請建立小工具設定 Activity。
宣告設定活動
無論是基於 View 或 Glance 的應用程式小工具,在資訊清單中宣告設定活動,並在供應器 XML 中繼資料中連結該活動的方式都相同。
如要瞭解如何宣告設定活動,請參閱 Glance 設定說明文件的「Compose 優先」宣告設定活動一節。
實作設定活動
設定活動是由平台啟動器呼叫的標準元件,因此其基本生命週期回呼必須遵循系統的傳回值規則。
如要瞭解如何實作設定活動,請參閱 Glance 說明文件的「Compose-first」實作設定活動一節。
透過設定活動更新小工具
在傳統以 View 為基礎的小工具中,您可以使用 AppWidgetManager 和 RemoteViews 版面配置例項,在設定完成後更新小工具。
如果您要建構舊版 View 基礎小工具,且需要更新 RemoteViews 版面配置,請參考 GitHub 上的傳統 View 更新程式碼範例。如要瞭解新式 Compose-first 小工具,請參閱 Glance 說明文件的「從設定活動更新」一節。
小工具設定選項
小工具行為 (例如允許稍後重新設定,或完全略過初始設定步驟) 會使用標準 Android 12 旗標,在中繼資料屬性中註冊。
如要瞭解如何運用動態小工具選項,請參閱 Glance 設定說明文件中的「Compose-first 小工具設定選項」一節。
允許使用者重新設定已放置的小工具
如要瞭解如何新增自訂可重新設定的設定觸發條件,請參閱 Glance 說明文件中的「Compose-first」讓使用者重新設定已放置的小工具一節。
使用小工具的預設設定
如要瞭解如何預設略過設定,請參閱 Glance 說明文件中的 Compose-first 使用小工具的預設設定一節。