App Widgets and Shortcuts

dependencies {
    implementation("androidx.glance:glance-appwidget:1.1.1")   // check for the latest stable version
    implementation("androidx.glance:glance-material3:1.1.1")
}

class TasksWidget : GlanceAppWidget() {

    override suspend fun provideGlance(context: Context, id: GlanceId) {
        val tasks = TaskRepository.get(context).todayTasks()   // load data (suspend)
        provideContent {
            GlanceTheme {
                Column(
                    modifier = GlanceModifier.fillMaxSize()
                        .background(GlanceTheme.colors.background)
                        .padding(12.dp)
                        .clickable(actionStartActivity<MainActivity>()),
                ) {
                    Text("Today (${tasks.size})", style = TextStyle(fontWeight = FontWeight.Bold))
                    tasks.take(3).forEach { Text("• ${it.title}", maxLines = 1) }
                }
            }
        }
    }
}

class TasksWidgetReceiver : GlanceAppWidgetReceiver() {
    override val glanceAppWidget: GlanceAppWidget = TasksWidget()
}

<receiver android:name=".TasksWidgetReceiver" android:exported="true">
    <intent-filter>
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>
    <meta-data android:name="android.appwidget.provider"
        android:resource="@xml/tasks_widget_info" />
</receiver>

<!-- res/xml/tasks_widget_info.xml -->
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="180dp" android:minHeight="110dp"
    android:targetCellWidth="3" android:targetCellHeight="2"
    android:resizeMode="horizontal|vertical"
    android:updatePeriodMillis="0"
    android:initialLayout="@layout/glance_default_loading_layout"
    android:description="@string/tasks_widget_description"
    android:widgetCategory="home_screen" />

// After data changes in the app
suspend fun refreshWidgets(context: Context) {
    TasksWidget().updateAll(context)
}

// Periodically (minimum 15 min) with WorkManager
class WidgetRefreshWorker(ctx: Context, p: WorkerParameters) : CoroutineWorker(ctx, p) {
    override suspend fun doWork(): Result {
        TasksWidget().updateAll(applicationContext)
        return Result.success()
    }
}

val shortcut = ShortcutInfoCompat.Builder(context, "new_task")
    .setShortLabel("New task")
    .setLongLabel("Create a new task")
    .setIcon(IconCompat.createWithResource(context, R.drawable.ic_add))
    .setIntent(Intent(Intent.ACTION_VIEW, Uri.parse("https://example.com/tasks/new"),
        context, MainActivity::class.java))
    .build()

ShortcutManagerCompat.pushDynamicShortcut(context, shortcut)