思源笔记Android端输入法遮挡工具栏问题分析与解决方案

问题背景

在思源笔记的Android客户端中，用户反馈当软键盘弹出时会遮挡底部的编辑工具栏。这一问题在荣耀Magic5至臻版（MagicOS 9系统）等设备上表现尤为明显，影响用户进行快捷格式编辑操作。

技术原理分析

Android系统的窗口管理机制中，软键盘（IME）作为独立窗口层叠在应用窗口之上。当Activity未正确配置windowSoftInputMode属性时，系统默认行为可能导致：

1. 窗口未自动调整布局
2. 关键UI元素未被推至可视区域
3. 不同厂商ROM对IME处理存在差异

解决方案演进

开发团队通过以下技术方案实现优化：

1. 窗口布局调整 在AndroidManifest.xml中配置：

android:windowSoftInputMode="adjustResize|stateHidden"

强制Activity在IME弹出时重新计算布局尺寸

2. 动态边距处理 通过监听ViewTreeObserver.OnGlobalLayoutListener实时检测键盘状态：

rootView.getViewTreeObserver().addOnGlobalLayoutListener(() -> {
    Rect visibleRect = new Rect();
    rootView.getWindowVisibleDisplayFrame(visibleRect);
    int heightDiff = rootView.getRootView().getHeight() - visibleRect.height();
    // 根据差值动态调整工具栏位置
});

3. 厂商适配优化 针对MagicOS等定制ROM增加特殊处理逻辑，通过反射获取系统实际IME高度

用户体验优化

最终实现效果：

• 工具栏随键盘弹出自动上移
• 过渡动画平滑无闪烁
• 支持横竖屏不同场景
• 兼容90%以上Android设备

开发者建议

对于类似问题的预防性开发：

1. 始终在真机测试IME交互
2. 使用ConstraintLayout等现代布局
3. 考虑全面屏手势区域影响
4. 建立厂商设备测试矩阵

该修复已包含在思源笔记最新稳定版中，用户可通过应用商店更新获取优化体验。