# uni-app x Android原生SDK

# 说明

从HBuilderX 4.81-alpha版开始，为了适配Kotlin版本，对gradle插件做了升级，升级SDK时需要替换原有插件。插件配置及说明参考文档。

注意：蒸汽模式的离线sdk需 uni-app x 5.25+

# 正式版

# 5.26.2026091802

原生SDK(蒸汽模式)下载地址

原生SDK(VDOM模式)下载地址

更新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类型详情