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

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

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

宣告設定活動

在資訊清單中宣告設定活動,並在供應商 XML 中繼資料內連結該活動,這項做法在 Views 和 Glance 架構的應用程式小工具中完全相同。

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

實作設定活動

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

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

從設定活動更新小工具

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

如果您要建構以舊版 Views 為基礎的小工具,並需要更新 RemoteViews 版面配置,請參閱 GitHub 上的傳統 Views 程式碼範例。如要瞭解以 Compose 為優先的現代小工具,請參閱 Glance 說明文件中的「從設定活動部分更新」。

小工具設定選項

小工具行為 (例如允許稍後重新設定,或完全略過初始設定步驟) 會使用標準 Android 12 旗標,在元資料屬性內註冊。

如要瞭解如何運用動態小工具選項,請參閱 Glance 設定說明文件中的「Compose-first Widget configuration options」一節。

允許使用者重新設定已放置的小工具

如要瞭解如何新增可重新設定的自訂設定觸發條件,請參閱 Glance 說明文件中的「Compose-first」啟用使用者重新設定放置的小工具一節。

使用小工具的預設設定

如要瞭解如何預設略過設定,請參閱 Glance 說明文件中的「Compose-first」使用小工具的預設設定一節。