基于KeyboardKit的键盘扩展中textDidChange(_:)方法触发异常

问题描述 #

基于KeyboardKit开发的键盘扩展里，textDidChange(_:)方法触发逻辑异常：仅在输入框为空时连续按两次退格键才会触发，常规打字（添加字符、删除非空内容）时完全不响应。预期该方法应在文本内容任意变化时被调用，但目前仅满足上述特殊场景。

已完成的排查步骤 #

• 确认键盘扩展内文本插入、删除的逻辑处理无错误
• 检查键盘状态及交互流程，确保与输入框的通信正常
• 排查KeyboardKit配置中可能影响文本变更事件的相关设置

可能的解决方向 #

1. 校验KeyboardInputViewController的代理与生命周期
   确保自定义键盘VC正确继承KeyboardInputViewController，未重写或干扰父类的textDidChange(_:)事件转发逻辑。自定义VC时若意外覆盖父类事件处理逻辑，会导致事件丢失。

2. 检查文本操作的标准流程
   若手动处理文本插入/删除（如调用textDocumentProxy.insertText(_:)或textDocumentProxy.deleteBackward()），需确认未绕过系统标准文本代理流程修改内容。KeyboardKit依赖系统文本事件转发，非标准操作会导致textDidChange(_:)无法触发。

3. 验证KeyboardKit事件监听配置
   检查是否在VC初始化阶段正确注册文本变更监听，例如在viewDidLoad中添加：

   keyboardContext.textDocumentProxy.addTextDidChangeObserver(self)
   

   同时确认KeyboardContext未禁用文本事件通知，部分版本的KeyboardKit需手动开启事件监听，注意版本兼容性。

4. 排查系统权限与键盘活跃状态
   确保键盘扩展已获取「完全访问权限」（若业务需要），权限不足会导致部分文本事件无法正常触发。可尝试切换至其他键盘再切回，测试事件是否恢复正常。

5. 最小化Demo测试定位
   创建极简KeyboardKit键盘项目，仅保留textDidChange(_:)基础实现，验证是否能正常触发。若极简版本正常，再逐步加入业务代码，定位干扰事件触发的逻辑模块。

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