Android Jetpack Compose自定义TextField软键盘无法弹出问题求助

你的自定义TextField软键盘无法弹出的核心原因是：组件没有与Compose的文本输入服务建立关联，系统无法识别这是一个需要唤起软键盘的可输入区域。仅设置focusable()和手动调用keyboardController?.show()不足以让软键盘正常工作，需要绑定文本输入会话并处理软键盘的输入回调。

以下是修复后的完整实现：

@Composable
fun MyCustomTextField() {
    var text by remember { mutableStateOf("") }
    val focusRequester = remember { FocusRequester() }
    val keyboardController = LocalSoftwareKeyboardController.current
    var hasFocus by remember { mutableStateOf(false) }

    // 创建文本输入状态，管理输入会话
    val textInputState = remember {
        object : TextInputState {
            override var text: TextFieldValue
                get() = TextFieldValue(text)
                set(value) { text = value.text }

            override fun onFocusChanged(focused: Boolean) {
                // 同步焦点状态到文本输入服务
            }
        }
    }

    // 绑定文本输入服务，让系统识别这是可输入区域
    val textInputService = LocalTextInputService.current
    CompositionLocalProvider(
        LocalTextInputProvider provides TextInputProvider(textInputService, textInputState)
    ) {
        Box(
            modifier = Modifier
                .focusRequester(focusRequester)
                .onFocusChanged {
                    hasFocus = it.hasFocus
                    textInputState.onFocusChanged(hasFocus)
                    if (hasFocus) {
                        keyboardController?.show()
                    } else {
                        keyboardController?.hide()
                    }
                }
                .focusable()
                .focusTarget()
                .clickable {
                    if (!hasFocus) {
                        focusRequester.requestFocus()
                    }
                }
                // 仅处理硬件键盘事件，软键盘输入由文本输入服务自动同步
                .onKeyEvent {
                    if (it.type == KeyEventType.KeyDown) {
                        when (it.nativeKeyEvent.keyCode) {
                            KeyEvent.KEYCODE_DEL -> {
                                if (text.isNotEmpty()) {
                                    text = text.substring(0, text.length - 1)
                                }
                            }
                            else -> {
                                val char = it.nativeKeyEvent.unicodeChar.toChar()
                                if (char.isValidChar()) {
                                    text += char.toString()
                                }
                            }
                        }
                    }
                    true
                }
        ) {
            Text("text: $text")
        }
    }

    // 初始请求焦点
    LaunchedEffect(Unit) {
        focusRequester.requestFocus()
    }
}

// 实现TextInputState接口，连接文本输入服务
private interface TextInputState : TextFieldValueState {
    fun onFocusChanged(focused: Boolean)
}

private class TextFieldValueStateImpl(
    initialValue: TextFieldValue
) : TextFieldValueState {
    override var text by mutableStateOf(initialValue)
}

@Composable
fun rememberTextFieldValueState(
    initialValue: TextFieldValue = TextFieldValue("")
): TextFieldValueState {
    return remember { TextFieldValueStateImpl(initialValue) }
}

关键修复点： #

• 绑定文本输入服务：通过LocalTextInputProvider将自定义组件与Compose的文本输入服务关联，让系统识别这是可输入区域，从而触发软键盘弹出。
• 文本输入状态管理：实现TextInputState接口，统一管理文本内容，软键盘的输入会通过该状态自动同步到文本变量中。
• 焦点与键盘联动：在onFocusChanged中同步文本输入会话的焦点状态，并正确调用键盘控制器的显示/隐藏方法。
• 区分硬件/软键盘输入：硬件键盘事件仍通过onKeyEvent处理，软键盘输入由文本输入服务自动处理，无需手动拦截KeyEvent。

额外优化建议： #

• 如果不需要完全从零实现，推荐基于BasicTextField自定义外观，它已经内置了文本输入服务的绑定，只需自定义decorationBox即可，代码更简洁。
• 若需支持光标和文本选择，需在TextInputState中管理TextFieldValue的selection属性。

内容的提问来源于stack exchange，提问作者Atras VidA