集成内置模块DCloudUTSExtAPI的问题

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

这种设计在 iOS 原生工程中是合理的。在 Swift 开发中，Framework 内部的源文件 import 自身模块名（如 import DCloudUTSExtAPI）是为了显式声明对该模块公共接口或类型的依赖。虽然看起来像循环依赖，但 Swift 编译器能够正确处理这种情况，这在复杂的模块化工程或源文件跨 target 复用时是常见的做法。因此，源文件中存在 import DCloudUTSExtAPI 并不是导致编译失败的根本原因。

根据知识库记录，使用 HBuilderX 5.15 及对应 SDK 制作 DCloudUTSExtAPI 时，真正导致编译报错的原因通常是文档与 SDK 包内容不匹配或环境问题：

1. 文件缺失或名称变更：有开发者在使用与你完全相同的环境（macmini M2, HBuilderX 5.15, Xcode 26.6, SDK UniAppX-iOS@5.15）时反馈，文档要求的 UTSOC.h、UTSOC.mm、uni-form-index.swift 等文件在下载的 SDK ExtApiSrc 目录下缺失或名称已变更（如变为 uni-form-dom1-index.swift）。这会导致编译时找不到依赖而报错。详见 ask 社区 220937 和 ISSUE 27553。
2. Xcode 版本不匹配：如果 Xcode 版本低于 SDK 编译时使用的版本，会报 Swift 版本不匹配的错误。详见 ISSUE 24338。

建议排查步骤：

1. 核对 SDK 文件：重新下载 SDK，仔细核对 SDK/ExtApiSrc 目录下的文件是否与官方文档完全一致。如果确认缺失文件，说明 SDK 包可能不完整或版本同步存在问题。
2. 检查依赖配置：确保在制作 DCloudUTSExtAPI 工程时，添加的依赖库均设置为 Do Not Embed；而在主工程集成导出的 DCloudUTSExtAPI.xcframework 时，需设置为 Embed & Sign。
3. 提交 issue：如果确认文件缺失且无法通过重新下载解决，建议前往 DCloud 官方 issue 系统提交问题：https://issues.dcloud.net.cn/ ，并附上复现工程和完整报错日志。