什么是AppWidget?AppWidget就是我们平常在桌面上见到的那种一个个的小窗口,利用这个小窗口可以给用户提供一些方便快捷的操作。

创建简单的AppWidget

添加AppWidgetProviderInfo Metadata

在res文件夹下新建一个名字为xml的文件夹,然后在xml目录下创建一个名为appwidget.xml的文件:

xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="200dp"
android:minHeight="100dp"
android:updatePeriodMillis="0"
android:previewImage="@drawable/cd01"
android:initialLayout="@layout/widget_layout">

为appwidget定义layout

在layout文件夹下面新建一个widget_layout.xml文件,在这个文件中描述了appWidget的控件和布局等等信息:

android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
android:id="@+id/widget_text"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:textSize="10sp"
android:text="widget"/>
android:id="@+id/widget_btn"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="button"/>

创建AppWidgetProvider的子类

public class MyWidgetProvider extends AppWidgetProvider {
public static final String BROADCAST_STR = "com.kevinwang.widget";
public static final String MY_WIDGET_PROVIDER = "MyWidgetProvider";
@Override
public void onReceive(Context context, Intent intent) {
Log.i(MY_WIDGET_PROVIDER,"==onReceive()==");
super.onReceive(context,intent);
//接受广播事件
if (intent != null && TextUtils.equals(intent.getAction(), BROADCAST_STR)) {
//只能通过远程对象来设置appwidget中的控件状态
RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
//通过远程对象将textView的文字设置为”hello”
remoteViews.setTextViewText(R.id.widget_text, "hello");
//获得appwidget管理实例,用于管理appwidget以便进行更新操作
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
//获得所有本程序创建的appwidget
ComponentName componentName = new ComponentName(context,MyWidgetProvider.class);
//更新appwidget
appWidgetManager.updateAppWidget(componentName, remoteViews);
}
}
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
//到达指定的更新时间或者当用户向桌面添加AppWidget时被调用
Log.i(MY_WIDGET_PROVIDER,"==onUpdate()==");
super.onUpdate(context, appWidgetManager, appWidgetIds);
//创建一个Intent对象
Intent intent = new Intent();
intent.setClass(context, MyWidgetProvider.class);
intent.setAction(BROADCAST_STR);
//设置pendingIntent
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
//Retrieve a PendingIntent that will perform a broadcast
RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
//为button按钮绑定一个事件便于发送广播
remoteViews.setOnClickPendingIntent(R.id.widget_btn,pendingIntent);
appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
}
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
//删除一个AppWidget时调用
Log.i(MY_WIDGET_PROVIDER,"==onDelete()==");
super.onDeleted(context, appWidgetIds);
}
@Override
public void onEnabled(Context context) {
//AppWidget的实例第一次被创建时调用
Log.i(MY_WIDGET_PROVIDER,"==onEnabled()==");
super.onEnabled(context);
}
@Override
public void onDisabled(Context context) {
//删除一个AppWidget时调用
Log.i(MY_WIDGET_PROVIDER,"==onDisabled()==");
super.onDisabled(context);
}
}

在AndroidManifest中进行声明

android:resource="@xml/appwidget"/>

可以看到在配置文件里面定义了一个receiver,它的名字是上面创建处理控件代码的那个类。

intent-filter中的action是系统自带的用于更新所有appwidget的广播动作。

meta-data标签是一个描述我们创建appwidget的元数据,其中的android:name="android.appwidget.provider"是固定的,

android:resource="@xml/appwidget"指定创建的appWidget的布局信息。这样程序就知道到哪里去初始化这些appWidget啦。

AppWidget与程序交互

appwidget运行的进程和我们创建的应用不在一个进程中,所以我们也就不能像平常引用控件那样来获得控件的实例。这个时候就需要用到RemoteViews。

RemoteViews,顾名思义,它是一个远程视图。App Widget中的视图,都是通过RemoteViews表现的。

RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
//为button按钮绑定一个事件便于发送广播
remoteViews.setOnClickPendingIntent(R.id.widget_btn,pendingIntent);

上面出现的pendingIntent又是用来做什么的呢?PendingIntent可以看作是对Intent的一个封装,但它不是立刻执行某个行为,而是把PendingIntent放入一个新的进程。通过触发事件去触发这个PendingIntent。如果我们把Intent看成一封信,那么PendingIntent就是一封被信封包裹起来的信。这封信在remoteViews.setOnClickPendingIntent()中被“邮寄”到了appwidget, 当appwidget中的按钮单击时他知道将这封信打开,并执行里面的内容。

//创建一个Intent对象
Intent intent = new Intent();
intent.setClass(context, MyWidgetProvider.class);
intent.setAction(BROADCAST_STR);
//设置pendingIntent
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
在onUpdate方法中为AppWidget绑定事件
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
//到达指定的更新时间或者当用户向桌面添加AppWidget时被调用
//创建一个Intent对象
Intent intent = new Intent();
intent.setClass(context, MyWidgetProvider.class);
intent.setAction(BROADCAST_STR);
//设置pendingIntent
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
//Retrieve a PendingIntent that will perform a broadcast
RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
//为button按钮绑定一个事件便于发送广播
remoteViews.setOnClickPendingIntent(R.id.widget_btn,pendingIntent);
//更新Appwidget
appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
super.onUpdate(context, appWidgetManager, appWidgetIds);
}

在onReceive中接受广播并更新AppWidget

public void onReceive(Context context, Intent intent) {
//接受广播事件
if (intent != null && TextUtils.equals(intent.getAction(), BROADCAST_STR)) {
Log.i("onReceive()", "enter if block!");
//只能通过远程对象来设置appwidget中的控件状态
RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
//通过远程对象将textView的文字设置为”hello”
remoteViews.setTextViewText(R.id.widget_text, "hello");
//获得appwidget管理实例,用于管理appwidget以便进行更新操作
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
//获得所有本程序创建的appwidget
ComponentName componentName = new ComponentName(context,MyWidgetProvider.class);
//更新appwidget
appWidgetManager.updateAppWidget(componentName, remoteViews);
}
else {
super.onReceive(context,intent);
}
}

AppWidget的生命周期

当我们添加AppWidget时

点击其中的按钮时

移除控件时

从上面的结果中可以看出,AppWidgetProvider的其它4个生命周期函数的执行都是由onReceiver分发下去的。

在AppWidgetProvider实现中已经对接收到的

A

ctionAppWidgetManager.ACTION_APPWIDGET_UPDATE,
AppWidgetManager.ACTION_APPWIDGET_DELETED,
AppWidgetManager.ACTION_APPWIDGET_ENABLED以及
AppWidgetManager.ACTION_APPWIDGET_DISABLED做了处理,分别执行onUpdate()/ onDeleted() / onEnabled() / onDisabled()。