当前位置：首页 > backend >正文

WakeLock的介绍与使用

backend 2025/7/6 22:02:25

1.什么是WakeLock

WakeLock是一种机制，表示应用需要设备保持运行（stay on）。

WakeLock默认是引用计数，如果WakeLock是引用计数的话，则调用了几次acquire()方法，就需要调用对应次数的release()方法才能真正释放掉WakeLock。

如果WakeLock不是引用计数的话，则调用一次release()函数，就可以释放前面调用多次acquire()获取的WakeLock锁。

2.如果使用WakeLock

使用WakeLock之前，需要在AndroidManifest.xml中声明android.permission.WAKE_LOCK权限。一般是通过使用PowerManager.newWakeLock（int,String）来获取，并指定一个WakeLock类型：

FULL_WAKE_LOCK 保持屏幕全亮、键盘背光灯点亮和CPU运行。
SCREEN_BRIGHT_WAKE_LOCK 保持屏幕全亮和CPU运行。
SCREEN_DIM_WAKE_LOCK 保持屏幕开启（但是让它变暗）和CPU运行。
PARTIAL_WAKE_LOCK 保持CPU运行。

例如：

PowerManager pm = (PowerManager)getSystemService(Context.POWER_SERVICE);  
WakeLock wakeLock = pm.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "MyWakeLock");

通过调用acquire()方法获取Wake Lock对象，并可以指定一个超时值timeout，在该timeout内保持使用该WakeLock。

PowerManager pm = (PowerManager)getSystemService(Context.POWER_SERVICE);  
WakeLock wakeLock = pm.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "MyWakeLock");  
wakeLock.acquire(10000);//timeout = 10s
// do something that require the CPU is active    
wakeLock.release();

当你完成了工作通过调用release()方法释放WakeLock对象。

WakeLock的构造函数如下：

WakeLock(int flags, String tag, String packageName) {mFlags = flags;mTag = tag;mPackageName = packageName;mToken = new Binder();mTraceName = "WakeLock (" + mTag + ")";}

WakeLock带timeout的acquire函数如下：

 public void acquire(long timeout) {synchronized (mToken) {acquireLocked();mHandler.postDelayed(mReleaser, timeout);}}

private void acquireLocked() {if (!mRefCounted || mCount++ == 0) {mHandler.removeCallbacks(mReleaser);Trace.asyncTraceBegin(Trace.TRACE_TAG_POWER, mTraceName, 0);try {mService.acquireWakeLock(mToken, mFlags, mTag, mPackageName, mWorkSource,mHistoryTag);} catch (RemoteException e) {}mHeld = true;}}

WakeLock的释放release函数如下：

public void release(int flags) {synchronized (mToken) {if (!mRefCounted || --mCount == 0) {mHandler.removeCallbacks(mReleaser);if (mHeld) {Trace.asyncTraceEnd(Trace.TRACE_TAG_POWER, mTraceName, 0);try {mService.releaseWakeLock(mToken, flags);} catch (RemoteException e) {}mHeld = false;}}if (mCount < 0) {throw new RuntimeException("WakeLock under-locked " + mTag);}}}

3.WakeLock的作用

为了延长电池的使用寿命，Android设备会在一段时间后使屏幕变暗，然后关闭屏幕显示，最后停止CPU。WakeLock是一个电源管理系统服务功能，应用程序可以使用它来控制设备的电源状态。
WakeLock可以用来保持CPU运行，避免屏幕变暗和关闭，以及避免键盘背光灯熄灭。

4.WakeLock的使用场景

屏幕Wake Lock通常用于在用户观看屏幕但是很少与屏幕进行交互期间（例如，播放视频）防止屏幕变暗。

CPU Wake Lock用于防止设备进入休眠状态，直至执行了一个操作。当服务从意图接收器内启动时常常出现这种情况，因为意图接收器可能在设备休眠期间接收意图。值得注意的是，在这种情况下，系统将在广播接收器的整个onReceive处理程序中使用CPU Wake Lock。

5.WakeLock使用的注意事项

在完成工作后，尽量快速释放wake lock锁，避免把电池耗尽。
使用WakeLock时，尽量使用带timeout的acquire方法，这样即使应用发生了异常，也会自动释放WakeLock。
创建和使用Wake Lock会对应用程序造成的电池电量消耗产生显著的影响。因此，最好只在确实有必要时使用Wake Lock，并且使用它们的时间越少越好，只要有可能就释放它们。
避免使用FULL_WAKE_LOCK，而应该使用WindowManger.LayoutParams.FLAG_KEEP_SCREEN_ON，因为使用FLAG_KEEP_SCREEN_ON标志，系统框架会自动处理相关的WakeLock释放与重新获得。
FULL_WAKE_LOCK、SCREEN_BRIGHT_WAKE_LOCK 、SCREEN_DIM_WAKE_LOCK 在按下Power电源键后，会被系统自动释放，但是PARTIAL_WAKE_LOCK会保持CPU一直运行，直到partial wake lock已经被释放了。