Доступность виджета

На устройствах под управлением Android 8.0 (API уровня 26) и выше лаунчеры, позволяющие пользователям создавать закреплённые ярлыки, также позволяют закреплять виджеты на главном экране. Подобно закреплённым ярлыкам, эти закреплённые виджеты предоставляют пользователям доступ к определённым задачам в вашем приложении и могут быть добавлены на главный экран непосредственно из приложения, как показано в следующем видео.

Пример адаптивной верстки
Рисунок 2. Пример закрепления виджета.

Разрешить пользователям закреплять виджет

В своем приложении вы можете создать запрос к системе на закрепление виджета на поддерживаемом лаунчере, выполнив следующие шаги:

  1. Обязательно объявите виджет в файле манифеста вашего приложения .

  2. Вызовите метод requestPinAppWidget() , как показано в следующем фрагменте кода:

Котлин 

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)
}

Ява 

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);
}

Пользователи находят и добавляют ваш виджет через средство выбора виджетов или из вашего приложения, когда его функциональность наиболее актуальна. Подробнее см. в разделе «Обнаружение и продвижение» .