外接键盘连接时，如何在Jetpack Compose中强制显示软键盘？

一、设备级设置（无需修改应用） #

部分Android设备自带强制显示软键盘的选项，即使连接了物理键盘也能生效：

• 进入系统「设置」→「语言和输入法」（部分设备路径为「更多设置」→「语言与输入法」）
• 找到「物理键盘」相关设置项
• 开启「显示屏幕键盘」（不同厂商命名可能略有差异，比如部分设备叫「强制显示软键盘」）

二、应用级全局处理（无需逐个修改TextField） #

方法1：Activity全局配置 #

在你的Activity的onCreate方法中添加代码，通过Android原生API强制触发软键盘：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    // 配置Window属性，确保软键盘可显示
    window.setSoftInputMode(
        WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE or
        WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE
    )
    
    // 监听全局焦点变化，文本输入控件获焦时强制弹出软键盘
    window.decorView.viewTreeObserver.addOnGlobalFocusChangeListener { _, newFocus ->
        if (newFocus is EditText) {
            val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
            // SHOW_FORCED 参数忽略物理键盘状态，强制显示软键盘
            imm.showSoftInput(newFocus, InputMethodManager.SHOW_FORCED)
        }
    }
    
    setContent {
        // 你的Compose布局内容
    }
}

方法2：Compose全局焦点监听 #

在Compose的根主题或根布局中添加全局监听，自动处理所有TextField的软键盘显示：

@Composable
fun AppTheme(
    content: @Composable () -> Unit
) {
    val focusManager = LocalFocusManager.current
    val context = LocalContext.current
    
    LaunchedEffect(focusManager.focusedChild) {
        val focusedNode = focusManager.focusedChild
        if (focusedNode != null) {
            val imm = context.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
            // 找到焦点对应的底层EditText
            val view = focusedNode.findView()
            if (view is EditText) {
                imm.showSoftInput(view, InputMethodManager.SHOW_FORCED)
            }
        }
    }
    
    MaterialTheme(
        // 你的主题配置参数
    ) {
        content()
    }
}

原代码无效原因 #

你之前的代码仅调用了Compose的keyboardController?.show()，但系统检测到外接键盘时会优先使用物理输入，忽略软键盘请求。使用Android原生InputMethodManager的SHOW_FORCED参数可以绕过这个限制，强制触发软键盘。

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