swiftui-hybrid

SwiftUI 混合开发

架构原则

本项目主框架为 UIKit，SwiftUI 仅在以下场景使用：

1. Widget / Live Activity（必须 SwiftUI）
2. 新页面快速原型（SwiftUI 开发效率更高）
3. 复杂动画/声明式 UI（SwiftUI 更简洁）
4. 系统新 API 仅提供 SwiftUI 接口

禁止：

• 禁止将已有 UIKit 页面重写为 SwiftUI（投入产出比低）
• 禁止在 SwiftUI View 中嵌入大量 UIKit 组件（失去 SwiftUI 优势）
• 禁止混合使用 UIKit 和 SwiftUI 的导航（选一种，页面内统一）

---

UIKit 嵌入 SwiftUI

UIHostingController（SwiftUI 页面嵌入 UIKit 导航）

let swiftUIView = SettingsSwiftUIView(viewModel: settingsViewModel)
let hostingController = UIHostingController(rootView: swiftUIView)
hostingController.title = "设置"
navigationController?.pushViewController(hostingController, animated: true)

present 方式

let swiftUIView = PaywallSwiftUIView()
let hostingController = UIHostingController(rootView: swiftUIView)
hostingController.modalPresentationStyle = .pageSheet
if let sheet = hostingController.sheetPresentationController {
    sheet.detents = [.medium(), .large()]
    sheet.prefersGrabberVisible = true
}
present(hostingController, animated: true)

规范

• 每个 SwiftUI 页面用独立的 UIHostingController 包装
• 禁止在 UIHostingController 中覆盖 viewWillLayoutSubviews 等 UIKit 生命周期，用 SwiftUI 的 onAppear / onDisappear
• UIHostingController 的 sizingOptions（iOS 16+）可控制尺寸更新行为
• 传递 ViewModel 时注意生命周期：SwiftUI View 是 struct，每次重建，ViewModel 必须由外部持有

---

SwiftUI 嵌入 UIKit 组件

UIViewRepresentable（UIKit View 嵌入 SwiftUI）

struct MapViewRepresentable: UIViewRepresentable {
    let coordinate: CLLocationCoordinate2D

    func makeUIView(context: Context) -> MKMapView {
        let mapView = MKMapView()
        mapView.delegate = context.coordinator
        mapView.showsUserLocation = true
        return mapView
    }

    func updateUIView(_ mapView: MKMapView, context: Context) {
        let region = MKCoordinateRegion(
            center: coordinate,
            span: MKCoordinateSpan(latitudeDelta: 0.01, longitudeDelta: 0.01)
        )
        mapView.setRegion(region, animated: true)
    }

    func makeCoordinator() -> Coordinator {
        Coordinator()
    }

    class Coordinator: NSObject, MKMapViewDelegate {
        func mapView(_ mapView: MKMapView, didUpdate userLocation: MKUserLocation) {
            // 处理位置更新
        }
    }
}