小部件/快捷方式

在 Android 8.0 中用於添加快捷方式和小部件的新流程 API 允許應用程序開發人員從應用程序內部添加快捷方式和小部件,而不是依賴小部件托盤。出於安全原因,它還棄用了添加快捷方式的舊方法(發送廣播)。

啟動器需要支持這種新的實現,以便應用程序開發人員可以依賴系統來添加他們的快捷方式或小部件。

示例和來源

文檔在各種系統類中可用。參考資料包括以下內容:

  • ShortcutManager.java
    在標題中發布固定的快捷方式部分。
  • 意圖.java
    ACTION_CREATE_SHORTCUT 的 Javadoc。
  • AppWidgetManager.java
    requestPinAppWidget 的 Javadoc。

執行

設備實現者需要在他們的啟動器中添加一個帶有意圖過濾器操作的活動:

  • android.content.pm.action.CONFIRM_PIN_SHORTCUT
  • android.content.pm.action.CONFIRM_PIN_APPWIDGET

有關詳細信息,請參閱API 文檔

此活動應向用戶顯示確認提示以添加請求的小部件/快捷方式,並在接受後在主屏幕上添加相應的小部件/快捷方式。

對於小部件, accept()調用應包括新添加的小部件的小部件 ID。

實現系統 UI

合作夥伴需要使用 Launcher3 實現 ( packages/apps/Launcher3 ) 作為參考來更新他們的 Launcher 應用。

在 Android 開源項目 (AOSP) 中找到相關的 Launcher3 更改:

驗證

要驗證該功能,請嘗試從 Chrome 或聯繫人應用程序添加快捷方式,並驗證是否顯示了正確的確認提示。接受後,圖標應添加到主屏幕上,Chrome 應顯示成功祝酒詞。