Flutter 鸿蒙化实战keyboard_actions 适配 OpenHarmony## 前言随着鸿蒙生态的快速发展越来越多的 Flutter 应用需要适配 OpenHarmony 平台。但生态早期大量常用三方库只有 Android / iOS 实现鸿蒙侧只能自己造轮子。为了解决这个问题CPF-Flutter 社区对一批高频使用的 Flutter 三方库做了 OpenHarmony 平台适配统一托管在 GitCode 的CPF-Flutter 组织 下全部通过 TAG 版本隔离、配套门禁编译验证开箱即用。本篇是系列文章之一主角是keyboard_actions—— 键盘工具栏插件。## keyboard_actions 是什么keyboard_actions原库 4.2.0为表单输入框提供一套键盘增强能力常见于 iOS 风格的键盘上方工具栏 / 完成按钮-键盘工具栏在键盘上方显示自定义工具条上一个/下一个/完成按钮等-多输入框联动多个TextField间上一个/下一个自动聚焦切换-完成按钮收起键盘方便表单收尾。典型场景登录/注册、搜索、多字段表单等需要引导用户完成输入并切换焦点的页面。## 适配情况| Flutter 框架版本 | TAG 名称 | 分支名 || — | — | — || 3.7 | 4.2.0-ohos-1.0.0 | master || 3.22 | 4.2.0-ohos-1.0.0 | master || 3.27 | 4.2.0-ohos-1.0.0 | master || 3.35 | 4.2.0-ohos-1.0.0 | master |已验证环境3.35 为例Flutter 3.35.8-ohos-0.0.1SDK 6.0.1(21)DevEco Studio 6.0.1.260ROM 6.0.0.120 SP6。## 快速接入在 pubspec.yaml 中添加 git 依赖yamldependencies: keyboard_actions: git: url: https://gitcode.com/CPF-Flutter/fluttertpc_keyboard_actions.git # 按你的 Flutter 框架版本从上方映射表选择对应 TAG ref: 4.2.0-ohos-1.0.0执行bashflutter pub get## 使用示例### 为输入框配置键盘工具栏dartimport package:flutter/material.dart;import package:keyboard_actions/keyboard_actions.dart;class LoginPage extends StatefulWidget { const LoginPage({super.key}); override StateLoginPage createState() _LoginPageState();}class _LoginPageState extends StateLoginPage { final FocusNode _usernameFocus FocusNode(); final FocusNode _passwordFocus FocusNode(); late final KeyboardActionsConfig _config KeyboardActionsConfig( actions: [ // 账号输入框下一个 → 跳密码框 KeyboardActionsItem( focusNode: _usernameFocus, displayCloseWidget: false, nextFocusNode: _passwordFocus, ), // 密码输入框显示完成 KeyboardActionsItem( focusNode: _passwordFocus, displayCloseWidget: true, onClose: () FocusScope.of(context).unfocus(), ), ], ); override void dispose() { _usernameFocus.dispose(); _passwordFocus.dispose(); super.dispose(); } override Widget build(BuildContext context) { return Scaffold( appBar: AppBar(title: const Text(登录)), body: KeyboardActions( config: _config, child: Column( children: [ TextField(focusNode: _usernameFocus, decoration: const InputDecoration(labelText: 账号)), TextField(focusNode: _passwordFocus, decoration: const InputDecoration(labelText: 密码)), ], ), ), ); }}### 自定义工具栏dartKeyboardActionsConfig( actions: [ KeyboardActionsItem( focusNode: focusNode, footerBuilder: (context, config) KeyboardToolBar( config: config, children: [ const Text(自定义操作), const SizedBox(width: 12), KeyboardToolBarAction(text: 完成, onPressed: () FocusScope.of(context).unfocus()), ], ), ), ],)## API 支持一览| API | 说明 | ohos 支持 || — | — | — || KeyboardActions | 包裹输入框并注入键盘行为 | yes || KeyboardActionsConfig | 键盘行为配置 | yes || KeyboardActionsItem | 单个输入框的配置项 | yes || KeyboardToolBar | 自定义键盘工具栏 | yes | [!TIP] ohos Support 为 yes 表示鸿蒙平台支持该能力使用方式与 iOS / Android 保持一致。## 仓库地址- OpenHarmony 适配仓库https://gitcode.com/CPF-Flutter/fluttertpc_keyboard_actions- 使用问题反馈请到 CPF-Flutter 社区 Issues 提交问题社区统一收集跟进本仓库 Issues 区亦可。## 系列预告截至目前CPF-Flutter 社区已完成250 个Flutter 三方库的 OpenHarmony 平台适配覆盖权限管理、UI 组件、设备信息、位置服务、媒体处理、网络、支付等多个领域完整的适配清单含每个库的版本映射表见-适配总览文档https://gitcode.com/CPF-Flutter/docs/blob/main/ThirdpartyLibrarites.md-仓库组织https://gitcode.com/CPF-Flutter本系列后续会陆续挑选高频库展开讲解比如支付宝支付tobias、JS 桥接flutter_jsbridge_plugin、User-Agentfk_user_agent、设备信息device_util等。如果你的 Flutter 应用正在计划适配鸿蒙欢迎关注 CPF-Flutter 组织也欢迎参与共建。
