android 桌面widget开发
widget开发以桌面日历widget为例：
在这个例子中主要分为四个内容：
①、继承AppWidgetProvider类，命名为CalendarWidgetProvider，在该类中完成接收接收广播、启动更新时间的服务、更新widget显示。
②、在AndroidManifest.xml中声明广播接收类，和相应的action。
③、在res下创建xml文件夹，并在其中创建AppWidgetProviderInfo数据元的xml文件。在该xml文件中主要设定Widget大小和更新时间，由于系统默认是30分钟更新且设定小于30分钟更新不会生效，所以在CalendarWidgetProvider采用接收系统时间改变的广播用于更新Widget。
④、定义用于更新时间的Service类UpdateService，该类继承了Service，该服务中主要完成发送time_ticker广播。
⑤、定义一个用于获得日期和时间的工具类。
首先定义一个继承AppWidgetProvider的类CalendarWidgetProvider，AppWidgetProvider类是BroadcastReceiver的子类，所以它实质上是一个广播接收者。在CalendarWidgetProvider类中，主要完成三个功能：启动发送time_ticker的广播的服务，接收广播，更新widget显示。在该类中，首先应override onReceive() 方法，用于接收广播，在桌面日历应用中应接收四种广播，该广播都在AndroidManifest.xml文件中注册。
<receiver
android:name="com.nwd.android.calendarwidget.CalendarWidgetProvider"
android:enabled="true"
android:icon="@drawable/ic_launcher" >
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/calendarwidgetinfo" />
<intent-filter>
<action android:name="android.intent.action.DATE_CHANGED" />
<action android:name="android.intent.action.TIME_SET" />
<action android:name="com.nwd.android.calendarwidget.timetick" />
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
</receiver>
<
receiver
>
中的name标志了接收广播的类
：
CalendarWidgetProvider
。
<
meta-data>adnroid:resource
指定了widget的大小等特性。calendardrawwidgetinfo文件如下：
<?xml version="1.0" encoding= "UTF-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="200dp"
android:minHeight="100dp"
android:updatePeriodMillis="0"
android:initialLayout="@layout/main" >
</appwidget-provider>
CalendarWidgetProvider
类如下
：
public class CalendarWidgetProvider extends AppWidgetProvider {
// 系统日期改变接收的广播的action
private static final String DATE_CHANGED = Intent.ACTION_DATE_CHANGED ;
// 系统时间改变接收的广播的action
private static final String TIME_CHANGED = Intent.ACTION_TIME_CHANGED ;
// 接收UpdateService转发的TIME_TICK的广播
private static final String TIME_TICK = "com.nwd.android.calendarwidget.timetick" ;
// public static String TAG = "CalendarWidgetProvider";
private RemoteViews mRv;
public static final boolean DEBUG = true;
private static final JLog LOG = new JLog("CalendarWidgetProvider" ,
CalendarWidgetProvider.DEBUG, JLog. TYPE_DEBUG);
@Override
public void onEnabled(Context context) {
// TODO Auto-generated method stub
super.onEnabled(context);
LOG.print("CalendarWidgetProvider.onEnabled()" );
context.startService( new Intent(context, UpdateService.class));
}
/**
* 接收到广播根据相应的action转换相应的View
*/
@Override
public void onReceive(Context context, Intent intent) {
// TODO Auto-generated method stub
super.onReceive(context, intent);
String action = intent.getAction();
LOG.print("CalendarWidgetProvider.onReceive() " + action);
if (mRv == null) {
mRv = new RemoteViews(context.getPackageName(), R.layout.main);
}
DateUtil util = DateUtil. getInstance(context);
// 获取日期字符串
String date = util.getDate();
// 获取星期几
String weekDay = util.getWeekDay();
// 接收到DATE_CHANGED的系统广播
if (DATE_CHANGED .equals(action)) {
LOG.print("CalendarWidgetProvider.onReceive() " + date);
updateDate( mRv, weekDay, date);
LOG.print(date);
}
// 接收到TIME_CHANGED的系统广播
if (TIME_CHANGED .equals(action)) {
LOG.print("CalendarWidgetProvider.onReceive() " + date);
updateDate( mRv, weekDay, date);
updateTime(context, mRv);
LOG.print(date);
}
// 接收到TIME_TICK的系统广播
if (TIME_TICK .equals(action)) {
updateTime(context, mRv);
updateDate( mRv, weekDay, date);
}
AppWidgetManager appWidgetManager = AppWidgetManager
. getInstance(context);
int[] appIds = appWidgetManager.getAppWidgetIds(new ComponentName(
context, CalendarWidgetProvider.class));
appWidgetManager.updateAppWidget(appIds, mRv);
LOG.print(date);
}
/**
* 更新widget上面所有的view
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
// TODO Auto-generated method stub
super.onUpdate(context, appWidgetManager, appWidgetIds);
for (int i = 0; i < appWidgetIds.length; i++) {
if (mRv == null) {
mRv = new RemoteViews(context.getPackageName(), R.layout.main);
}
// Intent intent = new Intent(context, UpdateService.class);
// PendingIntent pendingIntent = PendingIntent.getService(context, 0,
// intent, 0);
DateUtil util = DateUtil. getInstance(context);
String date = util.getDate();
String weekDay = util.getWeekDay();
updateTime(context, mRv);
updateDate( mRv, weekDay, date);
// 设置更新时间
// AlarmManager alarm = (AlarmManager) context
// .getSystemService(Context.ALARM_SERVICE);
// alarm.setRepeating(AlarmManager.RTC_WAKEUP,
// System.currentTimeMillis(), 60 * 1000, pendingIntent);
//设置widget的点击事件，当点击时进入Calendar
Intent LaunchCalendarIntent = new Intent();
LaunchCalendarIntent.setClassName( "com.android.calendar",
"com.android.calendar.LaunchActivity" );
PendingIntent luanchPendingIntent = PendingIntent.getActivity(
context, 0, LaunchCalendarIntent, 0);
mRv.setOnClickPendingIntent(R.id.time_linearlayout,
luanchPendingIntent);
appWidgetManager.updateAppWidget(appWidgetIds, mRv);
LOG.print(date);
}
}
// 更新widget上面的日期
public void updateDate(RemoteViews rv, String weekDay, String date) {
rv.setTextViewText(R.id. date, "" + date);
rv.setTextViewText(R.id. week, "" + weekDay);
}
// 更新widget上面的时间
public void updateTime(Context context, RemoteViews rv) {
DateUtil util = DateUtil. getInstance(context);
int hour = util.getHour();
int minute = util.getMinute();
if (!util.is24()) {
if (hour > 12) {
hour -= 12;
}
if (hour == 0) {
hour = 12;
}
}
if (minute < 10) {
rv.setTextViewText(R.id. minute, "0" + minute);
} else {
rv.setTextViewText(R.id. minute, "" + minute);
}
rv.setTextViewText(R.id. hour, "" + hour);
}
}
在onEnabled()方法中，启动服务
UpdateService，该服务主要用来广播time_tick。onReceive() 方法根据不同的广播改变widget的显示。upDate()方法用来完成widget的更新，同时，在该方法中设置了整个widget的点击事件，当widget被点击时，会调用系统的日历，进入日历的显示界面。
在该widget项目中还定义了两个类，上面提到的的服务UpdateService和一个工具类DateUtil。两个类的作用分别是：发time_tick广播，获取当前日期时间的工具。
UpdateService
类如下：
public class UpdateService extends Service {
public static final boolean DEBUG = true;
private static final JLog LOG = new JLog("UpdateService" , UpdateService.DEBUG , JLog.TYPE_DEBUG);
private BroadcastReceiver receiver;
@Override
public IBinder onBind(Intent arg0) {
// TODO Auto-generated method stub
return null ;
}
/**
* 创建服务并动态注册系统的ACTION_TIME_TICK服务
*/
@Override
public void onCreate() {
// TODO Auto-generated method stub
super.onCreate();
LOG.print("UpdateService.onCreate()" );
// 实例化接收系统ACTION_TIME_TICK的BroadcastReceiver
receiver = new BroadcastReceiver(){
private static final String ACTION_TIME_TICK = Intent.ACTION_TIME_TICK ;
@Override
public void onReceive(Context context, Intent intent) {
// TODO Auto-generated method stub
LOG.print("UpdateService.onReceive()" );
if(intent.getAction().equals(ACTION_TIME_TICK)){//注意：使用的是equals方法，不是"=="
Intent tmp = new Intent();
tmp.setAction("com.nwd.android.calendarwidget.timetick" );
LOG.print("TIME_TICK" );
context.sendBroadcast(tmp);
}
}
};
this.registerReceiver(receiver , new IntentFilter(Intent.ACTION_TIME_TICK ));
}
/**
* 在onDestroy()方法里面重启UpdateService
*/
@Override
public void onDestroy() {
// TODO Auto-generated method stub
super.onDestroy();
//this.unregisterReceiver(receiver);
Intent intent = new Intent();
intent.setClass( this, UpdateService.class);
startService(intent);
}
@Override
public int onStartCommand(Intent intent, int flags, int startId) {
// TODO Auto-generated method stub
return START_STICKY ;
}
}
DateUtil
类如下：
public class DateUtil {
private Context context;
// 记录系统时间格式(分为12小时制和24小时制)
private SimpleDateFormat formatter;
private static DateUtil instance;
/**
* 生成单例模型并初始化系统时间格式
* @param context
*/
private DateUtil(Context context){
this.context = context;
formatter = new SimpleDateFormat("MM/dd");
}
public boolean is24(){
return DateFormat.is24HourFormat( context);
}
/**
* 获取时间的小时数，默认为24小时制
* @return
*/
public int getHour(){
Calendar c = Calendar. getInstance();
return c.get(Calendar.HOUR_OF_DAY);
}
/**
* 获取时间的分钟数
* @return
*/
public int getMinute(){
Calendar c = Calendar. getInstance();
return c.get(Calendar.MINUTE);
}
/**
* 获取当前年份
* @return
*/
public int getYear(){
Calendar c = Calendar. getInstance();
return c.get(Calendar.YEAR);
}
/**
* 获取当前月份
* @return
*/
public int getMonth(){
Calendar c = Calendar. getInstance();
return c.get(Calendar.MONTH);
}
/**
* 获取所在月的天数
* @return
*/
public int getDayOfMonth(){
Calendar c = Calendar. getInstance();
return c.get(Calendar.DAY_OF_MONTH);
}
/**
* 重新设置系统时间格式
*/
public void setDateFormat(SimpleDateFormat formatter){
this.formatter = formatter;
}
public static DateUtil getInstance(Context context){
if(instance == null){
instance = new DateUtil(context);
return instance ;
} else{
return instance ;
}
}
/**
* 获取系统日期
* @return 返回格式如2014/6/24
*/
public String getDate(){
Date curDate = new Date(System.currentTimeMillis());
String date = formatter.format(curDate);
return date;
}
/**
*
* @return 当前日期是星期几
*/
public String getWeekDay(){
String weekDay = "";
Calendar c = Calendar. getInstance();
int day = c.get(Calendar.DAY_OF_WEEK);
String weekdays[] = context.getResources().getStringArray(R.array.weekdays);
switch(day){
case 1:
weekDay = weekdays[0];
break;
case 2:
weekDay = weekdays[1];
break;
case 3:
weekDay = weekdays[2];
break;
case 4:
weekDay = weekdays[3];
break;
case 5:
weekDay = weekdays[4];
break;
case 6:
weekDay = weekdays[5];
break;
case 7:
weekDay = weekdays[6];
break;
default:
}
return weekDay;
}
}
最后Layout布局文件如下：
<?xml version="1.0" encoding= "utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/time_linearlayout"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingBottom="@dimen/activity_vertical_margin"
android:background="@android:color/holo_blue_bright"
android:orientation="vertical" >
<LinearLayout
android:layout_width="match_parent"
android:layout_height="129dp"
android:orientation="horizontal" >
<TextView
android:id="@+id/hour"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="60dp"
android:layout_gravity="center_vertical"
android:text="@string/hour"
android:textColor="@android:color/white"
android:textSize="60sp" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center"
android:text="@string/semicolon"
android:textColor="@android:color/white"
android:textSize="60sp" />
<TextView
android:id="@+id/minute"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center"
android:text="@string/minute"
android:textColor="@android:color/white"
android:textSize="60sp" />
</LinearLayout >
<LinearLayout
android:layout_width="match_parent"
android:layout_height="43dp"
android:orientation="horizontal" >
<TextView
android:id="@+id/week"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:layout_marginLeft="20dp"
android:text="@string/week"
android:textColor="@android:color/white"
android:textSize="25sp" />
<TextView
android:id="@+id/date"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="95dp"
android:text="@string/date"
android:textColor="@android:color/white"
android:textSize="25sp" />
</LinearLayout >
</LinearLayout>
widget显示的效果