Jetpack Compose TextField点击Done键时键盘闪烁问题咨询

问题背景 #

这是Android SDK 32、33、34版本中，Jetpack Compose TextField设置ImeAction.Done时的已知系统级Bug。表现为点击Done键后，键盘会瞬间消失1帧，随后重新显示再执行正常收起动画，对依赖键盘高度定位的页面元素影响尤为明显。即使使用极简TextField代码也能复现：

TextField(
    value = TextFieldValue(),
    onValueChange = {},
    keyboardOptions = KeyboardOptions(imeAction = ImeAction.Done)
)

慢放录制可见：键盘在点击Done后先瞬间消失，随即重新出现并完成正常收起动画，过程存在明显闪跳。

解决办法 #

1. 彻底消除闪跳的核心方案 #

通过自定义KeyboardActions接管Done键行为，拦截系统默认的重复状态更新逻辑，仅执行手动隐藏键盘操作：

val keyboardController = LocalSoftwareKeyboardController.current

TextField(
    value = TextFieldValue(),
    onValueChange = {},
    keyboardOptions = KeyboardOptions(imeAction = ImeAction.Done),
    keyboardActions = KeyboardActions(
        onDone = {
            keyboardController?.hide()
            // 如需执行Done键的其他业务逻辑，在此添加
        }
    )
)

原理：系统默认Done动作会触发两次键盘状态变更（临时隐藏→触发收起动画），自定义onDone回调后，完全接管Done键的响应逻辑，避免系统的重复状态更新，从根源消除闪跳。

2. 辅助优化：适配键盘高度定位元素 #

若页面存在依赖键盘高度定位的元素，建议使用Compose官方的WindowInsetsAPI监听键盘状态，替代手动计算，进一步减少抖动：

val windowInsets = rememberWindowInsetsController()
val keyboardVisible = remember { mutableStateOf(false) }

LaunchedEffect(Unit) {
    windowInsets.keyboardVisibilityEvents.collect { visible ->
        keyboardVisible.value = visible
    }
}

// 使用keyboardVisible状态定位元素，或直接获取键盘高度
val keyboardHeight = WindowInsets.systemBars.asPaddingValues().calculateBottomPadding()

补充说明 #

该Bug在Android 14（SDK 34）的部分后续系统补丁中已修复，但覆盖范围有限，上述方案可兼容SDK 32-34全版本。你之前尝试的手动隐藏方式能降低概率，是因为部分场景下绕过了系统默认动作，但未完全拦截，而自定义onDone回调能彻底解决问题。

内容的提问来源于stack exchange，提问作者Fried Rice