用途:专门处理 SwiftUI 与 UIKit 的边界问题,即在两者之间互相嵌入并传递数据。不负责纯 SwiftUI 视图设计,也不负责应用架构与依赖注入,这两类任务分别交给 swiftui-expert 与 ios-architecture-expert。
主要能力:
- 在 UIKit 中嵌入 SwiftUI:用 UIHostingController 进行模态呈现(present)或子控制器嵌入(addChild / didMove(toParent:));表格与集合视图单元格使用 UIHostingConfiguration(iOS 16+),每个单元格一个配置对象,而非每个单元格一个 hosting controller。
- 在 SwiftUI 中包装 UIKit:视图用 UIViewRepresentable,视图控制器用 UIViewControllerRepresentable,禁止在 SwiftUI body 中直接创建 UIKit 视图。
- 回调路由:UIKit 的 delegate、data-source、target-action 统一通过 makeCoordinator() 生成的 Coordinator 转发,可变状态不放在 representable 结构体上。
- 数据单向流动:SwiftUI 状态走 updateUIView / updateUIViewController,UIKit 事件经 Coordinator 回到 @Binding 或闭包;不要在 updateUIView 内同步修改 SwiftUI 状态。
- 宿主尺寸:通过 sizingOptions、intrinsicContentSize、safeAreaRegions 保证 Auto Layout 与自适应单元格正确测量。
- 版本门控:UIHostingConfiguration(iOS 16)、UIHostingController.sizingOptions(iOS 16)、trait 桥接环境(iOS 17)、@UIApplicationDelegateAdaptor 等需用 #available/@available 判断。
- 其他:WidgetKit 小组件与实时活动中的 SwiftUI、将 UIKit 的 AppDelegate/SceneDelegate 应用逐步迁移到 SwiftUI App 生命周期。
使用方式:技能内含诊断表,按症状(如 SwiftUI 页面显示异常、单元格嵌入、回调丢失、尺寸错误)指向 host-controller、hosting-configuration、representables、passing-data-across-the-boundary 等参考文档,按任务打开最小范围文档。
限制与注意:不要把 delegate 实现放在 representable 结构体上;不要只把 hosting controller 的 view 当子视图添加而不做子控制器容纳,否则会丢失生命周期与安全区转发;不要为每个单元格创建 UIHostingController;不要在此技能内解决架构与依赖注入问题。具体安装命令暂未提供。