Flutter中如何主动触发键盘弹出并通过RawKeyboard获取输入？

方案1：使用EditableText实现（兼容性最优） #

EditableText是TextField的底层核心组件，可隐藏后仅用来触发键盘唤起，不需要显示输入框UI。

实现步骤： #

• 定义FocusNode和TextEditingController实例用于控制输入焦点和文本内容
• 用Offstage包裹EditableText放到Widget树中隐藏，无任何视觉展示
• 点击目标元素时调用focusNode.requestFocus()即可唤起键盘
• 若需捕获原始按键事件，可在外层嵌套RawKeyboardListener监听

代码示例： #

// 提前声明控制对象
final FocusNode _focusNode = FocusNode();
final TextEditingController _controller = TextEditingController();

// build方法中插入隐藏的EditableText
@override
Widget build(BuildContext context) {
  return Column(
    children: [
      Offstage(
        offstage: true,
        child: EditableText(
          focusNode: _focusNode,
          controller: _controller,
          style: const TextStyle(),
          cursorColor: Colors.transparent,
          backgroundCursorColor: Colors.transparent,
        ),
      ),
      // 点击触发键盘唤起的目标元素
      GestureDetector(
        onTap: () {
          FocusScope.of(context).requestFocus(_focusNode);
        },
        child: const Text("点击此处唤起键盘"),
      ),
      // 如需监听原始按键，外层套RawKeyboardListener
      RawKeyboardListener(
        focusNode: _focusNode,
        onKey: (RawKeyEvent event) {
          if (event is RawKeyDownEvent) {
            debugPrint("按下按键：${event.logicalKey.keyLabel}");
          }
        },
        child: const Text("按键监听区域"),
      )
    ],
  );
}

// 页面销毁时释放资源
@override
void dispose() {
  _focusNode.dispose();
  _controller.dispose();
  super.dispose();
}

方案2：直接调用TextInput服务唤起（无额外组件依赖） #

直接调用系统文本输入通道，完全不需要依赖输入类Widget，灵活性最高，需要自行管理输入连接的生命周期。

代码示例： #

// 声明输入连接对象
TextInputConnection? _inputConnection;

// 主动唤起键盘方法
void _triggerKeyboard() {
  final inputConfig = TextInputConfiguration(
    inputType: TextInputType.text,
    textInputAction: TextInputAction.done,
  );
  // 初始化输入连接
  if (_inputConnection == null || !_inputConnection!.attached) {
    _inputConnection = TextInput.attach(
      _CustomInputClient(
        onTextUpdate: (text) => debugPrint("输入文本：$text"),
        onKeyCallback: (event) {
          debugPrint("原始按键事件：$event");
          return KeyEventResult.ignored;
        },
        onConnectionClose: () => _inputConnection = null,
      ),
      inputConfig,
    );
  }
  _inputConnection!.show();
  _inputConnection!.setEditingState(const TextEditingValue(text: ""));
}

// 自定义输入回调处理类
class _CustomInputClient implements TextInputClient {
  final Function(String text) onTextUpdate;
  final Function(KeyEvent event) onKeyCallback;
  final VoidCallback onConnectionClose;

  _CustomInputClient({
    required this.onTextUpdate,
    required this.onKeyCallback,
    required this.onConnectionClose,
  });

  @override
  void updateEditingValue(TextEditingValue value) => onTextUpdate(value.text);

  @override
  void performAction(TextInputAction action) {
    if (action == TextInputAction.done) {
      _inputConnection?.close();
      _inputConnection = null;
    }
  }

  @override
  void connectionClosed() => onConnectionClose();

  @override
  KeyEventResult onKeyEvent(KeyEvent event) => onKeyCallback(event);

  // 其余无需用到的方法留空实现即可
  @override
  AutofillScope? get currentAutofillScope => null;
  @override
  TextEditingValue? get currentTextEditingValue => null;
  @override
  void updateFloatingCursor(RawFloatingCursorPoint point) {}
  @override
  void showAutocorrectionPromptRect(int start, int end) {}
  @override
  void performPrivateCommand(String action, Map<String, dynamic> data) {}
  @override
  void insertTextPlaceholder(Size size) {}
  @override
  void removeTextPlaceholder() {}
  @override
  void showToolbar() {}
  @override
  void didChangeInputControl(TextInputControl? oldControl, TextInputControl? newControl) {}
  @override
  void insertContent(KeyboardInsertedContent content) {}
  @override
  void performSelector(String selectorName) {}
}

// 页面销毁时关闭连接
@override
void dispose() {
  _inputConnection?.close();
  super.dispose();
}

注意事项 #

• 优先选择方案1实现，系统兼容性更高，适配绝大多数Android/iOS版本
• 所有控制对象、连接对象需要在页面销毁时主动释放，避免内存泄漏
• 部分自定义系统的软键盘唤起需要依赖文本输入上下文，不推荐直接使用无上下文的RawKeyboardListener单独唤起键盘

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