android桌面時鐘小控件開發記錄

所謂桌面小控件，就是能之間顯示在Android系統桌面的小程序。

桌面小控件的實現是基於Broadcast的形式實現的，因此，每一個桌面小控件都對應於一個BroadcastReceiver類。Android系統提供了一個AppWidgetProvider類（它就是BroadcastReceiver的子類），這個類很關鍵，你在寫桌面小控件時只需繼承這個類就行。繼承了AppWidgetProvider類之後，你可以根據自己的需要覆蓋它的不同的生命週期的方法，來達到自己的目的。AppWidgetProvider類的主要提供如下不同生命週期的方法：

void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds) { }
// 這個方法字面意思是負責更新桌面小控件，但貌似只有在小控件被用戶放到桌面上時被調用了一次，讀者可以自己通過輸出Log來測試
// 實現桌面控件是通常都會考慮重寫該方法 

void onDeleted(Context context, int[] appWidgetIds)
// 在小控件被刪除時調用該方法

一般來說，開發桌面小控件只需要定義一個AppWidgetProvider的子類，並重新寫它的pnUpdate方法即可。

下面上代碼，有不足之處請指教：

DesktopClock.java，這個類繼承了上面說的AppWidgetProvider類（記住它是繼承自BroadcastReceiver類）：

package org.ls;

import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;

public class DesktopClock extends AppWidgetProvider {

	@Override
	public void onUpdate(Context context, AppWidgetManager appWidgetManager,
			int[] appWidgetIds) {

		Log.e("appwidget", "--update--");
		// 創建RemoteViews對象
		RemoteViews views = new RemoteViews(context.getPackageName(),
				R.layout.main);
		views.setImageViewResource(R.id.double_dot,
				R.drawable.blue_modern_middle);
		// 將刷新UI的service的必要的數據設置好（此處沒有使用Bundle傳遞數據）
		UpdateUIService.appWidgetManager = appWidgetManager;
		UpdateUIService.context = context;
		UpdateUIService.remoteViews = views;
		// 啓動刷新UI的Service
		Intent intent = new Intent(context, UpdateUIService.class);
		context.startService(intent);
	}

	// 在小控件被刪除時調用該方法停止Service
	@Override
	public void onDeleted(Context context, int[] appWidgetIds) {
		super.onDeleted(context, appWidgetIds);
		Log.e("appwidget", "--deleted--");
		Intent intent = new Intent(context, UpdateUIService.class);
		context.stopService(intent);
	}
}

UpdateUIService.java，這個類繼承自Service類，是一個後臺運行的服務，它的主要職責是在它裏面有一個動態註冊的BroadcastReceiver的實例（也即調用了Context裏面的registerReceiver( )方法註冊的一個BroadcastReceiver的實例，而不是在xml中註冊），負責監聽系統的時間變化的廣播，然後更新小控件的UI。

還有一點要注意的是，讀者可能會有這樣的疑問，不是說AppWidgetProvider本身就是一個BroadcastReceiver嗎，爲什麼不讓它直接監聽系統的時間變化的廣播呢？注意，雖然AppWidgetProvider本身就是一個BroadcastReceiver，但是它是一個“分化”了的BroadcastReceiver，不能再監聽其它的系統廣播了。一般的BroadcastReceiver是這樣的：每次系統的Broadcast事件發生後，系統就會創建對應的BroadcastReceiver的實例，並自動觸發它的onReceive( )方法，onReceive( )執行完後，BroadcastReceiver的實例就會被銷燬。但是這個“分化”了的BroadcastReceiver——AppWidgetProvider顯然做不到這樣，也即系統嘗試再創建它的實例時會發生異常，因此不能用它之間監聽系統的Broadcast了。

那我爲什麼不在AppWidgetProvider裏面新動態註冊一個BroadcastReceiver，而是要新開一個Service呢？筆者也曾經嘗試過這樣做，但是當調用registerReceiver( )方法時編譯通不過，此外，如果不在AppWidgetProvider裏面新開一個Service，AppWidgetProvider並不是會一直在後臺運行的，執行完onUpdate方法後就會退出執行，因此最好的方法就是在onUpdate裏面新開一個Service。

package org.ls;

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

import android.app.Service;
import android.appwidget.AppWidgetManager;
import android.content.BroadcastReceiver;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.os.IBinder;
import android.util.Log;
import android.widget.RemoteViews;

public class UpdateUIService extends Service {

	private SimpleDateFormat df = new SimpleDateFormat("HHmmss");

	public static Context context;
	public static AppWidgetManager appWidgetManager;
	public static RemoteViews remoteViews;
	// 數字圖片的ID
	private int[] numberIcon = new int[] { R.drawable.blue_modern_zero,
			R.drawable.blue_modern_one, R.drawable.blue_modern_two,
			R.drawable.blue_modern_three, R.drawable.blue_modern_four,
			R.drawable.blue_modern_five, R.drawable.blue_modern_six,
			R.drawable.blue_modern_seven, R.drawable.blue_modern_eight,
			R.drawable.blue_modern_nine };
	// 用於顯示數字的ImageView的ID
	private int[] numberView = new int[] { R.id.hour01, R.id.hour02,
			R.id.minute01, R.id.minute02 };

	// 覆蓋基類的抽象方法
	@Override
	public IBinder onBind(Intent intent) {
		return null;
	}

	// 在本服務創建時將監聽系統時間的BroadcastReceiver註冊
	@Override
	public void onCreate() {
		super.onCreate();
		Log.e("service", "--service created--");
		IntentFilter intentFilter = new IntentFilter();
		intentFilter.addAction(Intent.ACTION_TIME_TICK); // 時間的流逝
		intentFilter.addAction(Intent.ACTION_TIME_CHANGED); // 時間被改變，人爲設置時間
		registerReceiver(boroadcastReceiver, intentFilter);
	}

	@Override
	public int onStartCommand(Intent intent, int flags, int startId) {
		Log.e("service", "--service started--");
		updateUI(); // 開始服務前先刷新一次UI
		return START_STICKY;
	}

	// 在服務停止時解註冊BroadcastReceiver
	@Override
	public void onDestroy() {
		super.onDestroy();
		unregisterReceiver(boroadcastReceiver);
	}

	// 用於監聽系統時間變化Intent.ACTION_TIME_TICK的BroadcastReceiver，此BroadcastReceiver須爲動態註冊
	private BroadcastReceiver boroadcastReceiver = new BroadcastReceiver() {
		@Override
		public void onReceive(Context acontext, Intent intent) {
//			Log.e("time received", "--receive--");
			updateUI();
		}
	};

	// 根據當前時間設置小部件相應的數字圖片
	private void updateUI() {
		String timeString = df.format(new Date());
		int num;
		for (int i = 0; i < numberView.length; i++) {
			num = timeString.charAt(i) - 48;
			remoteViews.setImageViewResource(numberView[i], numberIcon[num]);
		}
		// 將AppWidgetProvider的子類包裝成ComponentName對象
		ComponentName componentName = new ComponentName(context,
				DesktopClock.class);
		// 調用AppWidgetManager將remoteViews添加到ComponentName中
		appWidgetManager.updateAppWidget(componentName, remoteViews);
	}
}

下面是一些xml文件：

佈局文件main.xml：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="horizontal" >

   <ImageView
	android:id="@+id/hour01"  
	android:layout_weight="1"
	android:layout_width="wrap_content" 
	android:layout_height="wrap_content" />
   
   <ImageView
	android:id="@+id/hour02"  
	android:layout_weight="1"
	android:layout_width="wrap_content" 
	android:layout_height="wrap_content" />
   
   <ImageView
	android:id="@+id/double_dot"  
	android:layout_width="wrap_content" 
	android:layout_height="wrap_content" />
   
   <ImageView
	android:id="@+id/minute01"  
	android:layout_weight="1"
	android:layout_width="wrap_content" 
	android:layout_height="wrap_content" />
   
   <ImageView
	android:id="@+id/minute02"  
	android:layout_weight="1"
	android:layout_width="wrap_content" 
	android:layout_height="wrap_content" />

</LinearLayout>

AndroidManifest.xml：

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

    <uses-sdk android:minSdkVersion="10" />

    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        
        <receiver android:name=".DesktopClock"	
			android:label="@string/app_name">
			
			<intent-filter>
				<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
				<category android:name="android.intent.category.DEFAULT" />
			</intent-filter>
			
			<meta-data android:name="android.appwidget.provider"
				android:resource="@xml/appwidget_provider" />

		</receiver>
		
        <service android:name=".UpdateUIService" >
            
        </service>
    
    </application>

</manifest>

用於配置時鐘小控件屬性的appwidget_provider.xml（在AndroidManifest.xml中被引用）：

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider 
	xmlns:android="http://schemas.android.com/apk/res/android" 
	android:minWidth="270px"
	android:minHeight="103px"
	android:updatePeriodMillis="1000"
	android:initialLayout="@layout/main">
</appwidget-provider>

效果圖：同步更新時間，完全與系統時間同步：

歡迎討論。