Flutter开发：如何解决vivo安全键盘遮挡密码输入框问题？

以下是针对该问题的几种可行解决方案，按优先级排序：

• 动态监听键盘高度并调整布局
  部分机型的系统键盘高度回调存在延迟或不准确的情况，可手动通过MediaQuery获取键盘高度，动态调整输入区域的padding或滚动位置：

  Widget build(BuildContext context) {
    final keyboardHeight = MediaQuery.of(context).viewInsets.bottom;
    return Scaffold(
      body: SingleChildScrollView(
        padding: EdgeInsets.only(bottom: keyboardHeight),
        child: Column(
          children: [
            // 你的表单输入框组件
            TextField(decoration: InputDecoration(hintText: "测试输入框")),
            // 其他表单元素
          ],
        ),
      ),
    );
  }
  

• 升级Flutter到最新稳定版
  部分旧版Flutter对vivo安全键盘的适配存在bug，建议升级到最新稳定版本（如3.10+），官方后续版本可能修复了这类机型特定的兼容性问题。

• 使用第三方键盘监听插件
  若系统自带的MediaQuery监听不准确，可使用flutter_keyboard_visibility插件更精准地监听键盘状态：

  import 'package:flutter_keyboard_visibility/flutter_keyboard_visibility.dart';
  
  Widget build(BuildContext context) {
    return KeyboardVisibilityBuilder(
      builder: (context, isKeyboardVisible) {
        final padding = isKeyboardVisible ? 200.0 : 0.0; // 可根据实际情况调整
        return Scaffold(
          body: SingleChildScrollView(
            padding: EdgeInsets.only(bottom: padding),
            child: TextField(),
          ),
        );
      },
    );
  }
  

• 针对vivo机型做原生适配
  若上述方案无效，可通过Flutter MethodChannel调用Android原生代码获取安全键盘的真实高度：

  1. Android端代码（Kotlin）：

     class MainActivity : FlutterActivity() {
         private val CHANNEL = "com.example.keyboard_height"
     
         override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
             super.configureFlutterEngine(flutterEngine)
             MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
                 if (call.method == "getKeyboardHeight") {
                     val height = getKeyboardHeight()
                     result.success(height)
                 } else {
                     result.notImplemented()
                 }
             }
         }
     
         private fun getKeyboardHeight(): Int {
             val r = Rect()
             window.decorView.getWindowVisibleDisplayFrame(r)
             val screenHeight = window.decorView.rootView.height
             return screenHeight - r.bottom
         }
     }
     

  2. Flutter端调用：

     static const platform = MethodChannel('com.example.keyboard_height');
     
     Future<int?> getKeyboardHeight() async {
       try {
         final int result = await platform.invokeMethod('getKeyboardHeight');
         return result;
       } on PlatformException catch (e) {
         return null;
       }
     }
     

  拿到高度后动态调整输入区域的bottom padding即可。

• 临时排查方案：禁用vivo安全键盘
  可引导用户在系统设置中切换到普通键盘（如系统默认键盘或第三方键盘），确认是否为安全键盘的适配问题，此方案可作为临时 workaround，但建议优先采用前面的适配方案。

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