WindowManagerService (WMS) 是 Android 視窗系統的核心服務,負責視窗的新增、移除、佈局、Z-order 管理、焦點控制、輸入事件分發。本文聚焦 WMS 如何管理三類特殊視窗——Activity 視窗、輸入法視窗 (IME)、輸入法對話框 (候選詞、設定面板)——的層級關係與動態調度邏輯,基於 WindowManagerService.java 核心源碼解析。
WMS 使用 視窗堆疊 (Window Stack) 維護 Z-order。每個視窗對應一個 WindowState,歸屬於一個 WindowToken (或 AppWindowToken)。
AppWindowToken,對應 ActivityRecord。WindowToken (型別 TYPE_INPUT_METHOD),由 IMS 請求 WMS 創建。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 視窗之上。
// 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);
}
}
}
將 IME 視窗插入到 當前聚焦視窗之上、所有非 IME 視窗之下。遍歷堆疊找到焦點視窗索引,插入其後。
確保所有 IME 對話框 (mInputMethodDialogs) 緊隨 IME 視窗之後,按加入順序疊加。
核心調度入口。判斷條件:
mInputMethodWindow != null)。focusedWin != null && focusedWin.getAttrs().flags & FLAG_ALT_FOCUSABLE_IM)。moveInputMethodWindowsLocked(targetIdx) 將整個 IME 群組 (IME 視窗 + 所有對話框) 移動到目標視窗上方。updateFocusedWindowLocked 返回 true。FLAG_ALT_FOCUSABLE_IM (即 textInputType != TYPE_NULL)。moveInputMethodWindowsIfNeededLocked。WindowAnimator 驅動。WindowToken (對應 Binder 端點)。showSoftInput/hideSoftInput),實際上是通過 WMS addWindow/removeWindow 實現。setImeWindowStatus),觸發重新調度。TYPE_SYSTEM_ALERT, TYPE_TOAST) 層級是否高於 TYPE_INPUT_METHOD (通常 2000+)。調整型別或使用 FLAG_NOT_FOCUSABLE。type == TYPE_INPUT_METHOD_DIALOG 且 Token 為 IMS 提供的 Token。WindowAnimator 使用 SurfaceControl 硬體合成,若主執行緒阻塞會掉幀。使用 dumpsys window 檢查堆疊順序與動畫狀態。DisplayContent),IME 群組綁定特定顯示器。WMS 透過 mInputMethodWindow、mInputMethodDialogs 兩個集合與 moveInputMethodWindowsIfNeededLocked 統一調度入口,確保輸入法視窗群組始終正確疊加於當前輸入焦點視窗之上。這套機制支撐了 Android 靈活的多視窗、分屏、自由切換輸入法體驗,是視窗管理系統中極具代表性的動態 Z-order 調度案例。