Cordova Android 应用保持沉浸模式并正确适配软键盘的完整解决方案
本文详解如何在 cordova android 应用中实现软键盘弹出/收起时持续维持沉浸式（immersive）体验，避免状态栏闪烁、界面错位，并确保输入框可见——核心在于正确配置 `android:windowsoftinputmode`。
在 Cordova 开发中，Android 平台常遇到一个典型问题：即使应用已启用沉浸模式（如通过 StatusBar.hide() 或 SystemUiOverlay.immersive()），一旦软键盘（Soft Input）弹出，系统会强制退出沉浸态——表现为状态栏短暂出现、底部出现黑边或“斜杠”（即系统 UI 恢复的视觉残留），键盘收起后也未能自动恢复沉浸状态；同时，页面未自动滚动，导致输入框被键盘遮挡，严重影响用户体验。
根本原因在于：Android 默认的 windowSoftInputMode 行为（如 "adjustResize" 或 "adjustPan" 缺失/配置不当）会触发 Activity 重绘和窗口布局调整，干扰 System UI 的沉浸控制流。而仅依赖 cordova-plugin-keyboard 的 hideFormAccessoryBar() 或 shrinkView() 等方法，无法覆盖底层窗口行为，因此无效。
✅ 正确解法是从原生层统一管控窗口与键盘交互逻辑：
-
修改 platforms/android/app/src/main/AndroidManifest.xml 文件（注意 Cordova 12+ 后路径为 app/src/main/，非旧版 AndroidManifest.xml 根目录）
找到 节点（通常为 android:name="MainActivity"），在其内部添加属性：
⚠️ 关键说明： adjustPan 表示当键盘弹出时，不调整 Activity 布局尺寸，而是平移（pan）当前视图，使焦点控件始终可见； 它避免了 adjustResize 引发的 onConfigurationChanged 触发、布局重绘及 StatusBar 自动显示，从而保全沉浸模式的连续性； 对 Cordova WebView 来说，adjustPan 更稳定兼容，尤其在未使用 ionic-webview 或自定义 viewport 的项目中。
-
配合 JavaScript 层增强控制（可选但推荐）
在 deviceready 后主动设置沉浸态，并监听键盘事件微调：
document.addEventListener('deviceready', () => {
// 确保启动即沉浸
if (window.StatusBar) {
StatusBar.hide();
}
if (window.cordova && window.cordova.plugins && window.cordova.plugins.Keyboard) {
cordova.plugins.Keyboard.hideKeyboardAccessoryBar(true);
// 注意：不调用 show() 或 disableScroll()，避免干扰 adjustPan
}
});
// 可选：键盘收起后再次确认沉浸（防御性）
document.addEventListener('keyboardDidHide', () => {
setTimeout(() => {
if (window.StatusBar) StatusBar.hide();
}, 100);
});? 注意事项：
- 修改 AndroidManifest.xml 后务必 重新构建 Android 平台：cordova platform rm android && cordova platform add android（或至少 cordova build android）；
- 若使用 cordova-android@12+，请检查 config.xml 中是否启用了 —— 该配置可替代手动改 Manifest，但需插件支持（推荐仍以 Manifest 为准）；
- adjustPan 不支持自动滚动到 input 上方，如需精准定位，建议结合 scrollIntoView({ behavior: 'smooth', block: 'nearest' }) 在 focus 事件中调用；
- 切勿混用 adjustResize + immersive，二者存在底层冲突，是导致“斜杠残留”的主因。
通过上述配置，你的 Cordova Android 应用即可实现：键盘弹出时界面平滑上移、输入框始终可见；键盘收起后状态栏无闪烁、沉浸模式无缝延续——真正达成“所见即所得”的沉浸式输入体验。
