更新记录

1.0.1（2026-07-30）

修改包名

1.0.0（2026-07-30）

• 初始版本发布。
• 提供 Android adjustResize 软键盘黑屏、黑闪兜底修复 API initKeyboardFix()。
• 支持在 App.vue 或会话页面中一键初始化，消除键盘弹起/收起瞬间的空白帧与黑闪。

平台兼容性

uni-app(4.87)

uni-app x(4.87)

其他

Android adjustResize 软键盘黑屏黑闪修复 UTS 插件 (keyboard-fix)

📌 插件简介

在 Android App 开发中，当页面设置软键盘模式为 adjustResize（例如聊天会话页、包含输入框的列表页），软键盘弹起或收起瞬间，Android 系统重新计算 Activity Window 尺寸时容易产生 黑屏、闪烁或空白帧 问题。

🚀 兼容平台与技术栈

• 支持平台：Android App（Android 5.0+）
• 技术规范：UTS (uni-app / uni-app x)
• 依赖说明：纯原生 API 实现，无第三方库依赖，零体积开销。

💡 快速使用

1. 引入并初始化

推荐在应用入口 App.vue 的 onLaunch、onShow 生命钩子中，或在需要的聊天页面 onLoad 中调用：

import { initKeyboardFix } from '@/uni_modules/keyboard-fix'

// #ifdef APP-PLUS
// 初始化软键盘黑闪兜底修复
initKeyboardFix()
// #endif

2. 在页面中的最佳实践（以聊天会话页为例）

<script setup>
import { onMounted } from 'vue'
import { initKeyboardFix } from '@/uni_modules/keyboard-fix'

onMounted(() => {
  // #ifdef APP-PLUS
  initKeyboardFix()
  // #endif
})
</script>
注意：第二种可能会引发应用后台切回来后，失效问题，建议使用方案1。

⚙️ API 接口说明

提示：iOS 平台内部已提供空实现防错处理，支持跨端无缝直接调用。

📜 更新日志

• v1.0.0 (2026-07-30)
  • 初始版本发布
  • 提供 Android adjustResize 软键盘黑屏黑闪兜底修复能力