Flutter无TextField时如何调出移动端屏幕键盘？

你遇到的问题是直接调用SystemChannels.textInput.invokeMethod('TextInput.show')无效，原因是必须先向Flutter的文本输入系统注册一个输入客户端会话，单独调用show方法没有对应的会话目标，所以不会触发软键盘。

解决步骤 #

1. 提前初始化FocusNode和TextInputConnection对象
2. 触发焦点请求后，创建并激活文本输入连接
3. 调用显示键盘的方法，收起时关闭连接或调用hide方法

修改后的代码示例 #

FocusNode _keyboardFocusNode = FocusNode();
TextInputConnection? _textInputConnection;

void handleTap(PointerDownEvent pointerDownEvent) {
  // 请求焦点
  _keyboardFocusNode.requestFocus();

  // 初始化文本输入连接
  if (_textInputConnection == null || !_textInputConnection!.attached) {
    _textInputConnection = TextInput.attach(
      _keyboardFocusNode,
      const TextInputConfiguration(
        // 配置输入类型，比如普通文本
        inputType: TextInputType.text,
        // 可按需设置其他参数，比如是否启用自动修正
        autocorrect: true,
      ),
    );
    // 显示软键盘
    _textInputConnection!.show();
  } else {
    // 连接已存在时直接显示键盘
    _textInputConnection!.show();
  }

  print("In callback");
}

// 收起键盘的方法
void dismissKeyboard() {
  _textInputConnection?.close();
  _textInputConnection = null;
  _keyboardFocusNode.unfocus();
}

关键说明 #

• TextInput.attach方法会建立与系统文本输入通道的连接，这是调用show()的必要前提
• 无需实际渲染TextField，只要持有有效的FocusNode和TextInputConnection就能触发软键盘
• iOS模拟器上需确保已取消「硬件键盘」选项（你已完成此操作，无需额外调整）
• 页面销毁时记得调用dismissKeyboard()释放资源，避免内存泄漏

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