應用程式小工具可供設定。舉例來說,時鐘小工具可讓使用者設定要顯示的時區。
如要讓使用者設定小工具,請建立小工具設定 Activity。
宣告設定活動
在資訊清單中宣告設定活動,並在供應商 XML 中繼資料內連結該活動,對於以 Views 為基礎和以 Glance 為基礎的應用程式小工具來說,做法完全相同。
如要瞭解如何宣告設定活動,請參閱 Glance 設定文件中的「Compose-first:宣告設定活動」一節。
實作設定活動
由於設定活動是由平台啟動器呼叫的標準元件,因此基本生命週期回呼必須遵循系統的回傳值規則。
如要瞭解如何導入設定活動,請參閱 Glance 說明文件中的「導入設定活動」一節。
從設定活動更新小工具
在以 Views 為基礎的小工具中,您可以使用 AppWidgetManager 和 RemoteViews 版面配置例項,在完成設定後更新小工具。
如果您要建構以舊版 Views 為基礎的小工具,並需要更新 RemoteViews 版面配置,請參閱 GitHub 上的傳統 Views 程式碼範例。如要瞭解以 Compose 為主的現代小工具,請參閱 Glance 說明文件中的「從設定活動部分更新」一節。
小工具設定選項
小工具行為 (例如允許稍後重新設定,或完全略過初始設定步驟) 會使用標準 Android 12 旗標,在後設資料屬性內註冊。
如要瞭解如何運用動態小工具選項,請參閱 Glance 設定說明文件中的「Compose-first 小工具設定選項」一節。
允許使用者重新設定已放置的小工具
如要瞭解如何新增可重新設定的自訂設定觸發條件,請參閱 Glance 說明文件中的「Compose-first」「Enable users to reconfigure placed widgets」一節。
使用小工具的預設設定
如要瞭解如何預設略過設定,請參閱 Glance 說明文件中的「Compose-first Use the widget's default configuration section」一節。