萬盛學電腦網

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

從零構建 Android 桌面電池 Widget:完整開發實戰與原理剖析

近期突發奇想,決定開發一款桌面電池 Widget:實用、工程量可控、又能深入學習 AppWidget 機制,一舉三得。經多方資料整合與調試,最終實現預期效果。

功能演示與效果預覽

  • 桌面掛件: 長按桌面 → Widgets 即可添加,機器人造型直觀顯示電量百分比。
  • 充電動畫: 接通電源時機器人周圍星光閃爍,斷電自動熄滅。
  • 詳情交互: 單擊機器人彈出電池詳細資訊(電壓、溫度、健康度等),再次點擊任意處關閉。

工程架構設計

專案包含兩大核心模組:

  1. AppWidget 模組: 負責桌面掛件的繪製、週期性更新、點擊事件分發。
  2. Activity 模組: 實現點擊後彈出的電池詳情頁面。

核心代碼實現:NewBatteryWidget.java

package com.ritterliu.newBatteryWidget;

import android.app.AlarmManager;
import android.app.PendingIntent;
import android.app.Service;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.BroadcastReceiver;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.IBinder;
import android.widget.RemoteViews;

public class NewBatteryWidget extends AppWidgetProvider {
    private static int currentBatteryLevel;
    private static int currentBatteryStatus;

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

        // 1. 啟動後台更新服務
        context.startService(new Intent(context, UpdateService.class));

        // 2. 設置點擊跳轉詳情頁
        Intent activityIntent = new Intent(context, NewBatteryInfoActivity.class);
        PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, activityIntent, 0);
        RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.newrelativelayout);
        views.setOnClickPendingIntent(R.id.imageView, pendingIntent);
        appWidgetManager.updateAppWidget(appWidgetIds, views);
    }

    // 內部 Service:定時輪詢電池狀態並推送廣播
    public static class UpdateService extends Service {
        private Bitmap robotBitmap;
        private BroadcastReceiver batteryReceiver = new BroadcastReceiver() {
            @Override
            public void onReceive(Context context, Intent intent) {
                currentBatteryLevel = intent.getIntExtra("level", 0);
                currentBatteryStatus = intent.getIntExtra("status", 0);
                // 更新 RemoteViews 刷新 UI(此處省略具體繪製邏輯)
            }
        };
        // ... onBind、onCreate、onDestroy 中註冊/註銷接收器、設置 AlarmManager 定時觸發
    }
}

關鍵技術點總結

  • RemoteViews 跨進程 UI 更新: AppWidget 運行在 Launcher 進程,只能透過 RemoteViews 操作有限 View 集合。
  • AlarmManager 精準定時: 結合 Service 實現低功耗週期性採樣,避免常駐後台消耗資源。
  • 電池廣播監聽: 動態註冊 ACTION_BATTERY_CHANGED(僅支持動態註冊),即時獲取電量、狀態、健康度等參數。
  • PendingIntent 實現跳轉: 點擊 Widget 啟動 Activity,保持輕量級交互。

完整源碼已開源於 GitHub,歡迎 Star & Fork 交流改進。

copyright © 萬盛學電腦網 all rights reserved