[实战] 关于AppWidgetProvider 桌面小工具如何实现

AppWidgetProvider提供一个在桌面的小窗口用来展示APP的内容。具体我们通过回答几个问题来展示如何实现。

1.怎么注册服务

2.怎么更新UI

3.怎么根据窗口大小使用不同的Layout

4.怎么定时刷新Layout

以下一一作答。


1.怎么注册服务

核心类，AppWidgetProvider 定义了基本的方法onAppWidgetOptionsChanged，onUpdate，onEnabled，onDisabled。

onAppWidgetOptionsChanged在窗口大小改变时被调用用来更新Layout。
onUpdate可视为init方法初始化UI
onEnabled在桌面上可能有一个或多个同类型窗口，这这个方法在第一个窗口被设置时调用。onDisabled在桌面上可能有一个或多个同类型窗口，这这个方法在最后窗口被取消时调用。

AppWidgetProvider本身是一个BroadcastReceiver所以它的lifecycle可以和APP中的activity是分开的。但是我们需要在manifest中注册这样系统能够捕获我们的provider。

<receiver android:name="ExampleAppWidgetProvider" >
     <intent-filter>
              <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
     </intent-filter>
     <meta-data android:name="android.appwidget.provider"
                android:resource="@xml/appwidget_info" />
</receiver>

代码中 appwidget_info 定义了一些配置信息。

 

class ExampleAppWidgetProvider : AppWidgetProvider() {

    override fun onReceive(context: Context?, intent: Intent?) {
        super.onReceive(context, intent)
    }

    override fun onAppWidgetOptionsChanged(context: Context, appWidgetManager: AppWidgetManager, appWidgetId: Int, newOptions: Bundle) {
        Utils.scheduleJob(context)
    }

    override fun onUpdate(