9***@qq.com
9***@qq.com
  • 发布:2026-03-06 14:30
  • 更新:2026-03-06 14:31
  • 阅读:18

集成xcframework的时候,执行自定义基座时build报错

分类:uts

我已经将ADY_IMG_SDK.framework放置在uni_modules\yolo-uts\utssdk\app-ios\Frameworks\ADY_IMG_SDK.xcframework\ios-arm64目录下
config.json配置如下
{
"frameworks": [
"ADY_IMG_SDK.xcframework",
"Foundation.framework",
"UIKit.framework"
],
"weakFrameworks": [],
"libraries": ["c++"],
"validArchitectures": ["arm64"]
}
打包时报错 ld: framework not found ADY_IMG_SDK 具体信息见附件

2026-03-06 14:30 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

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

根据你提供的配置和报错信息,当前的问题是:

ld: framework not found ADY_IMG_SDK

这说明在自定义基座打包过程中,链接阶段找不到 ADY_IMG_SDK.xcframework,即使你已经将其放置在:

uni_modules/yolo-uts/utssdk/app-ios/Frameworks/ADY_IMG_SDK.xcframework/ios-arm64

✅ 正确做法(基于知识库)

根据 官方文档uts插件配置规范,你需要确保以下几点:


✅ 1. 目录结构必须规范

.xcframework 必须放在:

uni_modules/yolo-uts/utssdk/app-ios/Frameworks/

而不是其子目录(如 ios-arm64)。请ADY_IMG_SDK.xcframework 整个文件夹移动出来,不要嵌套在 ios-arm64 目录下。


✅ 2. config.json 配置格式

你的 config.jsonframeworks 字段写法有误,不需要加 .xcframework 后缀,也不要加 .framework 后缀(系统库除外)。正确写法如下:

{  
  "frameworks": [  
    "ADY_IMG_SDK",  
    "Foundation",  
    "UIKit"  
  ],  
  "libraries": ["c++"],  
  "validArchitectures": ["arm64"]  
}

✅ 3. 清理缓存 & 重新打包

  • 删除 unpackage/debug 目录
  • 删除 unpackage/dist 目录
  • 重启 HBuilderX
  • 重新执行【发行】-【原生App-云打包】-【自定义调试基座】

✅ 4. 检查是否为本地插件

如果你使用的是本地插件而非云端插件,请确保:

  • 插件目录结构正确
  • 插件未在 manifest.json 中误引用为云端插件(否则云打包会提示未购买)

✅ 5. 若仍报错,检查是否为软链接问题(Windows用户)

如果你在 Windows 系统 上操作,.xcframework 中的某些文件可能是软链接,会导致打包失败。请使用 Mac 系统重新解压或打包,或参考 Windows打包iOS本地插件报错解决方法


✅ 总结

检查项 是否正确
.xcframework 放在 Frameworks/ 根目录
config.json 中不写 .xcframework 后缀
清理缓存后重新打包
未误引用为云端插件
使用 Mac 系统操作(避免软链接问题)

如以上步骤都确认无误仍报错,请提供完整的 config.json 内容和打包日志截图,我将进一步协助你排查。

内容为 AI 生成,仅供参考

要回复问题请先登录注册