Android4.0 Keyguard解锁屏机制

 Keyguard解锁屏是Android系统中必不可少的模块，用户在开机后或者在点击Power按钮屏幕变亮后首先看到的画面即为解锁屏模块对应的界面。Keyguard模块功能相对简单：
      第一：直观地显示手机当前的关键信息：比如电池信息、运营商信息、日期信息以及通话短信信息等。
      第二：增强手机的安全性能：为了安全，用户可以在Setting里的Secure选项中设置password、pattern、account等不同的安全策略，防止非法用户访问手机系统。
      但从代码实现的角度该模块逻辑还是比较复杂，不但需要监听系统中的多种event，比如sim、电话、电池以及Carrier等状态，还要正确反映、显示屏幕的不同状态。为了对Keyguard模块的处理逻辑有更清晰的理解，下面首先从系统构成的角度概括介绍Keyguard解锁屏模块的框架，然后对解锁屏模块中重要的处理逻辑进行详细介绍。
一、系统介绍

      Keyguard解锁屏模块的框架类图如下：

      图中仅列出了Keyguard解锁屏模块涉及的重要类，这些类实现了Keyguard模块的主要功能，它们的作用如下：
      PhoneWindowManager是解锁屏模块对外交互的接口，窗口管理Service、电源管理Service等外部模块都是通过PhoneWindowManager访问Keyguard内部功能。
      KeyguardViewMediator类为解锁屏模块的中介者，以中介的身份处理keyguard状态变化，处理event、power管理、PhoneWindowManager通知等请求，并作为回调对象供解锁屏模块的其它类回调。
      KeyguardUpdateMonitor类为解锁屏模块的监听者，它负责监听时间、sim卡、运营商信息、电池信息、电话信息等状态的变化，并通知keyguard View模块更新显示。
      KeyguardViewManager类为解锁屏view模块的管理者，管理解锁屏界面的创建、显示、隐藏以及重置等。
      LockPatternKeyguardView类为解锁屏模块的View界面，为所有解锁屏界面的host view。根据设置的安全策略，显示不同的解锁屏界面。Google原生代码中实现了6种解锁屏界面：
     1) LockScreen：用于显示屏幕加锁状态
     2) PatternUnlockScreen：实现图案解锁模式
     3) SimPukUnlockScreen：屏幕实现SIM PUK码解锁模式
     4) SimUnlockScreen：实现Sim PIN码解锁模式
     5) AccountUnlockScreen：实现 GOOGLE 帐户解锁
     6) PasswordUnlockScreen：实现自定义密码解锁模式
二、主要逻辑
1、Keyguard模块启动、显示逻辑
     即手机开机进入系统到锁屏界面显示的过程。手机系统启动过程中会自动启动Keyguard解锁屏模块，该模块的创建始于WindowManagerService类，时序图如下：

     1）WindowManagerService在启动时会实例化PhoneWindowManager对象mPolicy，并在窗口管理Policy线程PolicyThread中初始化，代码如下：

 public void run() {
     Looper.prepare();
     WindowManagerPolicyThread.set(this, Looper.myLooper());
     ......
     mPolicy.init(mContext, mService, mService, mPM);
     ......
     Looper.loop();
 }

     从代码中可以看到PhoneWindowManager在独立的线程和Looper消息队列中处理Message事件，该Looper对象也为解锁屏模块使用以处理所有handler消息。
    2）mPolicy函数init中创建解锁屏模块的中介者——KeyguardViewMediator对象。
    3）在KeyguardViewMediator的构造函数中创建LockPatternKeyguardViewProperties、KeyguardUpdateMonitor、KeyguardViewManager等重要对象：

 public KeyguardViewMediator(Context context, PhoneWindowManager callback,
             LocalPowerManager powerManager) {
         ……
         mUpdateMonitor = new KeyguardUpdateMonitor(context);
         mUpdateMonitor.registerInfoCallback(this);
         mUpdateMonitor.registerSimStateCallback(this);
         mLockPatternUtils = new LockPatternUtils(mContext);
         mKeyguardViewProperties
 = new LockPatternKeyguardViewProperties(mLockPatternUtils, mUpdateMonitor);
         mKeyguardViewManager = new KeyguardViewManager(
                 context, WindowManagerImpl.getDefault(), this,
                 mKeyguardViewProperties, mUpdateMonitor);
        ……
  }

      KeyguardViewMediator中记录了PhoneWindowManager、PowerManager等对象，同时也保存了LockPatternKeyguardViewProperties、KeyguardUpdateMonitor、KeyguardViewManager等模块内的重要对象，这样该类以中介者身份在Keyguard模块对外交互以及内部各对象间的交互中发挥了重要作用。
     4）KeyguardUpdateMonitor构造函数中创建mHandler，用以响应处理该类监听的各事件状态的改变，并在handle处理函数中通知mInfoCallbacks和mSimStateCallbacks保存的监听对象，监听事件有ACTION_TIME_TICK、ACTION_TIME_CHANGED、ACTION_BATTERY_CHANGED、ACTION_TIMEZONE_CHANGED、ACTION_SIM_STATE_CHANGED、        ACTION_PHONE_STATE_CHANGED、RINGER_MODE_CHANGED_ACTION
    至此Keyguard解锁屏模块中重要的类对象已经实例化，但是还未涉及解锁屏View界面的创建和显示。
    5）系统启动后解锁屏界面的首次显示始于WindowManagerService的systemReady函数，通知PhoneWindowManager系统就绪，代码如下：

 public void systemReady() {
     mPolicy.systemReady();
 }

    6）PhoneWindowManager的systemReady函数中通知解锁屏模块的中介者KeyguardViewMediator对象系统就绪
    7）中介者KeyguardViewMediator类中处理系统就绪情形：调用doKeyguardLocked函数显示解锁屏界面：

 public void onSystemReady() {
     synchronized (this) {
          mSystemReady = true;
          doKeyguardLocked();
     }
 }
 private void doKeyguardLocked() {
         ......
         // if the keyguard is already showing, don't bother
         if (mKeyguardViewManager.isShowing()) {
             if (DEBUG) Log.d(TAG, "doKeyguard: not showing because it is already showing");
             return;
         }

         .....
         if (DEBUG) Log.d(TAG, "doKeyguard: showing the lock screen");
         showLocked();
 }

    showLocked函数中发送SHOW消息异步处理解锁屏界面显示的请求。
    8）handleShow中处理界面显示的消息请求，函数中调用KeyguardViewManager的函数show实现解锁屏界面的真正显示：

 public synchronized void show() {
         ......
         if (mKeyguardHost == null) {
             if (DEBUG) Log.d(TAG, "keyguard host is null, creating it...");

             mKeyguardHost = new KeyguardViewHost(mContext, mCallback);
             ......
             mViewManager.addView(mKeyguardHost, lp);
         }
         ......
         mViewManager.updateViewLayout(mKeyguardHost, mWindowLayoutParams);

         if (mKeyguardView == null) {
             mKeyguardView = mKeyguardViewProperties.createKeyguardView(mContext, mUpdateMonitor, this);
             ......
             mKeyguardHost.addView(mKeyguardView, lp);
             ......
         }
         ......
 }

     该函数中主要创建了Keyguard显示View中的两个重要的对象：mKeyguardHost和mKeyguardView，它们都是继承于FrameLayout，为解锁屏视图的根view。
     9）在创建对象mKeyguardView时根据解锁屏mode创建解锁屏界面：

 protected void updateScreen(Mode mode, boolean force) {
          ......
         // Re-create the lock screen if necessary
         if (mode == Mode.LockScreen || mShowLockBeforeUnlock) {
             if (force || mLockScreen == null) {
                 recreateLockScreen();
             }
         }

         // Re-create the unlock screen if necessary. This is primarily required to properly handle
         // SIM state changes. This typically happens when this method is called by reset()
         if (mode == Mode.UnlockScreen) {
             final UnlockMode unlockMode = getUnlockMode();
             if (force || mUnlockScreen == null || unlockMode != mUnlockScreenMode) {
                 recreateUnlockScreen(unlockMode);
             }
         }
         ......
     }

     10）在函数createLockScreen或者createUnlockScreenFor中创建具体的Lock或者Unlock View界面，并调用show函数进行显示
    至此，Keyguard解锁屏模块从系统开机启动到界面显示的处理逻辑已介绍完成。

2、两次按下Power按钮屏幕亮->暗->亮过程中锁屏模块处理逻辑
     连续两次按下Power按钮屏幕亮->暗->亮过程中解锁屏模块处理逻辑的时序图如下：

    1）在函数PowerManagerService:setPowerState中响应Power按钮的按下，代码如下：

 private void setPowerState(int newState, boolean noChangeLights, int reason)
     {
         synchronized (mLocks) {
             ……
             if (oldScreenOn != newScreenOn) {
                 if (newScreenOn) {
                     // When the user presses the power button, we need to always send out the
                     // notification that it's going to sleep so the keyguard goes on.  But
                     // we can't do that until the screen fades out, so we don't show the keyguard
                     // too early.
                     if (mStillNeedSleepNotification) {
                         sendNotificationLocked(false, WindowManagerPolicy.OFF_BECAUSE_OF_USER);
                     }
                     ……
                     if (err == 0) {
                         sendNotificationLocked(true, -1);
                         // Update the lights *after* taking care of turning the
                         // screen on, so we do this after our notifications are
                         // enqueued and thus will delay turning on the screen light
                         // until the windows are correctly displayed.
                         if (stateChanged) {
                             updateLightsLocked(newState, 0);
                         }
                         mPowerState |= SCREEN_ON_BIT;
                     }

                 } else {
                     ……
                     if (!mScreenBrightness.animating) {
                         err = screenOffFinishedAnimatingLocked(reason);
                     }
                     ……
                 }
             }
             ……
         }
 }

     根据上面的代码逻辑，屏幕即将变暗时调用函数screenOffFinishedAnimatingLocked，屏幕即将变亮时调用函数sendNotificationLocked 。
     2）函数sendNotificationLocked发送Notification Task线程到handler，并异步执行通知解锁屏模块进行状态更新：

 private Runnable mNotificationTask = new Runnable()
    {
        public void run()
        {
            while (true) {
                ......
                if (value == 1) {
                    policy.screenTurningOn(mScreenOnListener);
                    ......
                }
                else if (value == 0) {
                    policy.screenTurnedOff(why);
                   ......
                }
                else {
                    // If we're in this case, then this handler is running for a previous
                    // paired transaction.  mBroadcastWakeLock will already have been released.
                    break;
                }
            }
        }
    };

     上面的线程函数run中分别处理了屏幕变暗和变亮的情形。按下Power按钮屏幕变暗时调用了函数screenTurnedOff，why为变暗的原因，此处值为OFF_BECAUSE_OF_USER。
     3）KeyguardViewMediator中根据屏幕变暗的原因分别处理屏幕变暗事件：

  /**
      * Called to let us know the screen was turned off.
      * @param why either {@link WindowManagerPolicy#OFF_BECAUSE_OF_USER},
      *   {@link WindowManagerPolicy#OFF_BECAUSE_OF_TIMEOUT} or
      *   {@link WindowManagerPolicy#OFF_BECAUSE_OF_PROX_SENSOR}.
      */
 public void onScreenTurnedOff(int why) {
    synchronized (this) {
    ……
    else if (mShowing) { //若是(mShowing)则重置显示界面，否则重新显示锁屏界面
                 notifyScreenOffLocked();
                 resetStateLocked();
             } else if (why == WindowManagerPolicy.OFF_BECAUSE_OF_TIMEOUT) {
                 // if the screen turned off because of timeout, set an alarm
                 // to enable it a little bit later (i.e, give the user a chance
                 // to turn the screen back on within a certain window without
                 // having to unlock the screen)
                 ……

                 if (timeout <= 0) {
                     // Lock now
                     mSuppressNextLockSound = true;
                     doKeyguardLocked();
                 } else {
                     // Lock in the future
                     long when = SystemClock.elapsedRealtime() + timeout;
                     Intent intent = new Intent(DELAYED_KEYGUARD_ACTION);
                     intent.putExtra("seq", mDelayedShowingSequence);
                     PendingIntent sender = PendingIntent.getBroadcast(mContext,
                             0, intent, PendingIntent.FLAG_CANCEL_CURRENT);
                     mAlarmManager.set(AlarmManager.ELAPSED_REALTIME_WAKEUP, when,
                             sender);
                 }
             } else if (why == WindowManagerPolicy.OFF_BECAUSE_OF_PROX_SENSOR) {
                 // Do not enable the keyguard if the prox sensor forced the screen off.
             } else { //显示锁屏屏幕
                 doKeyguardLocked();
             }
         }
 }

     4）调用doKeyguardLocked重新显示锁屏界面，随后的锁屏界面显示逻辑与Keyguard模块启动显示中的8~10步相同，不再赘述。
     5）按下Power按钮屏幕即将由暗->亮时代码处理逻辑重新执行1~2步，第二步中屏幕变亮时调用的函数是PhoneWindowManager:screenTurningOn。
     6）函数screenTurningOn中调用中介者KeyguardViewMediator的函数onScreenTurnedOn，该函数直接调用屏幕变亮异步通知函数KeyguardViewMediator:notifyScreenOnLocked，告知解锁屏模块屏幕即将变亮。
     7）函数handleNotifyScreenOn响应屏幕变亮的通知
     8）程序执行到LockPatternKeyguardView:onScreenTurnedOn函数，并调用show函数进行解锁屏界面的显示，代码如下：

 public void show() {
         if (mMode == Mode.LockScreen) {
             ((KeyguardScreen) mLockScreen).onResume();
         } else {
             ((KeyguardScreen) mUnlockScreen).onResume();
         }
         ......
  }

     至此，逻辑处理完成。
3、自定义口令解锁逻辑
    自定义口令解锁始于PasswordUnlockScreen，时序图如下：

   1）解锁屏界面输入密码点击确定按钮后，在函数onEditorAction中进行响应：

 public boolean onEditorAction(TextView v, int actionId, KeyEvent event) {
         // Check if this was the result of hitting the enter key
         if (actionId == EditorInfo.IME_NULL || actionId == EditorInfo.IME_ACTION_DONE
                 || actionId == EditorInfo.IME_ACTION_NEXT) {
             verifyPasswordAndUnlock();
             return true;
         }
         return false;
 }

   2）在函数verifyPasswordAndUnlock中对输入的密码进行判断，如果输入正确，测调用keyguardDone响应解锁完成的操作。mCallback.keyguardDone(true)调用是所有解锁屏mode情形在解锁成功后必须调用的函数，随后的处理逻辑对于不同的解锁屏界面也是相同的。
   3）回调KeyguardScreenCallback和KeyguardViewMediator的函数keyguardDone，在后者的keyguardDone函数中，异步发送keyDone事件：

 public void keyguardDone(boolean authenticated, boolean wakeup) {
     synchronized (this) {
         ……
         Message msg = mHandler.obtainMessage(KEYGUARD_DONE);
         msg.arg1 = wakeup ? 1 : 0;
         mHandler.sendMessage(msg);
         ……
     }
 }

   4）函数KeyguardViewMediator:handleKeyguardDone异步处理keyguardDone事件,调用handleHide隐藏锁屏界面。
   5）KeyguardViewManager.hide函数中调用锁屏界面的销毁函LockPatternKeyguardView:cleanUp数隐藏销毁界面，如下：

 public void cleanUp() {
     if (mLockScreen != null) {
         ((KeyguardScreen) mLockScreen).onPause();
         ((KeyguardScreen) mLockScreen).cleanUp();
         this.removeView(mLockScreen);
         mLockScreen = null;
     }
     if (mUnlockScreen != null) {
         ((KeyguardScreen) mUnlockScreen).onPause();
         ((KeyguardScreen) mUnlockScreen).cleanUp();
         this.removeView(mUnlockScreen);
         mUnlockScreen = null;
     }
     ......
 }

    至此，解锁完成。