PowerManager.WakeLock、goToSleep()、userActivity()PowerManagerService (PMS)、DisplayPowerController、WakeLock 管理、Notifier 回調drivers/android/power.c、wakeup_source、autosleep、suspend/retume 流程| 類型 | 螢幕 | 鍵盤燈 | CPU | 典型場景 |
|---|---|---|---|---|
| PARTIAL_WAKE_LOCK | 關閉 | 關閉 | 運行 | 後台下載、音樂播放、傳感器採集 |
| SCREEN_DIM_WAKE_LOCK | 微亮 | 關閉 | 運行 | 電子書閱讀、導航螢幕常亮但省電 |
| SCREEN_BRIGHT_WAKE_LOCK | 全亮 | 關閉 | 運行 | 視頻播放、遊戲 (已棄用,建議用 FLAG_KEEP_SCREEN_ON) |
| FULL_WAKE_LOCK | 全亮 | 全亮 | 運行 | 極少用,**API 17 棄用** |
// 1. 獲取 PowerManager
PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
// 2. 創建 WakeLock (推薦 PARTIAL_WAKE_LOCK + 具體 Tag)
WakeLock wakeLock = pm.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "MyApp:NetworkSync");
// 3. 可選標誌
// wakeLock.setReferenceCounted(false); // 非引用計數模式,需手動成對 acquire/release
// 4. 獲取鎖
wakeLock.acquire(); // 或 acquire(timeoutMs) 自動釋放
try {
// 執行需保持 CPU 運行的任務
doBackgroundWork();
} finally {
// 5. 必須釋放!否則導致電池耗盡
if (wakeLock.isHeld()) wakeLock.release();
}
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!-- DEVICE_POWER 為系統級權限,普通應用不可用 -->
mWakeLocks (所有)、mPartialWakeLocks、mFullWakeLocks。引用計數模式下,多次 acquire 需同次數 release。userActivity() 重置屏幕關閉定時器,觸發 Notifier.onUserActivity() 更新亮度/喚醒。goToSleep() → suspend() → 通過 ISuspendControl 調用內核 sys/power/state 進入掛起。DisplayPowerController 根據光感、用戶設置、電池電量動態調節背光 PWM。# 申請 PARTIAL_WAKE_LOCK
echo "mylock" > /sys/android_power/acquire_partial_wake_lock
# 申請 FULL_WAKE_LOCK (含螢幕)
echo "mylock" > /sys/android_power/acquire_full_wake_lock
# 釋放
echo "mylock" > /sys/android_power/release_wake_lock
# 請求狀態變更 (standby/wakeup)
echo "standby" > /sys/android_power/request_state
echo "wakeup" > /sys/android_power/request_state
# 讀取當前狀態
cat /sys/android_power/state
// drivers/android/power.c
static LIST_HEAD(g_inactive_locks); // 閒置鎖池
static LIST_HEAD(g_active_partial_wake_locks); // 活躍部分喚醒鎖
static LIST_HEAD(g_active_full_wake_locks); // 活躍完全喚醒鎖
// android_lock_suspend() → 從 inactive 移至 active_partial
// android_lock_suspend_auto_expire() → 定時自動移回 inactive
// android_unlock_suspend() → 移回 inactive
驅動註冊 early_suspend 回調,在系統進入掛起前 (Late Resume 後) 依序調用,用於關閉外設 (LCD、觸摸、傳感器) 省電。Android 5.0+ 逐漸被標準 Linux runtime PM + system suspend 取代。
acquire() 必有對應 release(),使用 try-finally 或 Closeable 包裝。FLAG_KEEP_SCREEN_ON 在 Window 級別聲明。getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)。dumpsys power、adb shell cat /sys/android_power/state、Battery Historian 分析耗電。