SDK 升级说明

# SDK 升级说明

如果您当前集成的 SDK 版本低于 HBuilderX 版本，但是功能都正常的话可以选择不升级 SDK，按照这个文档添加配置可以屏蔽版本不一致的弹窗提示，框架正常情况都是向下兼容的，您也可以查看一下更新日志考虑是否升级 SDK；如果要升级可以更新离线sdk包下Bundles、inc、Libs目录下的文件。

# 注意事项

功能模块中的依赖库需要依赖基础模块的库，更新SDK版本时，需要将使用到的基础库和功能模块的依赖库及资源文件统一升级，如果仅升级部分库可能会导致版本不一致出现问题；建议做法，将 SDK 整个放到工程路径下，添加依赖库或文件的时候通过 选择本地文件的方式添加，下次升级的时候直接整个覆盖SDK目录即可，避免每次都需要单独去挑选所依赖的库；

SDK目录下的 /SDK/Bundles/PandoraApi.bundle/feature.plist，如果之前有修改过需要开发者自行备份,升级完SDK再次覆盖此文件,避免升级造成部分功能异常

离线SDK更新后编译报错，可根据报错信息查看离线相关模块依赖库是否有更新

若使用百度网盘下载后解压失败，请使用和彩云下载

# iOS 离线SDK - 正式版

# 2025年12月21日发布——HBuilderX（4.87.2025121004）

和彩云，提取码: h7g6

百度网盘，提取码: a6sb

更新高德地图 SDK 为 10.1.600 版，解决与其它插件一起打包可能编译失败的问题详情
更新一键登录依赖的个验 SDK 为 3.1.3.0 版，解决联通隐私协议链接地址失效的问题

历史版本，提取码: ax9u

历次更新日志

# iOS 离线SDK - Alpha版

# 2026年01月31日发布——HBuilderX（5.0.2026013113-alpha）

和彩云

百度网盘，提取码: t584

修复 mapContext.includePoints 调用不生效的Bug 详情
修复 input 组件设置 digit 属性光标调整失焦后数据错乱的Bug 详情
修复地图导航组件遮挡地理位置文字的Bug 详情
修复 editorContext.format 传递空 name 没有终止逻辑服务执行的Bug 详情
修复 input 组件快速输入导致失焦的Bug 详情
修复下拉刷新和 Swiper 组件滑动卡住的Bug 详情
新增支持配置 Swift Package Manager（SPM）依赖文档 https://issues.dcloud.net.cn/pages/issues/detail?id=22374
修复 uni-app兼容模式组件仅包含app-ios平台时，云打包未包含该组件详情
修复云端打包部分情况可能没有包含uts插件配置 CocoaPods 依赖的动态库详情