Android Wake lock

【轉：】http://blog.csdn.net/to_cm/archive/2010/08/01/5780773.aspx 
在Android中,申請WakeLock可以讓你的進程持續執行即使手機進入睡眠模式, 

比較實用的是比如: 

後臺有網絡功能,可以保證操作持續進行. 

方法: 在操作之前加入 

            PowerManager pm = (PowerManager) mContext.getSystemService(Context.POWER_SERVICE); 
            wakeLock = pm.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, Constants.TAG); 
            wakeLock.acquire(); 

別忘了在操作完畢之後釋放掉 

      if (wakeLock != null) { 
                wakeLock.release(); 
                wakeLock = null; 
            } 

例子: 

public void setWakeMode(Context context, int mode) { 
  boolean washeld = false; 
  if (mWakeLock != null) { 
   if (mWakeLock.isHeld()) { 
    washeld = true; 
    mWakeLock.release(); 
   } 
   mWakeLock = null; 
  } 

  PowerManager pm = (PowerManager) context 
    .getSystemService(Context.POWER_SERVICE); 
  mWakeLock = pm.newWakeLock(mode | PowerManager.ON_AFTER_RELEASE, 
    CloudGamePlayer.class.getName()); 
  mWakeLock.setReferenceCounted(false); 
  if (washeld) { 
   mWakeLock.acquire(); 
  } 
} 

Wake Lock是一種鎖的機制, 只要有人拿着這個鎖,系統就無法進入休眠， 
可以被用戶態程序和內核獲得. 這個鎖可以是有超時的或者是沒有超時的, 
超時的鎖會在時間過去以後自動解鎖. 如果沒有鎖了或者超時了, 內核就 
會啓動休眠的那套機制來進入休眠. 
(一).內核維護了: 
1).兩個鏈表，active_wake_locks[WAKE_LOCK_TYPE_COUNT] 
   active_wake_locks[0]維護的是suspend lock. 
   active_wake_locks[1]維護的是idle lock. 
2).一個鏈表，inactive_locks來記錄所有處於inactive狀態的鎖. 
  
(二). 下面講述應用層申請的鎖怎麼傳到kernel下面的，來理解 
       整個wakelock的框架。 
       比如/sys/power/wake_lock 下面的PowerManagerService 
       的生成過程。 
     
     1). Android 提供了現成 android.os.PowerManager 類 ,類中 
      提供 newWakeLock(int flags, String tag)方法來取得相應 
      層次的鎖， 此函數的定義 
         frameworks/base/core/java/android/os/PowerManager.java 
      下面，應用程序在申請wake_lock時都會有調用。 
       實例： 
        PowerManager pm = (PowerManager)getSystemService(Context.POWER_SERVICE); 
        PowerManager.WakeLock wl = pm.newWakeLock 
                                                   (PowerManager.SCREEN_DIM_WAKE_LOCK, “My Tag”); 
        wl.acquire();//申請鎖這個裏面會調用PowerManagerService裏面acquireWakeLock() 

*********************** 
        wl.release(); //釋放鎖，顯示的釋放，如果申請的鎖不在此釋放系統就不會進入休眠。 

  
2). frameworks層 
/frameworks/base/services/java/com/android/server/ 
PowerManagerService.java 
這個類是來管理所有的應用程序申請的wakelock。比如音視 
頻播放器，camera等申請的wakelock都是通過這個類來管理的。 
static final String PARTIAL_NAME = "PowerManagerService" 
Power.acquireWakeLock(Power.PARTIAL_WAKE_LOCK, 
                                                                   PARTIAL_NAME); 
這個函數調用Power類裏面的acquireWakeLock()，此時的 
PARTIAL_NAME作爲參數傳遞到底層去。 




/frameworks/base/core/java/android/os/Power.java 
public static native void acquireWakeLock(int lock, String id); 
注：native申明的方法在Power類中沒有實現，其實現體在 
       frameworks/base/core/jni/android_os_Power.cpp中，所 
       以調用Power類的acquireWakeLock()方法時會調用JNI 
       下的實現方法。 






   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); 
  } 
     注：在acquireWakeLock()中調用了 
             路徑下hardware/libhardware_legacy/power/power.c下面 
的acquire_wake_lock(lock, id) 




4).與kernel層的交互 
在power.c下的acquire_wake_lock(lock, id)函數如下： 
int acquire_wake_lock(int lock, const char* id) 
{   
************** 
     return write(fd, id, strlen(id)); 
} 
注： fd就是文件描述符，在此表示”/sys/power/wake_lock” 
         id就是從PowerManagerService類中傳下來的參數即： 
         PARTIAL_NAME = "PowerManagerService" 
         到此就是通過文件系統來與kernel層交互的地方。