PowerManager的用法分析

Posted 2022-12-11 zhenjie_chang

在分析PMS的工作原理之前，我们先来分析下PowerManager的用法

PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
  PowerManager.WakeLock wl = pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, "My Tag");
  wl.acquire();
    ..screen will stay on during this section..
      wl.release()

从以上代码中我们可以看出WakeLock用法的关键点

1.new 一个WakeLock对象，同时传入该WakeLock的类型的Flag标志

2.在使用之前调用wakeLock.aquire()获取锁

3.在使用之后调用wakeLock.release()释放锁

WakeLock是android系统提供给应用程序获取电力资源的方法，只要有应用还在使用WakeLock，系统就不会进入休眠状态。

系统中已经定义看一些wakeLock类型，wakeLock一般只会影响cpu,屏幕和键盘灯三大模块

1. PARTIAL_WAKE_LOCK ：cpu一直保持运行,允许屏幕和键盘灯熄灭

2. SCREEN_DIM_WAKE_LOCK ：cpu保持运行，屏幕变暗，允许键盘灯熄灭

3. SCREEN_BRIGHT_WAKE_LOCK ：cpu保持运行，屏幕亮屏，允许键盘灯熄灭

4. FULL_WAKE_LOCK ： cpu保持运行，屏幕和键盘灯点亮

除了以上的4中wakeLock外，还有两种附件的wakeLock类型，这两种类型需要和以上4中组合使用，但是partial wakelock比较特殊，附件wakelock不影响他的状态

1. ACQUIRE_CAUSES_WAKEUP ： 和其他wakeLock组合使用，表示申请wakeLock的同时是否唤醒屏幕

2. ON_AFTER_RELEASE ：和其他wakeLock组合使用，释放wakeLock后不会立即熄灭屏幕，延迟一段时间在熄灭，和用户体验有关

我们知道PowerManager和PowerManagerService之间的关系，PowerManagerService作为服务端，而PowerManager则为客户端的代理，他们之间通过binder进行进程间通信。

wakeLock.aquire分析

aquire()方法最终调用PMS的aquireWakeLock()方法，该方法中检查并申请相关的权限，最终由aquireWakeLockInternal()方法来处理。

private void acquireWakeLockInternal(IBinder lock, int flags, String tag, String packageName,
            WorkSource ws, String historyTag, int uid, int pid) 
        synchronized (mLock) 
            WakeLock wakeLock;
            //查找wakelock是否存在
            int index = findWakeLockIndexLocked(lock);
            boolean notifyAcquire;
            if (index >= 0) 
                //存在，从列表中获取该wakeLock
                wakeLock = mWakeLocks.get(index);
                //wakelock属性发生了变化，在更新该属性
                if (!wakeLock.hasSameProperties(flags, tag, ws, uid, pid)) 
                    notifyWakeLockChangingLocked(wakeLock, flags, tag, packageName,
                            uid, pid, ws, historyTag);
                    wakeLock.updateProperties(flags, tag, packageName, ws, historyTag, uid, pid);
                
                notifyAcquire = false;
             else 
                //不存在，创建一个新的wakelock
                wakeLock = new WakeLock(lock, flags, tag, packageName, ws, historyTag, uid, pid);
                try 
                    lock.linkToDeath(wakeLock, 0);
                 catch (RemoteException ex) 
                    throw new IllegalArgumentException("Wake lock is already dead.");
                
                //添加到wakelock列表
                mWakeLocks.add(wakeLock);
                //根据Doze模式的白名单更新wakelock的disabled变量
                setWakeLockDisabledStateLocked(wakeLock);
                notifyAcquire = true;
            
            //查看wakeLock是否有ACQUIRE_CAUSES_WAKEUP标志，有的话唤醒屏幕
            applyWakeLockFlagsOnAcquireLocked(wakeLock, uid);
            mDirty |= DIRTY_WAKE_LOCKS;
            //更新电源信息
            updatePowerStateLocked();
            if (notifyAcquire) 
                //通知wakeLock发生变化
                //电量统计服务做相关统计
                notifyWakeLockAcquiredLocked(wakeLock);
            
        
    

Aquire方法的具体流程

WakeLock.release方法

同样该方法最终调用PMS的releaseWakeLock方法，该方法检查和申请权限，最终由releaseWakeLockInternal()方法处理

该方法中首先判断wakeLock是否存在，若存在，则获取对应的wakeLock对象，从wakeLock列表中移除

下面是release方法流程图

wakeup方法

强制将设备从Sleep状态唤醒，比如按Power键点亮屏幕

该方法最终调用PMS的wakeUpInternal()方法

private void wakeUpInternal(long eventTime, String reason, int uid, String opPackageName,
            int opUid) 
        synchronized (mLock) 
            if (wakeUpNoUpdateLocked(eventTime, reason, uid, opPackageName, opUid)) 
                updatePowerStateLocked();
            
        
    

该方法根据wakeUpNoUpdateLocked方法进行判断，如果为true

则调用更新电源状态信息

PMS类中有很多***NoUpdateLocked()方法，这些方法都有一些共性，就是更新状态，不负责体的执行，因为具体的执行逻辑都是在updatePowerStateLocked方法中。

那么我们在来看下wakeUpNoUpdateLocked方法的实现

 private boolean wakeUpNoUpdateLocked(long eventTime, String reason, int reasonUid,
            String opPackageName, int opUid) 

        系统没有启动完成或者没有准备好，事件的时间不正确，当前已经是AWAKE
        不处理
        if (eventTime < mLastSleepTime || mWakefulness == WAKEFULNESS_AWAKE
                || !mBootCompleted || !mSystemReady) 
            return false;
        
        try 
            更新mLastWakeTime时间
            mLastWakeTime = eventTime;
            //修改当前的状态mWakefulness为WAKEFULNESS_AWAKE
            setWakefulnessLocked(WAKEFULNESS_AWAKE, 0);
            通知发生了变化
            mNotifier.onWakeUp(reason, reasonUid, opPackageName, opUid);
            触发一次用户活动
            userActivityNoUpdateLocked(
                    eventTime, PowerManager.USER_ACTIVITY_EVENT_OTHER, 0, reasonUid);
        
        return true;
    

PowerManager的基本用法分析完成，下面我们来具体分析下PMS服务的工作原理