允許使用者設定應用程式小工具

應用程式小工具可供設定。舉例來說,時鐘小工具可讓使用者設定要顯示的時區。

如要讓使用者設定小工具,請建立小工具設定 Activity

宣告設定活動

在資訊清單中宣告設定活動,並在供應商 XML 中繼資料內連結該活動,對於以 Views 為基礎和以 Glance 為基礎的應用程式小工具來說,做法完全相同。

如要瞭解如何宣告設定活動,請參閱 Glance 設定文件中的「Compose-first:宣告設定活動」一節。

實作設定活動

由於設定活動是由平台啟動器呼叫的標準元件,因此基本生命週期回呼必須遵循系統的回傳值規則。

如要瞭解如何導入設定活動,請參閱 Glance 說明文件中的「導入設定活動」一節。

從設定活動更新小工具

在以 Views 為基礎的小工具中,您可以使用 AppWidgetManagerRemoteViews 版面配置例項,在完成設定後更新小工具。

如果您要建構以舊版 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」一節。