2***@qq.com
2***@qq.com
  • 发布:2026-07-14 10:35
  • 更新:2026-07-14 10:53
  • 阅读:137

ios端uts插件编译

分类:uts

【环境】

  • 系统:Windows 10
  • HBuilderX:5.15
  • 项目类型:uni-app(Vue3),非 uni-app x
  • AppID:UNIE5B5221
  • 打包:发行 → 原生App-云打包 → iOS 自定义调试基座
  • 本地 UTS 插件:uni_modules/zy-ocr-tool(含 utssdk/app-ios,config.json 依赖 onnxruntime-objc)
    【现象】
    1. 云打包成功,但详细日志出现:
      「应用manifest不修改且未使用原生插件的情况下...」
    2. 打包很快(约1分钟),IPA 约 13–14MB
    3. 真机安装自定义基座后,模型文件可复制成功,但 OCR 初始化失败:
      UTS 插件构造失败 / undefined class: UTSSDKModulesZyOcrToolUniOcrOfflineHarmonyByJs
    4. 同项目 Android 自定义基座含 UTS 正常;仅 iOS 云端未编入原生模块
      【期望】
      iOS 云端自定义基座应识别并编译 uni_modules 下 UTS 插件(含 CocoaPods/原生代码),不应判定为「未使用原生插件」。
      【已自查】
  • 根目录存在 uni_modules/zy-ocr-tool(非仅 src)
  • 未再错误写入 manifest.nativePlugins
  • 使用「自定义基座」运行,非仅热更新 JS
    【附件】
    [HBuilder] 09:58:52.335 项目 beadream-app [UNIE5B5221]打自定义调试基座包成功:

[HBuilder] 09:58:52.335 路径为: D:/pd/beadream-app/dist/debug/iOS_debug.ipa

[HBuilder] 09:58:52.335 选择菜单“运行->运行到手机或模拟器->运行基座选择->自定义调试基座”后再次运行项目,即可通过自定义调试基座查看日志

[HBuilder] 09:58:52.336 注:自定义调试基座不可用于正式发布,其脱离HBuilderX无法更新应用资源
[HBuilder] 09:58:52.336 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 09:58:52.336 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 09:58:52.336 【云端打包提示信息】
[HBuilder] 09:58:52.336 打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 09:58:52.336 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 09:58:52.337
[HBuilder] 10:07:33.253 正在获取打包状态...
[HBuilder] 10:07:44.478
[HBuilder] 10:07:44.479 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.479 时间: 2026-07-14 09:54:48 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/fef4d780-7f26-11f1-bced-13969f7e1b9c [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.479 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.480 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.480 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.481 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.481 【云端打包提示信息】
[HBuilder] 10:07:44.481
打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.481 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.481
[HBuilder] 10:07:44.526
[HBuilder] 10:07:44.526 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.526 时间: 2026-07-13 15:06:18 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/58a0a080-7e89-11f1-b584-0f7b6ee013e0 [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.526 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.527 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.527 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.527 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.527 【云端打包提示信息】
[HBuilder] 10:07:44.527 打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.528 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.528
[HBuilder] 10:07:44.529
[HBuilder] 10:07:44.529 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.529 时间: 2026-07-13 14:27:12 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/e2075aa0-7e83-11f1-bc7c-79f09b5ce9e9 [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.530 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.530 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.530 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.531 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.531 【云端打包提示信息】
[HBuilder] 10:07:44.531
打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.531 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.531
[HBuilder] 10:07:44.553
[HBuilder] 10:07:44.553 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.553 时间: 2026-07-13 13:50:57 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/d1ead220-7e7e-11f1-b7da-8db97237e303 [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.554 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.554 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.554 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.554 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.554 【云端打包提示信息】
[HBuilder] 10:07:44.554 打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.555 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.555
[HBuilder] 10:07:44.580
[HBuilder] 10:07:44.581 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.582 时间: 2026-07-13 13:38:56 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/23e64b60-7e7d-11f1-a547-d7d557e36088 [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.583 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.583 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.583 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.585 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.585 【云端打包提示信息】
[HBuilder] 10:07:44.586
打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.586 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.586
[HBuilder] 10:07:44.608
[HBuilder] 10:07:44.608 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.608 时间: 2026-07-13 11:40:48 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/a324f070-7e6c-11f1-a040-93d37bf6c875 [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.608 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.609 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.609 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.609 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.609 【云端打包提示信息】
[HBuilder] 10:07:44.610 打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.610 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.610
[HBuilder] 10:07:44.629
[HBuilder] 10:07:44.629 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.629 时间: 2026-07-13 11:39:09 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/684f73a0-7e6c-11f1-bbdd-e718d6e21385 [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.630 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.630 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.630 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.630 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.630 【云端打包提示信息】
[HBuilder] 10:07:44.631
打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.631 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.631
[HBuilder] 10:07:44.650
[HBuilder] 10:07:44.650 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.650 时间: 2026-07-13 11:21:47 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/faeaeec0-7e69-11f1-913c-1bac6ead42a1 [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.650 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.651 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.651 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.651 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.651 【云端打包提示信息】
[HBuilder] 10:07:44.651 打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.651 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.651
[HBuilder] 10:07:44.673
[HBuilder] 10:07:44.674 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.674 时间: 2026-07-13 10:57:07 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/88ff4860-7e66-11f1-b366-31b7b479ec64 [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.674 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.674 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.674 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.675 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.675 【云端打包提示信息】
[HBuilder] 10:07:44.675
打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.675 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.675
[HBuilder] 10:07:44.694
[HBuilder] 10:07:44.695 项目 beadream-app [UNIE5B5221]的打包状态:
[HBuilder] 10:07:44.695 时间: 2026-07-13 10:36:07 类型: iOS Appstore(真机) 打包成功 下载地址: https://app.liuyingyong.cn/build/download/9a1f97a0-7e63-11f1-948c-976806ed7c6f [一键上传到uniCloud(更优惠的cdn、长期稳定)]
[HBuilder] 10:07:44.695 uni升级中心可为您的App提供简单、统一的版本管理、升级检测功能,建议集成。详情: https://uniapp.dcloud.io/uniCloud/upgrade-center
[HBuilder] 10:07:44.696 HBuilderX已支持App cli自动化打包, 详情参考: https://hx.dcloud.net.cn/cli/pack [不再提示]
[HBuilder] 10:07:44.696 应用manifest不修改且未使用原生插件的情况下,非首次打包使用安心打包的速度更快且不占用云端打包次数。推荐下次使用安心打包功能。
[HBuilder] 10:07:44.696 uni多商店上传支持一键将应用发布到各大安卓市场与苹果 App Store。上架苹果全程不需要准备 Mac 电脑,省时省力,一步到位。 [一键发布],[查看文档]
[HBuilder] 10:07:44.696 【云端打包提示信息】
[HBuilder] 10:07:44.696 ** 打包证书不是 App Store 生产证书(Production),不能提交到 App Store 上架审核!
[HBuilder] 10:07:44.697 使用开发证书 “iPhone Developer: janemal Lam (U6582VM287)” 打包,只能安装到测试设备
[HBuilder] 10:07:44.697

2026-07-14 10:35 负责人:无 分享
已邀请:
2***@qq.com

2***@qq.com (作者)

{
"deploymentTarget": "13.0",
"validArchitectures": ["arm64"],
"frameworks": [
"Foundation.framework",
"UIKit.framework",
"CoreGraphics.framework",
"Accelerate.framework"
],
"dependencies-pods": [
{
"name": "onnxruntime-objc",
"version": "1.21.0"
}
]
}

已按 官方 CocoaPods 文档 配置

2***@qq.com

2***@qq.com (作者)

根目录已有完整 UTS 插件且业务已静态 import,Android 云定制基座正常;仅 iOS 云打包日志仍报「未使用原生插件」,连 UTS 编译/pod install 都未进入

Ask小助手

Ask小助手

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

根据你的描述,核心问题是:ios 云端打包时没有识别并编译 uni_modules 下的 uts 插件,导致基座中缺少原生模块,运行时抛出 undefined class 错误。

这个问题的关键在于 uts 插件(特别是 ios 端)在云打包时的识别机制。结合你提供的日志“应用manifest不修改且未使用原生插件的情况下...”,可以推断云端打包流程判断你的项目中“未使用原生插件”,因此跳过了原生模块的编译和注入。

以下是需要重点排查和解决的方向:

1. 确认 uts 插件的 config.json 配置是否正确

你的插件依赖 onnxruntime-objc,这是一个需要通过 CocoaPods 集成的原生库。对于 ios 端的 uts 插件,依赖声明必须准确无误。

请检查 uni_modules/zy-ocr-tool/utssdk/app-ios/config.json 文件(或类似路径下的 ios 配置文件),确保依赖声明格式完全正确。一个典型的、包含 CocoaPods 依赖的 ios uts 插件配置如下:

{  
  "dependencies": [  
    {  
      "name": "onnxruntime-objc",  
      "type": "pod",  
      "version": "1.16.0"  
    }  
  ]  
}

本助手使用国产模型,生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

  • name 必须是 CocoaPods 仓库中的准确名称。
  • type 必须指定为 "pod",这是告诉云端打包系统需要执行 pod install 的关键字段。
  • version 建议明确指定,避免版本冲突。

如果此处格式错误或 type 遗漏,云端打包系统可能无法正确解析依赖,从而忽略整个插件。

2. 检查插件目录结构和命名规范

uts 插件的目录结构必须严格遵守规范,否则编译器可能无法发现插件。

  • 确保插件目录完整路径为 项目根目录/uni_modules/zy-ocr-tool/utssdk/app-ios/
  • app-ios 目录名不能有任何偏差(例如不能是 iosapp-ios-dev)。
  • app-ios 目录下应包含你的 .uts 源文件、config.json 以及可能的原生桥接文件。

3. 清理打包缓存后重试

云端打包可能存在缓存,导致即使修复了配置,打包时仍使用旧的、错误的判断。请尝试以下步骤:

  1. 在 HBuilderX 中,找到你的项目。
  2. 进入 unpackage 目录,删除整个 debug 文件夹(或至少删除其中的 ios 相关输出)。
  3. 重新执行“发行 → 原生App-云打包 → iOS 自定义调试基座”。

4. 验证插件是否被正确引用

虽然 uts 插件不需要在 manifest.jsonapp-plus -> modulesnativePlugins 中手动声明(这是旧版原生插件的做法),但你仍需确保没有在 manifest.json 中错误地配置了任何可能干扰 uts 插件识别的设置。

uts 插件的引用是通过在代码中 importrequire 来自动完成的。请确认你的业务代码中确实引用了该插件,例如:

// 示例,请根据你的插件实际导出名称调整  
import { initOcr } from '@/uni_modules/zy-ocr-tool';

本助手使用国产模型,生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

如果仅仅是放入了 uni_modules 目录但没有在任何 .vue.js 文件中引用,编译器可能会进行摇树优化(tree-shaking),将其视为未使用的代码而排除。

5. 对比 Android 端配置

既然 Android 端可以正常工作,建议将 Android 和 iOS 两端的 config.json 和目录结构进行详细对比。虽然平台不同,但配置的结构逻辑是相似的。检查是否有针对 Android 的特殊配置,而 iOS 端遗漏了对应的必要字段。

如果以上步骤均无法解决问题,可能是该版本 HBuilderX(5.15)对特定格式的 CocoaPods 依赖解析存在兼容性缺陷。你可以尝试:

  • onnxruntime-objc 的版本号调整为一个较早的、广泛兼容的稳定版。
  • 创建一个最简单的、仅包含一个 CocoaPods 依赖的 ios uts 插件进行测试,以判断问题是出在你的插件配置上,还是打包环境本身。

根据知识库,类似“应用manifest不修改且未使用原生插件”的提示,往往意味着打包流程在前期文件扫描阶段就做出了错误判断。请重点聚焦于 config.jsontype: "pod" 声明和插件目录结构的绝对规范性。

内容为 AI 生成,仅供参考

要回复问题请先登录注册