Android 12桌面小组件

发布时间:2021年10月04日 阅读:9 次

前言

Anroid上的桌面小组件很早以前就有了,相比iOS的小组件一出来就大火不同,Android桌面小组件一直很难用,最近看到了Google微信号推送的文章:

  • 更新您的 widget 以适配 Android 12

  • 创造无限可能 | 在 Android 12 中使用 widget

我以为Android小组件间要崛起了!!开心的去看了[官网demo](user-interface-samples/AppWidget at main · android/user-interface-samples (github.com))

在Android12上主要更新了可调整窗口大小,不同主题下的效果,和一些圆角边距等细节设置,看起来还是不太聪明的样子

快速上手Widget

桌面小组件被Google成为微件:AppWidget,查看官网文档

右键菜单栏中创建Widget组件,其会自动创建相关类:Android 12桌面小组件 第1张

我们以创建一个TODO组件为例

相关类

  • AppWidgetProvider

组件类,通过广播与其连接,可以通过onUpdate,onEnableonDelete等方法与组件进行通信。

这里我们新建TodoWidget:

class TodoWidget : AppWidgetProvider() {
    override fun onUpdate(
        context: Context,
        appWidgetManager: AppWidgetManager,
        appWidgetIds: IntArray
    ) {

    }

    override fun onEnabled(context: Context) {
    
    }

    override fun onDisabled(context: Context) {
    
    }
}复制代码

同时我们需要在Mainfest.xml中注册:

<receiver
    android:name=".TodoWidget"
    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/todo_widget_info" />
</receiver>复制代码

widgetProvider继承自广播,本身可以通过onReceive()来接受消息

  • AppWidgetProviderInfo

提供了组件的各种信息,尺寸、布局、预览等信息,以xml文件的形式创建

资源文件下新建xml目录:

Android 12桌面小组件 第2张

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:description="@string/app_widget_description"
    android:initialKeyguardLayout="@layout/todo_widget_min"
    android:initialLayout="@layout/todo_widget_min"
    android:minWidth="110dp"
    android:minHeight="110dp"
    android:previewImage="@drawable/example_appwidget_preview"
    android:previewLayout="@layout/todo_widget_min"
    android:resizeMode="horizontal|vertical"
    android:targetCellWidth="1"
    android:targetCellHeight="1"
    android:updatePeriodMillis="86400000"
    android:widgetCategory="home_screen" />复制代码

创建布局

Widget组件布局基于:RemoteViews有很多特殊性,这也是目前Android小窗口的局限,很多组件都无法使用,交互也表困难。

RemoteViews 可以支持以下布局类:

  • FrameLayout

  • LinearLayout

  • RelativeLayout

  • GridLayout

以及以下微件类:

  • AnalogClock

  • Button

  • Chronometer

  • ImageButton

  • ImageView

  • ProgressBar

  • TextView

  • ViewFlipper

  • ListView

  • GridView

  • StackView

  • AdapterViewFlipper

对于我们常见的RecyclerView、约束布局都不支持!

布局代码可以看Demo,这里说下狂口调整时候的布局变化,调整窗口的大小在Android12上才可用

我们可以在WidgetProvider类中的onUpdate中更新组件:

override fun onUpdate(
    context: Context,
    appWidgetManager: AppWidgetManager,
    appWidgetIds: IntArray
) {
    // There may be multiple widgets active, so update all of them
    for (appWidgetId in appWidgetIds) {
        updateAppWidget(context, appWidgetManager, appWidgetId)
    }
}复制代码

创建多个RemoteView,我这里创建了三个不同布局对应不同尺寸:

@SuppressLint("RemoteViewLayout")
internal fun updateAppWidget(
    context: Context,
    appWidgetManager: AppWidgetManager,
    appWidgetId: Int
) {
    val remoteViewsMin = RemoteViews(
        context.packageName,
        R.layout.todo_widget_min
    )

    val remoteViewsNormal = RemoteViews(
        context.packageName,
        R.layout.todo_widget_normal
    )

    val remoteViewsMax = RemoteViews(
        context.packageName,
        R.layout.todo_widget_max
    )

    /*不同大小控件对应不同布局*/
    val viewMapping: MutableMap<SizeF, RemoteViews> = mutableMapOf()
    viewMapping[SizeF(180.0f, 110.0f)] = remoteViewsMin
    viewMapping[SizeF(230.0f, 180.0f)] = remoteViewsNormal
    viewMapping[SizeF(270.0f, 300.0f)] = remoteViewsMax

    /*只有在Android12以上版本才支持*/
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        appWidgetManager.updateAppWidget(appWidgetId, RemoteViews(viewMapping))
    }else{
        appWidgetManager.updateAppWidget(appWidgetId, remoteViewsNormal)
    }

}复制代码

查看效果

长按app图标就可在桌面添加组件,不同系统操作方式不一样。

Android 12桌面小组件 第3张

Android 12桌面小组件 第4张

通信交互

打开App,在Activity做出响应

widget和宿主app不属于同一进程,可以通过PendingIntent通信,和传统的Intent有点不一样,简言之:PendingIntent含有app的context,可以在外部进程打开app进程,PendingIntent不是立即执行的。

RemoteView设置点击事件

setOnClickPendingIntent(R.id.add, createPendingIntent(context,R.id.add))复制代码

createPendingIntent()是一个将id传给activity的方法,你也可以设置其他信息,在activity做出响应

private fun createPendingIntent(context: Context,@IdRes id:Int):PendingIntent{
    /*打开APP intent*/
    val activityIntent = Intent(context, MainActivity::class.java).apply {
        setData(Uri.parse("harvic:$id"))
        flags = Intent.FLAG_ACTIVITY_CLEAR_TASK or Intent.FLAG_ACTIVITY_NEW_TASK
    }
    val appOpenIntent = PendingIntent.getActivity(
        context,
        1,
        activityIntent,
        PendingIntent.FLAG_CANCEL_CURRENT or PendingIntent.FLAG_IMMUTABLE
    )
    return appOpenIntent
}复制代码

在onReceive中处理:

和上述的基本一样,根据id来处理不同的点击事件

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    val clickIntent = PendingIntent.getBroadcast(
        context,
        2,
        Intent(context, TodoWidget::class.java).apply {
            putExtra(EXTRA_VIEW_ID, R.id.title)
        },
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_MUTABLE
    )
    setOnClickPendingIntent(R.id.title,clickIntent)
}复制代码

最后

点击查看:项目代码,欢迎大佬们的Star

感觉Andorid桌面小组件依旧不够完善,和以前相比也没啥大大的改变。=.=


作者:xlu1997
链接:https://juejin.cn/post/7012916094637703199


Tag:
相关文章

发表评论: