SwiftUI-UIKit Interop
Bridge UIKit and SwiftUI in both directions: wrap UIKit views and controllers for use in SwiftUI, embed SwiftUI views into existing UIKit view hierarchies, and coordinate state updates safely. Targets Swift 6.4 / iOS 26+.
Contents
Bridging Directions
- UIKit into SwiftUI:
UIViewRepresentable: Wraps a custom UIView (e.g., text views, maps, custom controls).
UIViewControllerRepresentable: Wraps a UIViewController (e.g., camera controllers, document pickers, share sheets).
- SwiftUI into UIKit:
UIHostingController: Embeds SwiftUI views into UIKit view controller hierarchies.
UIHostingConfiguration: Embeds SwiftUI views directly into UICollectionView and UITableView cells (iOS 16+).
Representable Lifecycle and Coordinator
makeCoordinator() ──> makeUIView(context:) ──> updateUIView(uiView, context:) ──> dismantleUIView(uiView, coordinator:)
makeCoordinator(): Called once to create the delegate/coordinator object.
makeUIView(context:): Called once to instantiate the UIKit view and assign delegates.
updateUIView(_:context:): Called on every SwiftUI state change affecting the view. Must be idempotent.
dismantleUIView(_:coordinator:): Cleanup point when the view leaves the hierarchy. Invalidate timers, unregister observers.
State Synchronization and Feedback Loops
[!WARNING]
Prevent infinite update cycles:
When UIKit notifies the coordinator of a change (e.g., textViewDidChange), the coordinator updates SwiftUI state via @Binding. This triggers updateUIView.
Always check for value equality before applying updates to the UIKit view:
if uiView.text != text { uiView.text = text }
Embedding SwiftUI in UIKit
When adding a UIHostingController as a child view controller:
addChild(hostingController)
view.addSubview(hostingController.view)
- Set Auto Layout constraints
hostingController.didMove(toParent: self)
Use UIHostingConfiguration for modern cell layouts in UICollectionView/UITableView without manual controller management.
Route by Task
- For wrapping
MKMapView, UITextView, and camera capture controllers, read Map, Text, and Camera Wrappers.
- For
PHPickerViewController, MFMailComposeViewController, UIActivityViewController, and search controllers, read Picker, Mail, Share, and Search Wrappers.
- For
PDFView, QLPreviewController, and MFMessageComposeViewController, read PDF and Message Wrappers.
- For embedding SwiftUI in UIKit table/collection cells, navigation transitions, and full hosting migration, read Hosting Migration.
iOS 27 Updates
- Apps built with the iOS 27 SDK must adopt the UIKit scene-based life cycle or they fail to launch.
- Presented view controllers inherit trait collections by walking the superview chain, not from the presentation controller. Custom presentation controllers may need updates.
- iOS 27.1+:
UIView default layout margins are zero. View controllers still provide systemMinimumLayoutMargins; set preservesSuperviewLayoutMargins to true to inherit them.
- Menus:
UIMenuElement.preferredImageVisibility controls menu image visibility (images are hidden by default on iPadOS 27).
- Bars:
UINavigationItem.navigationBarMinimization replaces barMinimizeBehavior and barMinimizationSafeAreaAdjustment. UIScrollEdgeElementContainerInteraction contributes a container view to the scroll edge effect shape. UISearchController center placement shows the scope bar inline.
- External displays:
UIViewController.registerSceneAccessory(_:) with UISceneAccessory.externalNonInteractive.
- Text:
NSTextTable and related types are available to UIKit; UITextAttachmentViewProviderReusePolicy retains attachment views while scrolling.
- Drag: avoid animations or modal UI in
dragInteraction(_:sessionWillBegin:); use dragInteraction(_:sessionDidMove:).
- Adaptive layout types
UIArrangementViewController, UIView.ReservedRegion, and UIHingeInteraction appeared in the September 2026 UIKit updates; check their availability annotations before use.
Sources: https://sosumi.ai/documentation/ios-ipados-release-notes/ios-ipados-27-release-notes, https://sosumi.ai/documentation/updates/uikit
Common Mistakes
- Re-creating heavy UIKit objects inside
updateUIView instead of configuring the existing instance.
- Omitting equality checks in
updateUIView, triggering continuous render feedback loops.
- Adding a
UIHostingController's view without calling addChild and didMove(toParent:).
- Forgetting to clean up delegates, KVO, or NotificationCenter observers in
dismantleUIView.
- Ignoring safe area insets and sizing calculations (
sizeThatFits) in custom representables.
Review Checklist
References
1---2name: swiftui-uikit-interop3description: "Bridges UIKit and SwiftUI with representables, hosting controllers/configurations, coordinators, and shared observable state. Use for wrapping UIKit or third-party views/controllers, embedding SwiftUI in UIKit, system controller surfaces, or incremental UIKit-to-SwiftUI migration."4metadata:5 source: https://skillmd.com/skills/thiennc-tesoglobal/swiftui-uikit-interop6---78# SwiftUI-UIKit Interop910Bridge UIKit and SwiftUI in both directions: wrap UIKit views and controllers for use in SwiftUI, embed SwiftUI views into existing UIKit view hierarchies, and coordinate state updates safely. Targets Swift 6.4 / iOS 26+.1112## Contents1314- [Bridging Directions](#bridging-directions)15- [Representable Lifecycle and Coordinator](#representable-lifecycle-and-coordinator)16- [State Synchronization and Feedback Loops](#state-synchronization-and-feedback-loops)17- [Embedding SwiftUI in UIKit](#embedding-swiftui-in-uikit)18- [Route by Task](#route-by-task)19- [iOS 27 Updates](#ios-27-updates)20- [Common Mistakes](#common-mistakes)21- [Review Checklist](#review-checklist)22- [References](#references)2324## Bridging Directions25261. **UIKit into SwiftUI**:27 - `UIViewRepresentable`: Wraps a custom `UIView` (e.g., text views, maps, custom controls).28 - `UIViewControllerRepresentable`: Wraps a `UIViewController` (e.g., camera controllers, document pickers, share sheets).292. **SwiftUI into UIKit**:30 - `UIHostingController`: Embeds SwiftUI views into UIKit view controller hierarchies.31 - `UIHostingConfiguration`: Embeds SwiftUI views directly into `UICollectionView` and `UITableView` cells (iOS 16+).3233## Representable Lifecycle and Coordinator3435```36makeCoordinator() ──> makeUIView(context:) ──> updateUIView(uiView, context:) ──> dismantleUIView(uiView, coordinator:)37```3839- **`makeCoordinator()`**: Called once to create the delegate/coordinator object.40- **`makeUIView(context:)`**: Called once to instantiate the UIKit view and assign delegates.41- **`updateUIView(_:context:)`**: Called on **every** SwiftUI state change affecting the view. Must be idempotent.42- **`dismantleUIView(_:coordinator:)`**: Cleanup point when the view leaves the hierarchy. Invalidate timers, unregister observers.4344## State Synchronization and Feedback Loops4546> [!WARNING]47> Prevent infinite update cycles:48> When UIKit notifies the coordinator of a change (e.g., `textViewDidChange`), the coordinator updates SwiftUI state via `@Binding`. This triggers `updateUIView`.49> Always check for value equality before applying updates to the UIKit view:50> ```swift51> if uiView.text != text { uiView.text = text }52> ```5354## Embedding SwiftUI in UIKit5556When adding a `UIHostingController` as a child view controller:571. `addChild(hostingController)`582. `view.addSubview(hostingController.view)`593. Set Auto Layout constraints604. `hostingController.didMove(toParent: self)`6162Use `UIHostingConfiguration` for modern cell layouts in `UICollectionView`/`UITableView` without manual controller management.6364## Route by Task6566- For wrapping `MKMapView`, `UITextView`, and camera capture controllers, read [Map, Text, and Camera Wrappers](references/map-text-and-camera-wrappers.md).67- For `PHPickerViewController`, `MFMailComposeViewController`, `UIActivityViewController`, and search controllers, read [Picker, Mail, Share, and Search Wrappers](references/picker-mail-share-and-search-wrappers.md).68- For `PDFView`, `QLPreviewController`, and `MFMessageComposeViewController`, read [PDF and Message Wrappers](references/pdf-and-message-wrappers.md).69- For embedding SwiftUI in UIKit table/collection cells, navigation transitions, and full hosting migration, read [Hosting Migration](references/hosting-migration.md).7071## iOS 27 Updates7273- Apps built with the iOS 27 SDK must adopt the UIKit scene-based life cycle or they fail to launch.74- Presented view controllers inherit trait collections by walking the superview chain, not from the presentation controller. Custom presentation controllers may need updates.75- iOS 27.1+: `UIView` default layout margins are zero. View controllers still provide `systemMinimumLayoutMargins`; set `preservesSuperviewLayoutMargins` to `true` to inherit them.76- Menus: `UIMenuElement.preferredImageVisibility` controls menu image visibility (images are hidden by default on iPadOS 27).77- Bars: `UINavigationItem.navigationBarMinimization` replaces `barMinimizeBehavior` and `barMinimizationSafeAreaAdjustment`. `UIScrollEdgeElementContainerInteraction` contributes a container view to the scroll edge effect shape. `UISearchController` center placement shows the scope bar inline.78- External displays: `UIViewController.registerSceneAccessory(_:)` with `UISceneAccessory.externalNonInteractive`.79- Text: `NSTextTable` and related types are available to UIKit; `UITextAttachmentViewProviderReusePolicy` retains attachment views while scrolling.80- Drag: avoid animations or modal UI in `dragInteraction(_:sessionWillBegin:)`; use `dragInteraction(_:sessionDidMove:)`.81- Adaptive layout types `UIArrangementViewController`, `UIView.ReservedRegion`, and `UIHingeInteraction` appeared in the September 2026 UIKit updates; check their availability annotations before use.8283Sources: https://sosumi.ai/documentation/ios-ipados-release-notes/ios-ipados-27-release-notes, https://sosumi.ai/documentation/updates/uikit8485## Common Mistakes8687- Re-creating heavy UIKit objects inside `updateUIView` instead of configuring the existing instance.88- Omitting equality checks in `updateUIView`, triggering continuous render feedback loops.89- Adding a `UIHostingController`'s view without calling `addChild` and `didMove(toParent:)`.90- Forgetting to clean up delegates, KVO, or NotificationCenter observers in `dismantleUIView`.91- Ignoring safe area insets and sizing calculations (`sizeThatFits`) in custom representables.9293## Review Checklist9495- [ ] `makeCoordinator` used for delegates, target-actions, and data sources96- [ ] `updateUIView` guards against redundant assignments to avoid feedback loops97- [ ] Child view controller containment calls (`addChild`, `didMove`) properly paired98- [ ] Cell layouts in UIKit use `UIHostingConfiguration` where available99- [ ] Subscribed observers and display links invalidated in `dismantleUIView`100- [ ] Auto Layout constraints configured with `translatesAutoresizingMaskIntoConstraints = false`101102## References103104- [Map, text, and camera representable recipes](references/map-text-and-camera-wrappers.md)105- [Picker, mail, share, and search recipes](references/picker-mail-share-and-search-wrappers.md)106- [PDF, QuickLook, and message composer recipes](references/pdf-and-message-wrappers.md)107- [Hosting migration and UIHostingController guide](references/hosting-migration.md)108- [UIViewRepresentable](https://sosumi.ai/documentation/swiftui/uiviewrepresentable)109- [UIViewControllerRepresentable](https://sosumi.ai/documentation/swiftui/uiviewcontrollerrepresentable)110- [UIHostingController](https://sosumi.ai/documentation/swiftui/uihostingcontroller)