WindowInsets与InputMethodManager对比：Android软键盘显隐的正确实现方式

核心选型结论 #

• Android 11（API 30）及以上版本：优先选用WindowInsets体系下的WindowInsetsController相关API，完全替代传统InputMethodManager方案
• Android 10及以下兼容场景：搭配AndroidX Core提供的WindowInsetsControllerCompat兼容层实现，无需单独适配旧版InputMethodManager逻辑

为什么不推荐直接使用InputMethodManager #

• 传统InputMethodManager的showSoftInput()/hideSoftInputFromWindow()方法依赖window token获取，极容易出现token无效导致的软键盘显隐失败的兼容性问题
• 无法对齐系统软键盘的过渡动画帧，容易出现界面布局跳跃、动画不同步的卡顿感
• 需要额外处理焦点申请、token有效性校验逻辑，多余的主线程调度会带来不必要的性能损耗

兼顾性能、动画流畅度的正确实现方案 #

前置依赖配置 #

首先引入AndroidX Core库获得跨版本兼容能力，无需单独适配不同系统版本的API差异：

dependencies {
    // 可替换为官方最新稳定版
    implementation "androidx.core:core-ktx:1.12.0"
}

软键盘唤起实现 #

// 目标输入框申请焦点后直接调用控制器方法即可
val targetEditText = findViewById<EditText>(R.id.input_edittext)
targetEditText.requestFocus()
val insetsController = ViewCompat.getWindowInsetsController(targetEditText)
insetsController?.show(WindowInsetsCompat.Type.ime())

软键盘隐藏实现 #

// 不需要主动获取当前焦点View的window token，逻辑更稳定
val currentView = currentFocus ?: window.decorView
val insetsController = ViewCompat.getWindowInsetsController(currentView)
insetsController?.hide(WindowInsetsCompat.Type.ime())

适配布局同步过渡动画 #

如果需要布局跟随软键盘滚动、避免出现跳跃感，在Activity的onCreate方法中添加如下配置即可：

// 关闭系统默认的窗口适配逻辑，自定义处理insets
WindowCompat.setDecorFitsSystemWindows(window, false)
// 监听软键盘高度变化动态调整布局padding，完全对齐系统动画帧
ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.activity_root_layout)) { rootView, insets ->
    val imeBottomHeight = insets.getInsets(WindowInsetsCompat.Type.ime()).bottom
    rootView.setPadding(0, 0, 0, imeBottomHeight)
    insets
}

方案优势 #

• 全版本覆盖Android 5.0（API 21）以上设备，没有私有API调用风险，兼容性远高于传统InputMethodManager方案
• 软键盘显隐逻辑与系统动画帧完全对齐，不会出现布局跳跃、动画掉帧问题
• 无需额外处理window token有效性校验、焦点状态轮询等逻辑，减少不必要的主线程任务，无额外性能损耗

内容的提问来源于stack exchange，提问作者RAJESH SAHU