2***@qq.com
2***@qq.com
  • 发布:2026-07-14 15:26
  • 更新:2026-07-14 15:27
  • 阅读:35

iOS端使用uts没有编译

分类:uni-app

【环境】

  • 系统: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 15:26 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

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

好的,我们来分析并解决你遇到的 ios 端 uts 插件未编译的问题。

根据你提供的日志和现象,核心问题在于云端打包服务错误地判定你的项目“未使用原生插件”,导致没有将 uni_modules 下的 uts 原生代码编译进最终的 app 包中。

以下是可能的原因和解决方案,请逐一排查。

1. 检查 uts 插件的目录结构是否完整

云端打包服务需要通过标准的目录结构来识别 uts 插件。请确保你的插件 uni_modules/zy-ocr-tool 的目录结构严格符合规范。

一个标准的 uts 插件目录应包含 utssdk 目录,其下再分平台目录。

正确的结构示例:

uni_modules/  
└── zy-ocr-tool/  
    ├── package.json        // 可选,但推荐  
    ├── utssdk/  
    │   ├── app-android/    // android 平台代码  
    │   │   ├── config.json // 依赖配置  
    │   │   ├── index.uts  
    │   │   └── ...  
    │   └── app-ios/        // ios 平台代码  
    │       ├── config.json // 关键!依赖 onnxruntime-objc 等  
    │       ├── index.uts  
    │       └── ...  
    └── ...                 // 其他文件,如文档、示例等

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

检查要点:

  • 路径是否正确:ios 的 uts 代码必须位于 uni_modules/zy-ocr-tool/utssdk/app-ios/ 目录下。
  • 文件名是否准确:入口文件通常为 index.uts,并且 config.json 文件必须存在,即使是空对象 {} 也需要有这个文件。
  • 不要有无关的目录嵌套:避免出现 uni_modules/zy-ocr-tool/zy-ocr-tool/utssdk/... 这样的双重嵌套。

2. 移除或重制 manifest.json 中可能存在的错误配置

你提到“未再错误写入 manifest.nativeplugins”,但这仍是排查重点。

  • 检查 manifest.json 源码视图:用文本编辑器打开 manifest.json,搜索 nativePlugins 这个关键词。如果你的项目是 uni-app(非 uni-app x),并且插件是通过 uni_modules 方式集成的,那么 manifest.json不应该手动配置 nativePlugins。云端打包会自动扫描 uni_modules 目录。
  • 如果存在,请彻底删除:删除整个 nativePlugins 配置项及其内容,然后重新打包。
  • 如果不存在,尝试强制刷新:有时打包缓存会导致问题。你可以尝试修改 manifest.json 中的 "name"(应用名称)字段,使其与上次打包时不同。这可以强制云端打包服务重新完整编译,而非使用旧的缓存。

3. 检查 config.json 中的依赖配置格式

你提到 config.json 依赖 onnxruntime-objc,格式错误也可能导致插件加载失败。

标准的依赖配置格式如下:

{  
  "dependencies": [  
    "onnxruntime-objc"   
  ]  
}

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

  • dependencies 是一个字符串数组
  • 确保 onnxruntime-objc 字符串的拼写完全正确,没有多余的空格。
  • 确保 config.json 是一个合法的 json 文件,可以用在线 json 校验工具检查一下。

4. 关于日志“应用manifest不修改且未使用原生插件”的说明

这条日志是导致问题的直接线索。它的原意是:如果应用标识(manifest)没变,且没有使用原生插件,那么后续打包可以采用“安心打包”模式,速度更快。

但这同时也表明,云端打包服务在本次打包过程中,没有成功检测到你的 uts 插件。因此,问题的核心在于“如何让云端打包服务识别到插件”,上述几个检查点就是关键。

总结与操作建议

建议按以下顺序操作,每一步操作后都重新进行一次云打包以验证:

  1. 核心修复:仔细核对 uni_modules/zy-ocr-tool/ 下的目录结构,确保 utssdk/app-ios/config.jsonindex.uts 等文件路径完全正确。
  2. 清理配置:彻底删除 manifest.json 源码中可能残留的 nativePlugins 配置。
  3. 强制重编:修改 manifest.json 中的 "name" 字段(例如,在名称后加一个数字1),以强制云端打包服务不走缓存,进行一次完整的编译。
  4. 检查依赖:验证 utssdk/app-ios/config.json 文件内容的 json 格式和依赖名称的正确性。

如果以上步骤都确认无误,但问题依旧,这可能是特定版本下云端打包服务的一个偶发问题。你可以尝试创建一个最简单的、带有 uts 插件的测试项目,来验证该插件本身是否能在你的 hbuilderx 版本下被正常云打包。如果测试项目正常,则问题可能出在原项目的某些特殊配置上。

内容为 AI 生成,仅供参考

要回复问题请先登录注册