AppWidget(桌面组件)

区别

• 与普通widget是两个概念。普通说的widget只是组件，视图。
• App widget 是一个桌面组件。

注意：

    应用必须安装在内存里，才能显示widget

开始

• 在官方文档里搜索 App widget

配置：在清单文件里添加下列配置(广播接受者)

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

声明ProcessWidgetProvider

• 其实就是一个AppWidgetProvider 子类

• onReceive ： 只要有广播，就会调用

• onEnabled ： 第一个widget创建出来的时候调用
• onUpdate ： 系统更新widget的时候调用。 widget创建的时候调用。
• onDelete : widget 删除的时候调用
• onDisable ： 最后一个widget删除的时候调用。

在res/xml/文件夹下添加 process_widget_info.xml文件

• minWidth widget最小宽度
• minHeight 最小高度
• previewImage 设置预览用的图片。在添加widget之前，widget列表看到的样子。
• initialLayout：显示样式的布局文件
• resizeMode：用来表示缩放的方式。horizontal vertical。如果属性没有配置代表不可缩放

• widgetCategory

  • home_screen 普通widget的类型
  • keyguard 5.0之后添加的类型。可以显示在锁屏界面上。

• updatePeriodMillis： 系统自动更新widget的时间间隔。

  • 单位是毫秒。
  • 4.0 最小更新间隔为 半个小时
  • 0 代表不更新。

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="40dp"
    android:minHeight="40dp"
    android:updatePeriodMillis="1"
    android:previewImage="@drawable/preview"
    android:initialLayout="@layout/example_appwidget"
    android:resizeMode="horizontal|vertical"
    android:widgetCategory="home_screen">
appwidget-provider>

添加点击事件

public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {

    LogUtils.loge("onUpdate");
    for (int id:appWidgetIds) {

        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.widget_process);
        views.setTextViewText(R.id.tv_process_widget,"呵呵，我是一个拓达一键清理widget");

        Intent intent = new Intent(context, ProcessWidgetProvider.class);
        intent.setAction("PROCESS_BTN_CLICK");
        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
        views.setOnClickPendingIntent(R.id.btn_process_widget, pendingIntent);

        appWidgetManager.updateAppWidget(id,views);
    }
}

外部更新widget

SimpleDateFormat formater = new SimpleDateFormat("H:m:s");
RemoteViews views = new RemoteViews(getPackageName(), R.layout.widget_process);
views.setTextViewText(R.id.tv_process_widget,formater.format(new Date()));

Intent intent = new Intent(this, ProcessWidgetProvider.class);
intent.setAction("PROCESS_BTN_CLICK");
PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, 0);
views.setOnClickPendingIntent(R.id.btn_process_widget, pendingIntent);

//widgetmanager
AppWidgetManager manager = AppWidgetManager.getInstance(getApplicationContext());

//这里的ProcessWidgetProvider 就是在清单文件里注册的 AppWidget 的 WidgetProvider
ComponentName componentName = new ComponentName(getApplicationContext(), ProcessWidgetProvider.class);
manager.updateAppWidget(componentName, views);

主动更新

• 使用handler
• 使用AarmManager
  
  • 使用这个，不怕服务被杀死。
  • 用户强制停止，半个小时候，系统调用onUpdate的时候，也会把服务重新启动。