我们知道应用程序小插件(Widget)在API Level3中被正式引入,目前Widget已经很常见的被用于日历、天气、时钟、音乐播放器......等等应用中。
如果我们要制作一个Widge需要准备的有:
提供XML的插件配置
确定插件是否需要配置一个Activity
提供对AppWidgetProvider类的实现
提供一个Service类的实现,以便能够在必要的时候处理Widget的内容更新操作
修改应用程序的Android Manifest文件,注册插件的相关信息,Service的相关信息等
下面可以根据上面的描述,我们来做一个简单的Demo实现上述流程
1.提供XML的插件配置
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="146dp"
android:minHeight="72dp"
android:updatePeriodMillis="1800000"
android:initialLayout="@layout/widget"
>
</appwidget-provider>
注:android:updatePeriodMillis="1800000" 其实这个已经无效了,是出于省电等因素考虑,如果开发人员需要定时更新就需要自己做一个定时器来实现了。
这里有两个属性需要注意:
android:minWidth="146dp"
android:minHeight="72dp"
这两个属性是确定Widget的尺寸,例如4X2、4X1、4X3等尺寸格式,确定插件尺寸的办法是用74乘以占用的格数,然后再减去2。所以上面设置的属性可以看出这个Widget是一个2X1尺寸的Widget。
2.如果你需要几个不同的小插件实例,那么就需要为每一个实例都提供一定的设置,这样就可能需要创建一个配置Activity了。有些插件本来就是基于Activity来做的。
3.创建一个插件提供器
Widget(插件)从本质上其实是处理特定动作(Action)的BroadcastReceiver。可见于插件交互是从onReceive()开始的,我们要做的是在onReceive中将操作委派给其他方法去实现特定的功能,这是开发人员需要实现的。
实现AppWidgetProvider类需要实现以下方法
-
onEnable() 此方法在Widget被创建的时候调用,在这里我们可以做一些Widget的配置操作。这个方法只在第一个Widget实例被添加的时候调用一次。
-
onDisable() 此方发在Widget被删除的时候调用,且仅在所有的Widget实例被删除的时候调用,也就是最后一个Widget实例被删除时候调用。
-
onUpdate()
-
onDelete() 此方法在某一个Widget实例被删除时候调用。
由于Widget并不是在Activity中运行,而是运行在宿主进程中,但是Widget还是要定义和更新其界面,这时起作用的就是RemoteViews类了,他可以加载Widget的布局文件,可以根据布局文件中控件的id来实现对相应控件内容的更新。
例如
//时间更新的方法
public static void updateTimes(Context context,AppWidgetManager appWidgetManager)
{
Calendar calendar = Calendar.getInstance();
int hour = calendar.get(Calendar.HOUR_OF_DAY);
int min = calendar.get(Calendar.MINUTE);
//加载widget布局文件R.layout.widget
RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.widget);
//给timeText控件设置内容
rv.setTextViewText(R.id.timeText, String.valueOf(hour) + ":" + String.valueOf(min));
//更新Widget内容
appWidgetManager.updateAppWidget(appWidgetManager.getAppWidgetIds(new ComponentName ("com.example.demo","com.example.demo.DemoWidgetProvider")), rv);
}
4. 为更新插件添加Service
很多插件包含的不全是静态内容,而是不断的进行更新,通常我们会通过创建Service来为小插件提供内容更新。
5. 为插件配置Anddroid Manifest文件
<receiver
android:name="DemoWidgetProvider"
android:icon="@drawable/ic_launcher">
<intent-filter >
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@layout/widget_provider_info"/>
</receiver>
这里你会发现就类似注册了一个Action为android.appwidget.action.APPWIDGET_UPDATE的广播接收器,
<meta-data>标记引用了一个存储在XML资源目录中的小插件配置文件。