桌面 Widget (App Widget) 是 Android 獨特的輕量級互動形式,讓使用者無需開啟 App 即可在桌面獲取資訊。本文以開發「時間日期 Widget」為例,完整解析 AppWidgetProvider、AlarmManager 定時更新、Service 背景更新、XML 設定檔與 Manifest 宣告等核心機制。

AppWidgetProvider 繼承自 BroadcastReceiver,是 Widget 的大腦,接收系統廣播並觸發更新。主要回呼方法:
public class WidgetProvider extends AppWidgetProvider {
private static final String TAG = "WidgetProvider";
@Override
public void onReceive(Context context, Intent intent) {
super.onReceive(context, intent); // 必須呼叫父類別
}
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
// 核心:每次更新週期到期、使用者新增 Widget、裝置重開機時觸發
// 這裡啟動 Service + AlarmManager 實現每分鐘更新
}
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
// 使用者移除 Widget 時觸發,適合清理資源、取消 Alarm
}
@Override
public void onEnabled(Context context) {
// 首個同類 Widget 被新增時觸發(僅一次),適合初始化全域資源
}
@Override
public void onDisabled(Context context) {
// 最後一個同類 Widget 被移除時觸發,適合釋放全域資源
}
}
系統預設 android:updatePeriodMillis 最小 30 分鐘,無法滿足時鐘需求。解決方案:在 onUpdate 中啟動 Service,並用 AlarmManager.setRepeating() 每 60 秒觸發一次。
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
Intent intent = new Intent(context, UpdateService.class);
PendingIntent pendingIntent = PendingIntent.getService(context, 0, intent, 0);
AlarmManager alarm = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
// RTC:實時鐘時間,觸發後不喚醒裝置;每 60 秒重複
alarm.setRepeating(AlarmManager.RTC, System.currentTimeMillis(),
60 * 1000, pendingIntent);
}
注意:Android 5.1+ setRepeating 為非精確模式;若需極高精度,可改用 setExactAndAllowWhileIdle 配合 JobScheduler 或 WorkManager。
<application ...>
<!-- AppWidgetProvider 接收器 -->
<receiver android:name=".WidgetProvider"
android:label="@string/app_name_timewidget">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/time_widget_config" />
</receiver>
<!-- 背景更新 Service -->
<service android:name=".UpdateService" />
</application>
android.appwidget.action.APPWIDGET_UPDATE:系統更新廣播,必要動作。meta-data 指向 res/xml/time_widget_config.xml,定義 Widget 外觀與尺寸。<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="https://schemas.android.com/apk/res/android"
android:initialLayout="@layout/time_widget_layout"
android:minWidth="286dp"
android:minHeight="142dp"
android:updatePeriodMillis="0" />
| 屬性 | 說明 |
|---|---|
initialLayout | Widget 初始顯示的佈局檔 (res/layout/)。 |
minWidth/minHeight | 最小寬高(單位 dp)。計算公式:70 × 格數 - 30 (Android 4.0+)。 |
updatePeriodMillis | 系統自動更新週期(毫秒)。設 0 表示不使用系統更新,改用自訂 Alarm。 |
public class UpdateService extends Service {
@Override
public int onStartCommand(Intent intent, int flags, int startId) {
// 1. 取得當前時間、格式化字串
// 2. 建立 RemoteViews 更新 Widget UI
// 3. 呼叫 AppWidgetManager.updateAppWidget()
return START_NOT_STICKY; // 任務完成後不重建
}
@Nullable
@Override
public IBinder onBind(Intent intent) { return null; }
}
RemoteViews 是跨進程 UI 更新的關鍵,僅支援有限的 View 與屬性(TextView、ImageView、ViewFlipper 等),佈局需簡單且可序列化。
AlarmManager.RTC 而非 RTC_WAKEUP,避免喚醒 CPU;配合 WorkManager 排程可延遲任務。onStartCommand 回傳 START_NOT_STICKY,避免 Service 長駐。onUpdate 的 appWidgetIds 陣列包含所有同類 Widget ID,迴圈逐一更新。onDeleted / onDisabled 中呼叫 alarm.cancel(pendingIntent) 避免洩漏。掌握 AppWidgetProvider 生命週期、AlarmManager 精準排程、RemoteViews 跨進程 UI 更新、XML 與 Manifest 設定,即可開發出流暢、省電、功能豐富的桌面 Widget。本文的時間日期 Widget 只是起點,同樣架構可延伸至天氣、行事曆、音樂控制等場景。