最近需要编写一个日期时间的桌面Widget用来关联日历程序,以前很少写桌面Widget。对这方面技术不是很熟悉,今天花时间重新整理了一下,顺便把编写一个简单时间日期程序过程记录下来。
桌面Widget其实就是一个显示一些信息的工具(现在也有人开发了一些有实际操作功能的widget。例如相机widget,可以直接桌面拍照)。不过总的来说,widget主要功能就是显示一些信息。我们今天编写一个很简单的作为widget,显示时间、日期、星期几等信息。需要显示时间信息,那就需要实时更新,一秒或者一分钟更新一次。
这个时间Widget我是参考(Android应用开发揭秘)书里面的一个demo例子做的,只是把功能和界面完善了一下。下面是这次的效果图:
1、继承AppWidgetProvider
我们编写的桌面Widget需要提供数据更新,这里就需用用到AppWidgetProvider,它里面有一些系统回调函数。提供更新数据的操作。AppWidgetProvider是BrocastReceiver的之类,也就是说它其实本质是一个广播接收器。下面我们看看AppWidgetProvider的几个重要的回调方法:
class WidgetProvider extends AppWidgetProvider
{
private static final String TAG="mythou_Widget_Tag";
// 没接收一次广播消息就调用一次,使用频繁
public void onReceive(Context context, Intent intent)
{
Log.d(TAG, "mythou--------->onReceive");
super.onReceive(context, intent);
}
// 每次更新都调用一次该方法,使用频繁
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)
{
Log.d(TAG, "mythou--------->onUpdate");
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
// 没删除一个就调用一次
public void onDeleted(Context context, int[] appWidgetIds)
{
Log.d(TAG, "mythou--------->onDeleted");
super.onDeleted(context, appWidgetIds);
}
// 当该Widget第一次添加到桌面是调用该方法,可添加多次但只第一次调用
public void onEnabled(Context context)
{
Log.d(TAG, "mythou--------->onEnabled");
super.onEnabled(context);
}
// 当最后一个该Widget删除是调用该方法,注意是最后一个
public void onDisabled(Context context)
{
Log.d(TAG, "mythou--------->onDisabled");
super.onDisabled(context);
}
}
其中我们比较常用的是onUpdate和onDelete方法。我这里刷新时间使用了一个Service,因为要定时刷新服务,还需要一个Alarm定时器服务。下面给出我的onUpdate方法:
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)
{
super.onUpdate(context, appWidgetManager, appWidgetIds);
Time time = new Time();
time.setToNow();
//使用Service更新时间
Intent intent = new Intent(context, UpdateService.class);
PendingIntent pendingIntent = PendingIntent.getService(context, 0, intent, 0);
//使用Alarm定时更新界面数据
AlarmManager alarm = (AlarmManager)context.getSystemService(Context.ALARM_SERVICE);
alarm.setRepeating(AlarmManager.RTC, time.toMillis(true), 60*1000, pendingIntent);
}
2、AndroidManifest.xml配置
<application
android:icon="@drawable/icon"
android:label="@string/app_name">
<!-- AppWidgetProvider的注册 mythou-->
<receiver
android:label="@string/app_name_timewidget"
android:name="com.owl.mythou.TimeWidget">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"></action>
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/time_widget_config">
</meta-data>
</receiver>
<!-- 更新时间的后台服务 mythou-->
<service android:name="com.owl.mythou.UpdateService"></service>
</application>
AndroidManifest主要是配置一个receiver,因为AppWidgetProvider就是一个广播接收器。另外需要注意的是,里面需要提供一个action,这个是系统的更新widget的action。还有meta-data里面需要指定widget的配置文件。这个配置文件,需要放到res/xml目录下面,下面我们看看time_widget_config.xml的配置
3、appWidget配置:
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:initialLayout="@layout/time_widget_layout"
android:minWidth="286dip"
android:minHeight="142dip"
android:updatePeriodMillis="0">
</appwidget-provider>
•android:initialLayout 指定界面布局的Layout文件,和activity的Layout一样
•android:minWidth 你的widget的最小宽度。根据Layout的单元格计算(72*格子数-2)
•android:minHeigh 你的widget的最小高度。计算方式和minwidth一样。(对这个不了解可以看我Launcher分析文章)
•android:updatePerioMillis 使用系统定时更新服务,单位毫秒。
这里需要说明android:updatePerioMillis的问题,系统为了省电,默认是30分钟更新一次,如果你设置的值比30分钟小,系统也是30分钟才会更新一次。对于我们做时间Widget来说,显然不靠谱。所以只能自己编写一个Alarm定时服务更新。
4、更新Widget的Service服务
新闻热点
疑难解答
图片精选