WordPress-Android 移动端编辑器工具栏遮挡问题解析

问题现象

在 WordPress-Android 移动应用中，当用户使用 Google 键盘输入内容时，编辑器工具栏会被键盘遮挡而不可见。这一现象主要出现在 Pixel 7a 设备上，运行 Android 15 系统，搭配特定版本的 Google 键盘（14.9.07.696880419-release-arm64-v8a157445426）。

技术背景

移动端富文本编辑器在 Android 平台上的实现面临诸多挑战，特别是在处理软键盘与界面元素的交互方面。当软键盘弹出时，系统需要正确处理窗口尺寸变化，并调整界面布局以避免重要控件被遮挡。

问题根源

经过分析，该问题主要源于以下几个方面：

1. 窗口调整模式不匹配：Android 系统提供了多种窗口调整模式（adjustResize、adjustPan 等），当前配置可能未能正确处理键盘弹出时的布局变化。

2. 工具栏定位逻辑缺陷：编辑器工具栏的定位逻辑可能没有充分考虑键盘弹出时的可视区域变化。

3. 特定设备/键盘兼容性问题：某些设备厂商或输入法可能对标准 Android 行为进行了定制，导致预期外的交互效果。

解决方案

开发团队已经通过以下方式解决了该问题：

1. 优化窗口调整策略：改进了 Activity 的 windowSoftInputMode 配置，确保键盘弹出时界面能正确调整。

2. 动态工具栏定位：实现了更智能的工具栏定位逻辑，能够根据当前键盘状态动态调整位置。

3. 增强兼容性处理：增加了对不同设备/输入法特殊行为的检测和处理逻辑。

更新情况

修复已包含在 WordPress-Android 25.7.1 版本中，该版本于 3月5日发布，并采用分阶段推送策略：

• 3月8日：向25%用户推送
• 3月11日：完成100%用户推送

开发者建议

对于遇到类似问题的开发者，建议：

1. 全面测试应用在不同设备和输入法下的表现
2. 使用 Android 的 WindowInsets API 正确处理键盘交互
3. 考虑实现自定义的键盘监听和布局调整逻辑
4. 在发布前进行分阶段测试，确保修复效果

该问题的解决体现了 WordPress 移动团队对用户体验的持续优化和对技术细节的深入把控。