萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android WindowManagerService 視窗管理核心機制:輸入法視窗與對話框層級調度

WindowManagerService (WMS) 是 Android 視窗系統的核心服務,負責視窗的新增、移除、佈局、Z-order 管理、焦點控制、輸入事件分發。本文聚焦 WMS 如何管理三類特殊視窗——Activity 視窗、輸入法視窗 (IME)、輸入法對話框 (候選詞、設定面板)——的層級關係與動態調度邏輯,基於 WindowManagerService.java 核心源碼解析。

視窗層級與 Token 體系

WMS 使用 視窗堆疊 (Window Stack) 維護 Z-order。每個視窗對應一個 WindowState,歸屬於一個 WindowToken (或 AppWindowToken)。

  • Activity 視窗:Token 為 AppWindowToken,對應 ActivityRecord。
  • 輸入法視窗:Token 為 WindowToken (型別 TYPE_INPUT_METHOD),由 IMS 請求 WMS 創建。
  • 輸入法對話框:同屬輸入法 Token,型別 TYPE_INPUT_METHOD_DIALOG。

堆疊中的相對位置 (由下至上)

[底層] ... Activity Window (WindowState N)
          Input Method Window (WindowState IMW)
          Input Method Dialog 1 (IMD-1)
          Input Method Dialog 2 (IMD-2)
          Input Method Dialog 3 (IMD-3)
[頂層]

IME 視窗永遠在當前聚焦 Activity 視窗之上;IME 對話框再疊加於 IME 視窗之上。

核心調度邏輯:addWindow() 關鍵片段

// frameworks/base/services/java/com/android/server/wm/WindowManagerService.java
public int addWindow(Session session, IWindow client, LayoutParams attrs, ...) {
  synchronized(mWindowMap) {
    // ... 建立 WindowState win ...

    boolean imMayMove = true;

    // 1. 新增的是輸入法視窗
    if (attrs.type == TYPE_INPUT_METHOD) {
      mInputMethodWindow = win;
      addInputMethodWindowToListLocked(win); // 插入到合適位置 (通常在當前焦點視窗之上)
      imMayMove = false;
    }
    // 2. 新增的是輸入法對話框
    else if (attrs.type == TYPE_INPUT_METHOD_DIALOG) {
      mInputMethodDialogs.add(win);
      addWindowToListInOrderLocked(win, true); // 按層級插入
      adjustInputMethodDialogsLocked();        // 調整對話框內部順序
      imMayMove = false;
    }

    // 3. 焦點變更可能觸發 IME 移動
    boolean focusChanged = false;
    if (win.canReceiveKeys()) {
      focusChanged = updateFocusedWindowLocked(UPDATE_FOCUS_WILL_ASSIGN_LAYERS);
      if (focusChanged) imMayMove = false;
    }

    // 4. 統一移動入口:若上述情況均未處理,檢查是否需移動 IME 群組
    if (imMayMove) {
      moveInputMethodWindowsIfNeededLocked(false);
    }
  }
}

關鍵輔助函數解析

addInputMethodWindowToListLocked(win)

將 IME 視窗插入到 當前聚焦視窗之上、所有非 IME 視窗之下。遍歷堆疊找到焦點視窗索引,插入其後。

adjustInputMethodDialogsLocked()

確保所有 IME 對話框 (mInputMethodDialogs) 緊隨 IME 視窗之後,按加入順序疊加。

moveInputMethodWindowsIfNeededLocked(alwaysMove)

核心調度入口。判斷條件:

  • 是否有 IME 視窗 (mInputMethodWindow != null)。
  • 當前聚焦視窗是否需要 IME (focusedWin != null && focusedWin.getAttrs().flags & FLAG_ALT_FOCUSABLE_IM)。
  • IME 視窗當前位置是否已在目標視窗之上。
  • 若需移動,呼叫 moveInputMethodWindowsLocked(targetIdx) 將整個 IME 群組 (IME 視窗 + 所有對話框) 移動到目標視窗上方。

焦點切換觸發 IME 移動流程

  1. 用戶點擊 EditText → Activity 視窗請求焦點 → updateFocusedWindowLocked 返回 true。
  2. WMS 檢測新焦點視窗 FLAG_ALT_FOCUSABLE_IM (即 textInputType != TYPE_NULL)。
  3. 若新焦點視窗非當前 IME 所依附視窗,呼叫 moveInputMethodWindowsIfNeededLocked。
  4. IME 視窗與對話框整體移動至新焦點視窗上方,動畫由 WindowAnimator 驅動。

InputMethodManagerService (IMS) 協作

  • IMS 持有 IME 視窗的 WindowToken (對應 Binder 端點)。
  • IMS 決定何時顯示/隱藏 IME (showSoftInput/hideSoftInput),實際上是通過 WMS addWindow/removeWindow 實現。
  • IMS 通知 WMS 目標視窗屬性變更 (如 setImeWindowStatus),觸發重新調度。

常見問題與調試技巧

  • IME 被其他系統視窗遮蓋:檢查系統視窗型別 (如 TYPE_SYSTEM_ALERT, TYPE_TOAST) 層級是否高於 TYPE_INPUT_METHOD (通常 2000+)。調整型別或使用 FLAG_NOT_FOCUSABLE。
  • 對話框未跟隨 IME 移動:確認對話框 type == TYPE_INPUT_METHOD_DIALOG 且 Token 為 IMS 提供的 Token。
  • 動畫卡頓:WindowAnimator 使用 SurfaceControl 硬體合成,若主執行緒阻塞會掉幀。使用 dumpsys window 檢查堆疊順序與動畫狀態。
  • 多螢幕支援:Android 10+ 每個顯示器獨立 WMS 實例 (DisplayContent),IME 群組綁定特定顯示器。

總結

WMS 透過 mInputMethodWindow、mInputMethodDialogs 兩個集合與 moveInputMethodWindowsIfNeededLocked 統一調度入口,確保輸入法視窗群組始終正確疊加於當前輸入焦點視窗之上。這套機制支撐了 Android 靈活的多視窗、分屏、自由切換輸入法體驗,是視窗管理系統中極具代表性的動態 Z-order 調度案例。

copyright © 萬盛學電腦網 all rights reserved