Android 桌面Widget開發要點解析(時間日期Widget)

總的來說，widget主要功能就是顯示一些信息。我們今天編寫一個很簡單的作為widget，顯示時間、日期、星期幾等信息。需要顯示時間信息，那就需要實時更新，一秒或者一分鐘更新一次  

最近需要編寫一個日期時間的桌面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的配置文件。這個配置文件，需要放到resxml目錄下面，下 面我們看看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服務

復制代碼 代碼如下:
class UpdateService extends Service
{
    @Override
    public void onStart(Intent intent, int startId)
  &nb