z***@163.com
z***@163.com
  • 发布:2026-10-22 08:54
  • 更新:2026-10-22 10:54
  • 阅读:73

【离线打包】标准 uni-app 5.26 iOS 离线 SDK 编译 UTS 插件编译报 module 'DCloudUniappRuntime' not found

分类:uni-app

环境

  • HBuilderX:5.26.2026091802
  • 导出类型:标准 uni-app(非 uni-app x / VDOM)iOS 离线打包工程
  • 集成方式:CocoaPods(uniapp.podspec)
  • 真机:iOS 17
  • 已集成 UTS 插件:unimoduleUtsZjhtpay(支付)

现象
pod install 后 Xcode 真机编译 unimoduleUtsZjhtpay 失败:
module 'DCloudUniappRuntime' not found
Unable to resolve module dependency: 'DCloudUniappRuntime'
依赖链:unimoduleUtsZjhtpay → import DCloudUTSExtAPI → import DCloudUniappRuntime

根因定位

  1. DCloudUTSExtAPI.xcframework 的模块接口硬依赖 DCloudUniappRuntime:
    • Modules/.../arm64-apple-ios.swiftinterface 第24行:import DCloudUniappRuntime
    • 公开接口引用 DCloudUniappRuntime.UTSComponent / UniProvider / UTSiOSHookProxy / UniPage / UniEvent 等上百处
    • Headers/DCloudUTSExtAPI-Swift.h:@import DCloudUniappRuntime;
    • 二进制 otool -L 弱链接 DCloudUniappRuntime.dylib
  2. 但标准 5.26 离线 SDK 的 SDK/Libs/ 下没有 DCloudUniappRuntime.framework / .xcframework
    (DCUniBase、DCloudUTSFoundation、DCloudUTSExtAPI 都在,唯独缺它)
  3. DCUniBase.framework、DCloudUTSFoundation.framework 内均无 UTSComponent / HTTPMethod / UniIpaType / UNILogDebug 符号,
    确认只有 DCloudUniappRuntime 提供这些符号。

请求
请提供标准 uni-app 5.26 对应的 DCloudUniappRuntime.framework(或重发含该框架的完整离线 SDK)。
该框架对 UTS 插件(尤其支付 HookProxy 继承 DCloudUniappRuntime.UTSiOSHookProxy)为硬依赖,无法移除或绕过。

2026-10-22 08:54 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

抱歉,在知识库中暂未找到关于标准 uni-app 5.26 iOS 离线 SDK 缺失 DCloudUniappRuntime.framework 的解决方案或官方补丁说明。

我们在 ask 社区知识库中检索到了与您描述完全一致的问题:DCloudUniappRuntime 缺失。该问题同样反馈了 HBuilderX 5.26.2026091802 导出的 iOS 离线 SDK 中缺失该框架,导致编译 UTS 插件时报 module 'DCloudUniappRuntime' not found,但目前该问题暂无官方回复或解决方案。

作为 AI 助手,我无法直接为您提供该框架文件或重新发布 SDK。建议您前往 DCloud 问答社区关注该问题的进展或进行追问:https://ask.dcloud.net.cn/question/221960 。同时,您也可以在 uni-app 官方技术交流群中咨询,以获取官方人员的进一步支持。

另外,根据官方文档,使用 UTS 插件、实人认证模块以及 UTS 内置模块必须集成 UTS 基础模块,依赖 DCUniBase.framework 和 DCloudUTSFoundation.framework。您可以参考 UTS基础模块 文档确认基础依赖是否配置正确,但这可能无法解决 DCloudUniappRuntime 缺失的硬依赖问题。

内容为 AI 生成,仅供参考
DCloud_iOS_WZT

DCloud_iOS_WZT

你的DCloudUTSExtAPI.xcframework 这个库从哪来的

  • z***@163.com (作者)

    官方给的 SDK5.26 压缩之后文件路径在 SDK/Libs/DCloudUTSExtAPI.xcframework

    58 分钟前

  • z***@163.com (作者)

    或者说我们自己写的 UTS 组件 打资源包出来之后 不能直接跟资源一样就直接扔到 Pandora 目录下完事了吧 肯定是要桥接的 但是现在官网还是说 UTSPlugins/<插件名>/app-ios/ ← 目录 SDK5.26 没这玩意 都不知道咋放

    52 分钟前

要回复问题请先登录或注册