While building for Mac Catalyst

欢迎到专业群（ uni-app x技术交流群 ） 咨询，群中有相关专业的管理员和群友。

根据你的问题描述，这是一个在 Mac 环境下使用 HBuilderX 进行 iOS 真机调试时，因 UTS 插件中包含不支持 Mac Catalyst 的第三方 SDK（ThingSmartCryption.xcframework）而导致的编译错误。

你遇到的情况是：修改 UTS 插件代码后，HBuilderX 会自动触发 UTS 插件的编译，这个过程在 App 编译之前，因此你在 manifest.json 中设置的 "disableMacCatalyst" : true 和 "UIApplicationSupportsMacDesignedForiPad" : false 无法生效。

这属于 HBuilderX 在特定版本下对 UTS 插件编译流程的已知问题，在 ISSUE 系统中已有记录。根据 ISSUE 系统中的反馈，这被官方认定为误报，属于编译器的行为问题。

参考 ISSUE 系统：新版HBuilderX编译插件内引用的是Frameworks第三方库时，报While building for Mac Catalyst错误

解决方案

建议你采用以下方法来规避此问题：

1. 使用云端打包自定义基座进行调试
   这是最直接有效的方案。在 Windows 电脑上，或者即便在 Mac 电脑上，通过提交云端打包生成自定义基座，可以完全跳过本地 Xcode 对 UTS 插件的编译过程，从而避免此错误。

   • 操作路径：在 HBuilderX 中，选择菜单栏的 运行 -> 运行到手机或模拟器 -> 制作自定义调试基座，填写相关信息后提交云端打包。打包完成后，使用生成的自定义基座进行真机调试。

2. 检查并更新 HBuilderX 版本
   此问题在后续的 HBuilderX 版本中可能已经修复。你当前使用的版本如果较旧，可以尝试升级到最新的 Alpha 版（5.12） 或 正式版（5.07），看问题是否解决。

3. 临时规避方法（不推荐）
   如果必须在本地编译，且仅需临时调试，可以考虑在修改 UTS 插件代码后，手动删除 unpackage 目录下对应的编译缓存，再重新运行。但这不能保证完全解决问题，且比较繁琐。

核心原因分析

• 问题本质：HBuilderX 在编译 UTS 插件时，其构建系统（Xcode）错误地尝试为 Mac Catalyst 平台构建，而你的第三方 SDK 并不包含该平台的库文件，因此报错。
• 为何 App 配置无效：UTS 插件的编译是独立于 App 主工程编译的，其构建目标由 HBuilderX 内部机制决定，并不读取 manifest.json 中关于 App 级别的 Mac Catalyst 配置。

总结

你遇到的这个问题是 HBuilderX 编译 UTS 插件时的已知误报。最推荐的解决方法是改用云端打包自定义基座进行调试，这样可以完全绕过本地复杂的编译环境，避免此类平台兼容性问题。