微件可检测性

在搭载 Android 8.0（API 级别 26）及更高版本的设备上， 用户还会创建固定快捷方式 将微件固定到主屏幕上与固定的快捷方式类似 固定微件让用户有权访问应用中的特定任务，并且 添加到主屏幕，如以下视频所示。

图 2. 固定 widget 的示例。

允许用户固定微件

在您的应用中，您可以创建一个请求，让系统将某个 widget 固定到 支持的启动器：

1. 请务必在应用的清单文件中声明微件。

2. 调用 requestPinAppWidget() 方法，如以下代码段所示：

Kotlin

val appWidgetManager = AppWidgetManager.getInstance(context)
val myProvider = ComponentName(context, ExampleAppWidgetProvider::class.java)

if (appWidgetManager.isRequestPinAppWidgetSupported()) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    val successCallback = PendingIntent.getBroadcast(
            /* context = */ context,
            /* requestCode = */ 0,
            /* intent = */ Intent(...),
            /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT)

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

Java

AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
ComponentName myProvider = new ComponentName(context, ExampleAppWidgetProvider.class);

if (appWidgetManager.isRequestPinAppWidgetSupported()) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    PendingIntent successCallback = PendingIntent.getBroadcast(
            /* context = */ context,
            /* requestCode = */ 0,
            /* intent = */ new Intent(...),
            /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT);

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback);
}

注意： 如果您的应用无需获知系统是否已成功上传 将 widget 固定到支持的启动器上，您可以传入 null 作为第三个 参数设置为 requestPinAppWidget()。

相关设计指南

用户可通过微件选择器或 应用。如需了解详情，请参阅 发现和宣传。