# uni-app x Android原生SDK
# 说明
- 从HBuilderX 4.81-alpha版开始，为了适配Kotlin版本，对gradle插件做了升级，升级SDK时需要替换原有插件。插件配置及说明参考文档。
注意：蒸汽模式的离线sdk需 uni-app x 5.25+
# 正式版
# 5.26.2026091802
- 更新uni-app离线打包支持，需使用HBuilderX（5.26.2026091802）版本生成本地打包App资源。
- 新增 API uni.onAppRoute、uni.onBeforeAppRoute、uni.rewriteRoute 支持页面路由监听及重写 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31599
- 变更 组件 rich-text 使用 user-select 属性替代 selectable 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31518
- 优化 API uni.showLoading 调整背景透明度与消息提示框相同 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31614
- 蒸汽模式 新增 组件 表单相关组件适配暗黑模式 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31289
- 修复 编译器 蒸汽模式下独立 .ts 文件中调用支持摇树的 uni API 时，云打包后的基座提示缺少对应模块 详情
- 优化 API uni.createVideoContext playbackRate 设置播放倍速的取值范围 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32253
- 修复 组件 video 点击进度条跳转后 controls 自动隐藏定时器未重置 详情
- 新增 API 广告 美数渠道 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32000
- 新增 API uni.requestSystemPermission 主动申请系统权限 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31823
- 新增 发行 云打包支持自适应图标 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=29277
- 优化 API push 申请系统通知权限逻辑 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31815
- 修复 组件 view dialogPage 中 view 全屏后和 dialogPage 显示重叠 详情
- 修复 组件 video 在 dialogPage 中不显示播放控制按钮 详情
- 修复 组件 video 在 dialogPage 中无法退出全屏 详情
- 蒸汽模式、VDOM模式 修复 组件 input maxlength 属性支持字符串类型 详情
- 蒸汽模式 新增 vue 内置组件Teleport 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=30782
- 蒸汽模式 新增 pages.json 支持配置页面滚动相关属性 enableBackToTop、bounces、androidOverscroll 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32082
- 蒸汽模式 新增 组件 list-view 支持scroll-into-view跳转到item、header或section 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31678
- 蒸汽模式 新增 组件 list-view 支持滚动锚定特性 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31833
- 蒸汽模式 新增 组件 list-view 支持默认显示到底部 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32464
- 蒸汽模式 新增 组件 waterflow 支持通过scroll-into-view跳转到flow-item 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31974
- 蒸汽模式 新增 组件 web-view 支持 associative-container 属性 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32177
- 蒸汽模式 新增 CSS @media prefers-color-scheme 媒体查询，方便适配暗黑 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31052
- 蒸汽模式 新增 CSS 支持 direction 属性 设置文本方向 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31692
- 蒸汽模式 新增 CSS text-align 支持 justify 设置文字向两侧对齐 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31601
- 蒸汽模式 新增 CSS backdrop-filter 属性 实现毛玻璃效果 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31677
- 蒸汽模式 新增 scheme启动及获取参数，可实现直达 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32465 https://issues.dcloud.net.cn/pages/issues/detail?id=32459 https://issues.dcloud.net.cn/pages/issues/detail?id=31788
- 蒸汽模式 新增 devTools 支持元素、网络、存储审查 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31885
- 蒸汽模式 新增 离线原生 SDK 集成 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32417
- 蒸汽模式 新增 uni统计2.0 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32445
- 蒸汽模式 修复 组件 swiper 大小发生变化后没有自动计算布局 详情
- 蒸汽模式 修复 组件 list-view 部分情况下记录的sticky-section顺序异常导致界面错乱 详情
- 蒸汽模式 修复 组件 list-view 清空list-item时占位高度没消失 详情
- 蒸汽模式 修复 组件 list-view 追加数据后视口出现空白，滚动后恢复 详情
- 蒸汽模式 修复 组件 text 嵌套子text上使用不支持的样式时编译报错 详情
- 蒸汽模式 修复 组件 scroll-view 容器或内容变化引发的滚动不会触发scrollend事件 详情
- 蒸汽模式 修复 组件 list-view list-item高度变成0时未重排后续item位置 详情
- 蒸汽模式 修复 组件 list-view initial-scroll-bottom属性部分情况下未将初始位置滚动到底部 详情
- 蒸汽模式 修复 组件 list-view 滚动期间及滚动结束瞬间概率出现闪烁 详情
- 蒸汽模式 修复 组件 list-view 开启 scroll-anchoring 后追加消息可能出现白屏 详情
- 蒸汽模式 修复 CSS useComputedStyle 支持 css 变量。同时基于useComputedStyle的input、textarea、loading也支持了css变量 详情
- 蒸汽模式 修复 CSS 变量的 !important 不生效 详情
- 蒸汽模式 修复 组件 canvas lineDashOffset值超过50就不会有变化 详情
- 蒸汽模式 修复 组件 canvas 性能优化 详情
- 蒸汽模式 优化 框架快照化以提升应用启动速度 详情
- 蒸汽模式 优化 so 库导出符号表以减少安装包大小 详情
- 蒸汽模式 新增 组件 scroll-view 支持 android-refresher-color 属性设置下拉刷新雪花前景颜色 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32104
- 蒸汽模式 修复 vue 动态插槽中包含组件时编译失败 详情
- 蒸汽模式 修复 组件 text 嵌套 text 上使用 v-if 或 v-for 时可能无法显示 详情
- 蒸汽模式 修复 组件 rich-text 设置 translateY 后可能内容显示不完整 详情
- 蒸汽模式 修复 组件 image 没有设置 fade-show 加载网络图片首次显示会有渐变动画效果 详情
- 蒸汽模式 修复 组件 Click 事件 中调用 uni.closeDialogPage 引起应用崩溃 详情
- 蒸汽模式 修复 组件 view 元素设置为拍平后，非拍平的子元素显示位置可能不正常 详情
- 蒸汽模式 修复 组件 scroll-view direction设置为 all 时上下滑动可能与父的 bounces 效果冲突 详情
- 蒸汽模式 修复 组件 rich-text mode 为 native 流式绘制列表加载闪烁 详情
- 蒸汽模式 修复 组件 rich-text mode 为 native 流式绘制表格、代码块时闪烁 详情
- 蒸汽模式 修复 组件 native-view 动态添加原生子 View 可能无法显示 详情
- 蒸汽模式 修复 组件 native-view 截图如果页面存在拍平元素可能报错 详情
- 蒸汽模式 修复 组件 native-view 设置 fixed 定位后无法通过 v-if 删除 详情
- 蒸汽模式 修复 组件 input 去掉拼写检查的红色下划线 详情
- 蒸汽模式 修复 组件 input 设置padding时，下沿被裁 详情
- 蒸汽模式 修复 组件 input 自动聚焦时，光标位置错误 详情
- 蒸汽模式 修复 组件 video 在 list-view 中快速滚动 src 设置错乱 详情
- 蒸汽模式 修复 组件 canvas createImage 无法共用 详情
- 蒸汽模式 修复 组件 canvas 2D fillStyle 设置 rgba 透明度（alpha）无效 详情
- 蒸汽模式 修复 API uni.exit 执行 redirectTo 后可能无法正常退出显示白屏 详情
- 蒸汽模式 修复 API uni.previewImage 当图片格式为SVG时会变形 详情
- 蒸汽模式 修复 API uni.showModal 成功回调内调用 navigateBack 崩溃 详情
- 蒸汽模式 修复 CSS overflow 安卓蒸汽模式 某些场景，定位层中的滚动组件无法滚动 详情
- 蒸汽模式 修复 CSS border border-bottom、border-right 某些情况可能被子元素覆盖 详情
- 蒸汽模式 修复 CSS transition 多元素执行transition时不同步导致闪烁 详情
- 蒸汽模式 修复 CSS transition 无单位长度值参与 transition 时，动画目标值被错误归零 详情
- 蒸汽模式 修复 CSS transform transition 动画未结束时设置新 transform 值不生效 详情
- 蒸汽模式 修复 UniPage API 部分设备 pageBody 取值不正确 详情
- 蒸汽模式 修复 DOM API UniElement 关闭页面时可能引起应用崩溃 详情
- 新增 uni-ui x uni-tab 支持毛玻璃效果 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32439
- 新增 uni-ai x 适配蒸汽模式，高性能的AI流式聊天 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32450
- 蒸汽模式 优化 uts插件通道通信性能 详情
- 蒸汽模式 新增 UTSAndroid.destroyInstance 注销JS层引用的原生对象 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32198
- 蒸汽模式 修复 uts插件向JS返回数据对象时，部分数据为空值 详情
- 蒸汽模式 修复 字面量.toFloat方式声明的变量被编译为了Number类型 详情
# alpha版
# 5.31.2026093010-alpha
- 更新uni-app离线打包支持，需使用HBuilderX（5.31.2026093010-alpha）版本生成本地打包App资源。
- 蒸汽模式 新增 uasm插件 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=17204
- 蒸汽模式 新增 vue 支持 lang="ts" 和 lang="js" 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31884
- 新增 API toast 允许设置是否与页面绑定 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32914
- 新增 API uni.getFileSystemManager 支持 unzipSync 同步解压zip文件 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32516
- 新增 API uni.getFileSystemManager getFileInfo 支持计算 sha256 摘要 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32932
- 新增 UniPage API TabBar 页面支持 onTabItemTap 生命周期 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32343
- 修复 pages.json TabBar 未配置 selectedColor 时显示有误 详情
- 修复 API uni.navigateBack 自定义基座且未使用 uni.hideLoading 时调用 uni.navigateBack 报错 uni-showLoading not found 详情
- 修复 API uni.onPushMessage 回调首次执行后被释放 详情
- 新增 组件 map 更新腾讯地图 sdk 为 6.18.0 版，适配支持 16KB 内存页面大小 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32831
- 新增 API push 更新个推 SDK 为 3.3.15 版，适配支持 16KB 内存页面大小 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=33091
- 修复 组件 video 部分折叠屏设备上首帧闪烁 详情
- 修复 API uni.getFileSystemManager unzip 解压部分zip文件可能失败 详情
- 修复 API uni.startFacialRecognitionVerify 更新阿里云金融级实人认证SDK为 2.3.52 版，适配支持 16KB 内存页面大小 详情
- 修复 DOM API UniElement 分屏模式下调用 requestFullscreen 显示异常 详情
- 蒸汽模式 新增 pages.json 支持配置 backgroundTextStyle 属性 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32612
- 蒸汽模式 新增 组件 text 支持 CSS 样式 word-break 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32705
- 蒸汽模式 新增 CSS animation 及 @keyframes 关键帧动画 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31169
- 蒸汽模式 新增 CSS calc 支持数学计算样式 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32256
- 蒸汽模式 新增 DOM API UniElement 支持 attributes 返回当前元素上所有属性元素的集合 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32488
- 蒸汽模式 修复 vue 组合使用v-for v-if时部分情况编译报错 详情
- 蒸汽模式 修复 vue Teleport 包含 slot 时的字节码编译错误 详情
- 蒸汽模式 修复 vue 组件插槽中空文本节点被丢弃的问题 详情
- 蒸汽模式 修复 5.26版本引发的 组件 list-view 滚动锚定、初始滚动到底部功能触发滚动时概率出现闪烁 详情
- 蒸汽模式 修复 组件 list-view 部分情况下list-item尺寸变化引发重排导致界面空白 详情
- 蒸汽模式 修复 组件 rich-text nodes 使用节点列表数据类型时 text 中存在特殊字符会导致原生渲染下无法显示 详情
- 蒸汽模式 修复 组件 rich-text list-view 内 native rich-text 折叠展开后内容不显示 详情
- 蒸汽模式 修复 CSS page标签选择器背景色生效时机 详情
- 蒸汽模式 修复 CSS var自定义变量 组件中使用 useComputedStyle 后动态更新 class 中的 var 样式不生效 详情
- 蒸汽模式 新增 API uni.installWgt 支持应用资源热更新 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=32098
- 蒸汽模式 新增 UniApp API 支持 restart 重启应用 文档 https://issues.dcloud.net.cn/pages/issues/detail?id=31806
- 蒸汽模式 修复 API uni.setTabBarStyle setTabBarStyle 未传文字颜色时重置 TabBar 文字颜色 详情
- 蒸汽模式 修复 组件 input dialogPage 中输入框聚焦页面上推后，键盘收起页面位置未恢复 详情
- 蒸汽模式 修复 API themeChange 切换主题与动态组件冲突导致闪退 详情
- 蒸汽模式 修复 manifest.json 安卓端蒸汽模式设置横屏跳转页面问题 详情
- 蒸汽模式 修复 组件 scroll-view 设置 refresher-enabled 为 true 开启下拉刷新后 v-if 切换节点出现旧视图残留叠加 详情
- 蒸汽模式 修复 组件 list-view 打开页面获取数据后偶现整个列表变空白 详情
- 蒸汽模式 修复 组件 rich-text mode 为 native, 大屏幕设备可能文字渲染毛刺 详情
- 蒸汽模式 修复 组件 native-view 特定情况下 init 事件可能不触发 详情
- 蒸汽模式 修复 组件 input onLoad 发起 request 请求后赋值偶现不显示 详情
- 蒸汽模式 修复 组件 image svg 格式图片设置 fade-show 为 true 无效果 详情
- 蒸汽模式 修复 组件 canvas v-if 切换后再访问原 CanvasContext 引发异常 详情
- 蒸汽模式 修复 API uni.showLoading 页面销毁的过程中loading偶现异常 详情
- 蒸汽模式 修复 API uni.hideLoading 配置动画类型后无法关闭加载框 详情
- 蒸汽模式 修复 API uni.getWindowInfo 分屏模式下获取到的安全区域信息不正确 详情
- 蒸汽模式 修复 API uni.onPushMessage requestPermission 参数默认值错误 详情
- 蒸汽模式 修复 CSS z-index 偶发不生效导致元素被遮挡 详情
- 蒸汽模式 修复 CSS box-shadow 渲染区域拦截点击事件导致低 z-index 元素无法响应点击 详情
- 蒸汽模式 修复 CSS var自定义变量 退出应用后新进入 --status-bar-height 可能失效 详情
- 蒸汽模式 修复 DOM API UniElement 使用 rpx 样式时页面尺寸变化可能引发闪退 详情
- 蒸汽模式 修复 运行调试 app后台状态下热更新崩溃 详情
- VDOM模式 修复 CSS var自定义变量 padding 使用 var 情况下简写不生效 详情
