Widget、Timer、TimerTask、Handler、Message的综合使用


每一个Widget实际上就是一个BroadcastReceive，它们通过XML文件来描述Widget的细节。AppWidget框架通过Broadcast intents和Widget通信。Widget在更新组件与普通的android应用程序有些本质的不同。android应用程序在更新组件是会首先获得要更新组件的对象，然后直接对组件更新。而在Widget中并不能直接获得Widget中组件的对象，要想更新组件，必须要使用RemoteViews作为代理来更新Widget中的组件。

下面来看一下开发App Widget的具体步骤。

1.建立一个XML布局文件，在该布局文件中定义在Widget中显示的组件，但要注意，Widget并不支持所有的android组件。只能在Widget中使用如下组件类：

1）用于布局的组件类

FrameLayout

LinearLayout

RelativeLayout

2）用于开发界面的组件类

AnalogClock

Button

Chronometer  计时器

ImageButton

ImageView

ProgressBar

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="280dp"
android:layout_height="130dp"
android:background="@drawable/frame"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context="com.example.clockwidget.MainActivity" >

<TextView
android:id="@+id/main_time"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:textSize="30sp"
android:text="@string/hello_world" />

</RelativeLayout>


2.创建Widget描述文件。该文件时XML格式，必须放在res/xml目录中。基本格式如下：

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="300dp"
android:minHeight="150dp"
android:initialLayout="@layout/activity_main"   />

3.建立Widget类，该类必须从AppWidgetProvider类继承（AppWidgetProvider是BroadcastReceiver的子类，因此,Widget类可以接收广播消息）。在AppWidgetProvider中定义了几个接收Widget各种事件的方法，其中onUpdate是最常用的方法。在Widget加载时或到了android：updateReriondMillis属性指定的时间，系统会调用onUpdate方法。开发人员可以在该方法中更新Widget中的组件。

for (int i = 0; i < appWidgetIds.length; i++) {
int appWidgetId=appWidgetIds[i];
//加载对应的布局类
RemoteViews views=new RemoteViews(context.getPackageName(), R.layout.activity_main);
//设置时间转化格式
SimpleDateFormat sdf=new SimpleDateFormat("HH:mm:ss");
views.setTextViewText(R.id.main_time, sdf.format(new Date()));
appWidgetManager.updateAppWidget(appWidgetId, views);
}

其中，for循环，是数据放进去。但是，SDK1.5之后此方法android:updatePeriodMillis就失效了
，要自己创建service更新。

Timer timer=new Timer();
private TimerTask tt=new TimerTask() {

@Override
public void run() {
Message message=Message.obtain();
myHandler.sendMessage(message);
}
};
private Handler myHandler=new Handler(){
public void handleMessage(android.os.Message msg) {
Log.d("lhm", "appwidget的长度是"+appWidgetIds.length);
for (int i = 0; i < appWidgetIds.length; i++) { int appWidgetId=appWidgetIds[i]; //加载对应的布局类 RemoteViews views=new RemoteViews(context.getPackageName(), R.layout.activity_main); //设置时间转化格式 SimpleDateFormat sdf=new SimpleDateFormat("HH:mm:ss"); views.setTextViewText(R.id.main_time, sdf.format(new Date())); appWidgetManager.updateAppWidget(appWidgetId, views); }
};
};使用schedule方法

//设置定时器，每隔1s发送
timer.schedule(tt, 0, 1000);

4.这是最后一步，也是最关键的一步。就是在AndroidManifest.xml文件中定义一个receiver，以便系统和Widget进行通信，下面是一个典型的receiver。

<receiver
android:name="com.example.clockwidget.TimerService"
android:label="MyUsefulClock" >
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/clockwidget" />
<intent-filter >
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
</intent-filter>
</receiver>

整体代码

在drawable-mdpi文件夹添加图片frame.png



时钟布局layout.xml

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="280dp"
android:layout_height="130dp"
android:background="@drawable/frame"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context="com.example.clockwidget.MainActivity" >

<TextView
android:id="@+id/main_time"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:textSize="30sp"
android:textColor="#000000" />

</RelativeLayout>

在res/xml的文件夹添加clockwidget.xml

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="300dp"
android:minHeight="150dp"
android:initialLayout="@layout/activity_main"
android:previewImage="@drawable/frame" />

在AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.clockwidget"
android:versionCode="1"
android:versionName="1.0" >

<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="21" />

<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<receiver
android:name="com.example.clockwidget.TimerService"
android:label="MyUsefulClock" >
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/clockwidget" />
<intent-filter >
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
</intent-filter>
</receiver>
</application>

</manifest>

package com.example.clockwidget;

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Timer;
import java.util.TimerTask;

import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.os.Handler;
import android.os.Message;
import android.util.Log;
import android.widget.RemoteViews;

public class TimerService extends AppWidgetProvider {
private Context context;
private Timer timer=new Timer();
private int[] appWidgetIds;
private AppWidgetManager appWidgetManager;
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
// TODO Auto-generated method stub
super.onUpdate(context, appWidgetManager, appWidgetIds);
this.context=context;
this.appWidgetIds=appWidgetIds;
this.appWidgetManager=appWidgetManager;
//设置定时器，每隔1s发送
timer.schedule(tt, 0, 1000);}
private TimerTask tt=new TimerTask() {

@Override
public void run() {
Message message=Message.obtain();
myHandler.sendMessage(message);
}
};
private Handler myHandler=new Handler(){
public void handleMessage(android.os.Message msg) {
Log.d("lhm", "appwidget的长度是"+appWidgetIds.length);
for (int i = 0; i < appWidgetIds.length; i++) {
int appWidgetId=appWidgetIds[i];
//加载对应的布局类
RemoteViews views=new RemoteViews(context.getPackageName(), R.layout.activity_main);
//设置时间转化格式
SimpleDateFormat sdf=new SimpleDateFormat("HH:mm:ss");
views.setTextViewText(R.id.main_time, sdf.format(new Date()));
appWidgetManager.updateAppWidget(appWidgetId, views);
}
};
};
}