萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 桌面 Widget 開發實戰:打造即時更新的時間日期元件

前言

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

時間日期 Widget 效果圖

核心架構:AppWidgetProvider

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 被移除時觸發,適合釋放全域資源
    }
}

實現每分鐘精準更新:onUpdate + Service + AlarmManager

系統預設 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。

AndroidManifest.xml 完整宣告

<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 外觀與尺寸。

Widget 設定檔:res/xml/time_widget_config.xml

<?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" />
屬性說明
initialLayoutWidget 初始顯示的佈局檔 (res/layout/)。
minWidth/minHeight最小寬高(單位 dp)。計算公式:70 × 格數 - 30 (Android 4.0+)。
updatePeriodMillis系統自動更新週期(毫秒)。設 0 表示不使用系統更新,改用自訂 Alarm。

背景更新 Service:UpdateService

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 長駐。
  • 多 Widget 實例:onUpdate 的 appWidgetIds 陣列包含所有同類 Widget ID,迴圈逐一更新。
  • 清理 Alarm:在 onDeleted / onDisabled 中呼叫 alarm.cancel(pendingIntent) 避免洩漏。

總結

掌握 AppWidgetProvider 生命週期、AlarmManager 精準排程、RemoteViews 跨進程 UI 更新、XML 與 Manifest 設定,即可開發出流暢、省電、功能豐富的桌面 Widget。本文的時間日期 Widget 只是起點,同樣架構可延伸至天氣、行事曆、音樂控制等場景。

copyright © 萬盛學電腦網 all rights reserved