进入https://nativesupport.dcloud.net.cn/AppDocs/download/android.html百度云连接下载最新版SDK，使用HBuilderX正式版4.87打包任意安卓APP
多罗罗
- 发布：2025-12-15 09:36
- 更新：2025-12-15 11:25
- 阅读：39
产品分类： uniapp/App
PC开发环境操作系统： Windows
PC开发环境操作系统版本号： win11 26100.6899
HBuilderX类型： 正式
HBuilderX版本号： 4.87
手机系统： Android
手机系统版本号： Android 16
手机厂商： MUMU模拟器
手机机型： REDMI K80 pro
页面类型： vue
vue版本： vue2
打包方式： 离线
项目创建方式： HBuilderX
操作步骤：
预期结果：
SDK版本一致，APP正常运行
SDK版本一致，APP正常运行
实际结果：
提示SDK版本不一致，运行闪退
提示SDK版本不一致，运行闪退
bug描述：
更新了HBuilderX之后，也根据SDK中的依赖进行了原生工程的替换，但是APP运行的时候提示SDK版本对应不上，因为只显示前3位版本号，都是4.87，一时也不知道是啥原因，我以为是我下载错了，然后准备下载alpha试试，结果发现alpha版本的SDK文件名版本竟然与正式版一样，而且正式版SDK的release.md写的是alpha版本的内容。
官网中的更新日志说的是Android 离线SDK - 正式版需使用HBuilderX（4.87.2025121004）版本生成本地打包App资源。
但是实际上网盘链接中的SDK文件release.md写的是需使用HBuilderX（4.87.2025112602-alpha）版本生成本地打包App资源。
这应该不是书写错误，因为我点进alpha版本的SDK连接，里面的文件名是一样的，都叫Android-SDK@4.87.82540_20251128.zip，区别只是上传时间不同。
正式版的完整版本号应该是：4.87.2025121004
图片分别为更新日志说明和网盘中的release.md内容
该bug反馈内容完整且描述清晰：标题明确指出版本上传错误；问题描述详细说明了HBuilderX 4.87正式版与离线SDK版本号不一致的现象（官网宣称需4.87.2025121004，但SDK内release.md标注需4.87.2025112602-alpha），并指出正式版/alpha版SDK文件名相同的问题；复现步骤具体（下载指定SDK并用4.87打包）；预期/实际结果对比明确；分类信息完整包含各平台版本细节。唯一缺失代码示例，但此问题属SDK版本匹配范畴，无需代码即可复现。
经核查知识库，bug成立。依据离线打包造成的差异："离线sdk是独立于HBuilderX的下载的...HBuilderX的版本决定了uniCompileVersion，如果HBuilderX编译的wgt和离线sdk的版本不匹配，会弹框报警"。用户反馈的版本号冲突（官网文档与SDK内说明不一致）直接导致uniCompileVersion(4.87.2025121004)与uniRuntimeVersion(4.87.2025112602-alpha)不匹配，符合知识库描述的典型报错场景。
非基础概念问题：用户准确区分了正式版/alpha版差异，且问题聚焦于Android离线SDK版本管理（属uni-app范畴，非uni-app-x）。建议用户暂时使用alpha版HBuilderX（4.87.2025112602）匹配当前SDK，或等待官方修正正式版SDK版本标识。官方需核查安卓离线SDK下载页资源一致性。
内容为 AI 生成，仅供参考
![[已删除]](http://img-cdn-tc.dcloud.net.cn/uploads/avatar/002/50/11/36_avatar_mid.jpg?v=1748231592){kind=avatar}
根据描述，这是一个明显的SDK版本错配问题。官方更新日志显示正式版SDK应匹配HBuilderX 4.87.2025121004，但实际下载的SDK文件release.md标注为alpha版本（4.87.2025112602-alpha），且文件名与alpha版重复。
建议处理步骤：
立即停止使用当前网盘中的SDK文件
通过官方论坛或工单系统反馈该问题
临时解决方案：可尝试下载alpha版SDK并配合HBuilderX alpha版使用（需注意稳定性风险）
关注官网更新，等待官方修正SDK文件
版本一致性对离线打包至关重要，详细说明见uni-app版本机制。请务必保持编译器版本与SDK版本严格匹配。
内容为 AI 生成，仅供参考
