參考：
https://blog.csdn.net/wh_19910525/article/details/8287202
http://landerlyoung.github.io/blog/2014/10/31/androidzhong-de-wakelockshi-yong/

一.使用

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

在Manifest中添加如下權(quán)限
<uses-permission android:name="android.permission.WAKE_LOCK" />

WakeLock級別：
    PARTIAL_WAKE_LOCK       保持CPU運(yùn)轉(zhuǎn)，屏幕和鍵盤背光可能關(guān)閉
    SCREEN_DIM_WAKE_LOCK    保持CPU運(yùn)轉(zhuǎn)，保持屏幕常亮(亮度低)，鍵盤背光可能關(guān)閉
    SCREEN_BRIGHT_WAKE_LOCK 保持CPU運(yùn)轉(zhuǎn)，保持屏幕和鍵盤背光高亮
    FULL_WAKE_LOCK          保持CPU運(yùn)轉(zhuǎn)，保持屏幕和鍵盤背光高亮(亮度最高)
    
    ACQUIRE_CAUSES_WAKEUP            強(qiáng)制亮屏，針對一些必須通知用戶的操作
    ON_AFTER_RELEASE                 當(dāng)鎖被釋放時(shí)，保持亮屏一段時(shí)間(如果釋放時(shí)屏幕沒亮，則不會亮屏)
    PROXIMITY_SCREEN_OFF_WAKE_LOCK   和接近傳感器配合,當(dāng)用戶接近屏幕時(shí)黑屏,離開時(shí)亮屏(例如打電話),該API在API21后開放,以前被hide
    
    保持屏幕長亮的WakeLock被建議棄用，系統(tǒng)推薦如下方法(當(dāng)Activity或view可見時(shí),屏幕才保持常亮)：
        在Activity.onCreate()中:  getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
        或在xml布局中: android:keepScreenOn="true"
        或?qū)iew設(shè)置:  view.setKeepScreenOn(true);
        
        FLAG_KEEP_SCREEN_ON實(shí)際就是一個(gè)SCREEN_BRIGHT_WAKE_LOCK級別的WakeLock
        創(chuàng)建和釋放鎖都由系統(tǒng)自動管理，更加方便和安全，在后面通過adb命令驗(yàn)證         
        
        屏幕相關(guān)的其它FLAG:
        WindowManager.LayoutParams.FLAG_DISMISS_KEYGUARD    解鎖屏幕
        WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON      點(diǎn)亮屏幕
        WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED    屏幕鎖定時(shí)也能顯示
        WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON   屏幕打開時(shí)允許鎖屏
        
        屏幕鎖屏和解鎖(需要權(quán)限"android.permission.DISABLE_KEYGUARD")
        KeyguardManager keyguardManager = (KeyguardManager) context.getSystemService(KEYGUARD_SERVICE);
        KeyguardManager.KeyguardLock keyguardLock = keyguardManager.newKeyguardLock("unLock");          
        keyguardLock.reenableKeyguard(); // 鎖屏
        //keyguardLock.disableKeyguard();// 解鎖          

!注意：
    如果申請partial wakelock,那么即使用戶按Power鍵,系統(tǒng)也不會Sleep
    如果申請其它wakelocks,用戶按Power鍵,系統(tǒng)還是會Sleep
    
PowerManager方法
    boolean isScreenOn()       判斷屏幕是否亮著,在API20被棄用,推薦isInteractive()
    void goToSleep(long time)  強(qiáng)制休眠(系統(tǒng)APP權(quán)限"android.permission.DEVICE_POWER",按下電源鍵鎖屏?xí)r調(diào)用該方法)
    void wakeUp(long time)     強(qiáng)制喚醒(權(quán)限同上,按下電源鍵時(shí)調(diào)用該方法)
    void reboot(String reason) 重啟手機(jī)(系統(tǒng)APP權(quán)限"android.permission.REBOOT"),參數(shù):"recovery","fastboot"
    
WakeLock方法:
    void acquire()              獲得WakeLock，除非顯式釋放，否則不會解鎖（經(jīng)測試,APP進(jìn)程被殺死后,鎖會失效）
    void acquire(long timeOut)  當(dāng)超過timeOut之后系統(tǒng)自動釋放WakeLock
    void release()              釋放WakeLock
    boolean isHeld()            是否已經(jīng)獲取WakeLock  
    void setReferenceCounted(boolean value) 是否使用引用計(jì)數(shù)(默認(rèn)ture): 一個(gè)WakeLock調(diào)用acquire()多次,也必須release()多次才能釋放,
    如果釋放次數(shù)比acquire()多,則拋出異常: java.lang.RuntimeException: WakeLock under-locked MyTAG

二.原理

通過adb命令查看WakeLock鎖的個(gè)數(shù):
adb shell dumpsys power

Wake Locks: size=4
    mLock:346803 PARTIAL_WAKE_LOCK         'MyTAG' ACQ=-1s175ms (uid=10201 pid=3862)
    mLock:141928 SCREEN_DIM_WAKE_LOCK      'MyTAG' ACQ=-1s174ms (uid=10201 pid=3862)
    mLock:402427 SCREEN_BRIGHT_WAKE_LOCK   'MyTAG' ACQ=-1s173ms (uid=10201 pid=3862)
    mLock:124789 SCREEN_BRIGHT_WAKE_LOCK   'WindowManager' ON_AFTER_RELEASE ACQ=-1s70ms (uid=1000 pid=1196 ws=WorkSource{10201})
注：最后一個(gè)Lock是由FLAG_KEEP_SCREEN_ON創(chuàng)建的，由系統(tǒng)用戶進(jìn)程管理(uid=1000是系統(tǒng)用戶)  
  
在創(chuàng)建了 PowerManager.WakeLock 后，有兩種機(jī)制，第一種是不計(jì)數(shù)鎖機(jī)制，另一種是計(jì)數(shù)鎖機(jī)制。
可以通過 setReferenceCounted(boolean value) 來指定，一般默認(rèn)為計(jì)數(shù)機(jī)制。
這兩種機(jī)制的區(qū)別在于，前者無論 acquire() 了多少次，只要通過一次 release()即可解鎖。
而后者正真解鎖是在（ --count == 0 ）的時(shí)候，同樣當(dāng) (count == 0) 的時(shí)候才會去申請加鎖。
所以 PowerManager.WakeLock 的計(jì)數(shù)機(jī)制并不是正真意義上的對每次請求進(jìn)行申請／釋放每一把鎖，
它只是對同一把鎖被申請／釋放的次數(shù)進(jìn)行了統(tǒng)計(jì)，然后再去操作。

Wakelock框架的大致流程：
    1).應(yīng)用層  /frameworks/base/core/java/android/os/PowerManager.java
    WakeLock.acquire() -> PowerManagerService.acquireWakeLock()
    
    2).frameworks層  /frameworks/base/services/java/com/android/server/PowerManagerService.java
    管理所有APP申請的wakelock,比如音視、頻播放器、camera等        
    static final String PARTIAL_NAME ="PowerManagerService";
    public static native void nativeAcquireWakeLock(int lock, String id);       
    nativeAcquireWakeLock(PARTIAL_WAKE_LOCK_ID, PARTIAL_NAME);
    
    3).JNI層 /frameworks/base/core/jni/android_os_Power.cpp
    static void acquireWakeLock(JNIEnv *env, jobject clazz,  jint lock, jstring idObj){
        ...
        const char *id = env->GetStringUTFChars(idObj, NULL);
        acquire_wake_lock(lock, id);
        env->ReleaseStringUTFChars(idObj, id);
    }
 
    4).kernel層 /hardware/libhardware_legacy/power/power.c       
    int acquire_wake_lock(int lock, const char* id){
        ...
        return write(fd, id, strlen(id));
    }
    fd是文件描述符: "/sys/power/wake_lock"
    id是從frameworks層傳來的參數(shù): "PowerManagerService"  

簡書: http://www.itdecent.cn/p/2cfd179ef8dc
CSDN: https://blog.csdn.net/qq_32115439/article/details/80169222
GitHub博客: http://lioil.win/2018/05/02/Android-WakeLock.html
Coding博客: http://c.lioil.win/2018/05/02/Android-WakeLock.html