Using SwiftUI with UIKit
At a glance
| Item | Summary |
|---|---|
| Purpose | Learn how to incorporate SwiftUI views into a UIKit app. |
| App architecture | A Swift sample with the source-visible chain AppDelegate → HostingConfigurationViewController → DataStore → UIKit APIs. |
| Main patterns | View-controller organization, Delegate or data-source callbacks, Central store, Publisher-backed observable state |
| Project style | 10 scanned source file(s) across Swift, organized around ranked entry, type, and file boundaries. |
| Execution model | Source-visible boundaries: @MainActor; none alone proves a background thread. |
| State/event model | Source-visible mechanisms: ObservableObject, @Published, NotificationCenter. |
| Key frameworks/packages | SwiftUI, UIKit, Charts; these are source dependencies, not architecture labels. |
Project structure
Source bundle/
├── UseSwiftUIWithUIKit/
│ ├── AppDelegate.swift
│ ├── Examples/
│ │ ├── SwiftUI in Cells/
│ │ │ ├── SwiftUI Views/
│ │ │ │ ├── HeartRateCellView.swift
│ │ │ │ ├── SleepCellView.swift
│ │ │ │ ├── HealthCategoryCellView.swift
│ │ │ │ └── StepCountCellView.swift
│ │ │ └── HostingConfigurationExample.swift
│ │ ├── Data Flow with SwiftUI Cells/
│ │ │ └── CellDataFlowExample.swift
│ │ └── SwiftUI View Controllers/
│ │ └── HostingControllerExample.swift
│ ├── MainMenuViewController.swift
│ └── SceneDelegate.swift
├── Configuration/
│ └── SampleCode.xcconfig
└── UseSwiftUIWithUIKit.xcodeproj/
└── .xcodesamplecode.plist
Structure observations
- Architecturally prominent files are ranked from entry points and role-named declarations; resource-only paths are omitted.
- Primary languages: Swift.
- The verified tree contains 6 project/configuration file(s) and 33 source declaration(s).
Overall architecture
flowchart LR
N1["AppDelegate"]
N2["HostingConfigurationViewController"]
N3["DataStore"]
N4["UIKit APIs"]
N1 --> N2
N2 --> N3
N3 --> N4
Reference code
UseSwiftUIWithUIKit/AppDelegate.swift:10 — architecture anchor
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Override point for customization after application launch.
return true
}
// MARK: UISceneSession Lifecycle
func application(
_ application: UIApplication,
configurationForConnecting connectingSceneSession: UISceneSession,
options: UIScene.ConnectionOptions) -> UISceneConfiguration {
// Called when a new scene session is being created.
// Use this method to select a configuration to create the new scene with.
return UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role)
}
}Interpretation
The arrows summarize the source-visible entry, role-named types or folders, and framework direction; when nodes come from structural folders, the sequence is a high-level interpretation rather than proof that every adjacent node calls the next. Ownership is claimed only where the next section cites a stored property or assignment. The diagram is intentionally limited to the dominant path into UIKit.
Ownership and state
classDiagram
HeartRateSample *-- UUID : id
HeartRateSample *-- Date : time
HeartRateSample *-- Int : beatsPerMinute
HeartRateCellView o-- HeartRateData : data
Ownership evidence
UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/HeartRateCellView.swift:12 — stored dependency or nearest verified ownership anchor
struct HeartRateSample: Identifiable {
let id: UUID
var time: Date
var beatsPerMinute: Int
}| Owner | Object or state | Relationship | Mutation authority |
|---|---|---|---|
HeartRateSample |
UUID (id) |
owns value state | Initialized by the owner; the binding is immutable |
HeartRateSample |
Date (time) |
owns value state | App/module collaborators |
HeartRateSample |
Int (beatsPerMinute) |
owns value state | App/module collaborators |
HeartRateCellView |
HeartRateData (data) |
stores or receives | App/module collaborators |
Composition arrows indicate a source-visible construction expression or locally owned value state; aggregation means the owner stores or receives a dependency without proving exclusive lifetime ownership.
Concurrency, scheduling, and thread safety
Evidence limit: actor isolation, async/await, or Task creation does not by itself prove background-thread execution; Sendable conformance alone does not prove thread-safe mutation.
| Concern | Source mechanism | Verified placement or handoff | Evidence |
|---|---|---|---|
| Main isolation | @MainActor |
The cited annotation marks its attached declaration or closure as main-actor isolated. | UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:19 |
@MainActor/MainActor.run, DispatchQueue.main, and RunLoop.main are reported as distinct isolation, queue, and event-loop mechanisms. A plain Task is kept separate from Task.detached; neither is labeled as a background thread.
Reference code
UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:19 — representative execution boundary
@MainActor
private class MedicalCondition: Identifiable, ObservableObject {
// ...
let id: UUID
// ...
}State propagation, frameworks, and dependencies
Evidence limit: an import proves a source-level compilation dependency at the cited line; it does not prove runtime use, architectural adoption, or whether a Swift package is a direct application dependency.
| Category | Mechanism or module | Verified role | Evidence |
|---|---|---|---|
| State propagation | ObservableObject |
ObservableObject supplies an observation contract. | UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:20 |
| State propagation | @Published |
A published property can emit owner-controlled changes. | UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:26 |
| State propagation | NotificationCenter |
NotificationCenter distributes named process-local events. | UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:60 |
| Source import | SwiftUI |
The cited file imports this module; runtime use and architectural role are not inferred. | UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:9 |
| Source import | UIKit |
The cited file imports this module; runtime use and architectural role are not inferred. | UseSwiftUIWithUIKit/AppDelegate.swift:8 |
| Source import | Charts |
The cited file imports this module; runtime use and architectural role are not inferred. | UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/HeartRateCellView.swift:9 |
receive(on:) describes downstream delivery scheduling, while subscribe(on:) describes upstream subscription/request/cancel scheduling. An import Combine alone establishes neither behavior nor a Store, reducer, Redux, or other application architecture.
Class and protocol design
UseSwiftUIWithUIKit/AppDelegate.swift:11 — representative type boundary
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
// ...
return true
// ...
}| Type | Responsibility | Depends on or conforms to |
|---|---|---|
AppDelegate |
Receives callback-driven events | UIResponder, UIApplicationDelegate |
HeartRateCellView |
User-interface presentation and input forwarding | View |
HeartRateTitleView |
User-interface presentation and input forwarding | View |
HeartRateBPMView |
User-interface presentation and input forwarding | View |
HeartRateChartView |
User-interface presentation and input forwarding | View |
SleepCellView |
User-interface presentation and input forwarding | View |
SleepChartView |
User-interface presentation and input forwarding | View |
SleepTimeInBedView |
User-interface presentation and input forwarding | View |
HourMinuteView |
User-interface presentation and input forwarding | View |
HealthCategoryCellView |
User-interface presentation and input forwarding | View |
No local protocol conformance is claimed as protocol-oriented design; external framework conformances are listed only as dependencies.
Access control
| Symbol | Access | Verified effect | Likely rationale |
|---|---|---|---|
data (UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:55) |
private |
Use is restricted to the lexical declaration and same-file extensions allowed by Swift. | Inference: keep state mutation or dependency lifetime inside the owning implementation. |
dataStore (UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:143) |
private |
Use is restricted to the lexical declaration and same-file extensions allowed by Swift. | Inference: keep state mutation or dependency lifetime inside the owning implementation. |
collectionView (UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:146) |
private |
Use is restricted to the lexical declaration and same-file extensions allowed by Swift. | Inference: keep state mutation or dependency lifetime inside the owning implementation. |
dataSource (UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:149) |
private |
Use is restricted to the lexical declaration and same-file extensions allowed by Swift. | Inference: keep state mutation or dependency lifetime inside the owning implementation. |
Reference code
UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:55 — representative boundary
private var data: (conditions: [MedicalCondition], conditionsByID: [MedicalCondition.ID: MedicalCondition]) = ([], [:]) {
// ...
NotificationCenter.default.post(name: .medicalConditionsDidChange, object: nil)
// ...
}Swift declarations without a modifier are internal; explicit private, fileprivate, private(set), public, or open entries above are interpreted by language semantics. Objective-C/C samples instead rely on header and implementation boundaries, which are not equivalent to Swift lexical privacy.
Logic ownership and placement
| Logic | Owning type or file | Placement rationale |
|---|---|---|
| View lifecycle, callbacks, and feature coordination | HostingConfigurationViewController, HostingControllerViewController, MainMenuViewController, MedicalConditionsViewController |
The source’s Controller suffix makes this role explicit. |
| Receives callback-driven events | AppDelegate, SceneDelegate |
The source’s Delegate suffix makes this role explicit. |
| Centralized state or persistence access | DataStore |
The source’s Store suffix makes this role explicit. |
| User-interface presentation and input forwarding | HealthCategoryCellView, HeartHealthAlertView, HeartRateBPMView, HeartRateCellView |
The source’s View suffix makes this role explicit. |
Design patterns
| Pattern | Source evidence | Purpose or tradeoff |
|---|---|---|
| View-controller organization | UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/HostingConfigurationExample.swift:27 |
A controller is the verified coordination boundary; this is MVC-style only where a separate model is present. |
| Delegate or data-source callbacks | UseSwiftUIWithUIKit/AppDelegate.swift:11 |
Callback protocols invert event delivery back into the sample’s owner. |
| Central store | UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:52 |
A store-named type centralizes feature state or persistence. |
| Publisher-backed observable state | UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift:26 |
Published properties notify observers while mutation remains with the state object. |
Naming conventions
- Types: Controller: HostingConfigurationViewController, HostingControllerViewController, MainMenuViewController, MedicalConditionsViewController; Delegate: AppDelegate, SceneDelegate; Store: DataStore; View: HealthCategoryCellView, HeartHealthAlertView, HeartRateBPMView, HeartRateCellView, HeartRateChartView.
- Protocols: no local protocol declaration in the scanned source.
- Methods:
application,generateRandomData,getDefaultConditions,medicalCondition,populateDefaultMedicalConditions,addNewMedicalCondition,delete,shuffleMedicalConditions. - Files:
UseSwiftUIWithUIKit/AppDelegate.swift,UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/HeartRateCellView.swift,UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/SleepCellView.swift,UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/HealthCategoryCellView.swift,UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/StepCountCellView.swift,UseSwiftUIWithUIKit/MainMenuViewController.swift.
Architecture takeaways
AppDelegateis the main source-visible entry or composition anchor for this sample.- Framework work reaches SwiftUI, UIKit, Charts through a deliberately small high-level chain; the detailed API graph remains inside the cited implementation files.
- Stored-property evidence identifies lifecycle collaboration; it does not by itself prove exclusive object ownership.
- Access-control conclusions separate verified language visibility from the likely design rationale.
- The source does not justify labeling the design protocol-oriented.
Source map
| Source file | Relevant symbols |
|---|---|
UseSwiftUIWithUIKit/AppDelegate.swift |
Cited implementation, AppDelegate, UIKit |
UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/HeartRateCellView.swift |
Cited implementation, Charts, HeartRateSample, HeartRateData, HeartRateCellView, HeartRateTitleView, HeartRateBPMView, HeartRateChartView, HeartRateCellView_Previews |
UseSwiftUIWithUIKit/Examples/Data Flow with SwiftUI Cells/CellDataFlowExample.swift |
Cited implementation, DataStore, @MainActor, ObservableObject, @Published, NotificationCenter, SwiftUI, Section, MedicalCondition, MedicalConditionView, MedicalConditionsViewController |
UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/HostingConfigurationExample.swift |
HostingConfigurationViewController, HealthSection, StaticData, LayoutMetrics |
UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/SleepCellView.swift |
SleepSample, SleepData, SleepCellView, SleepChartView, SleepTimeInBedView, HourMinuteView, SleepCellView_Previews |
UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/HealthCategoryCellView.swift |
HealthCategoryProperties, HealthCategory, HealthCategoryCellView, HealthCategoryCellView_Previews |
UseSwiftUIWithUIKit/Examples/SwiftUI in Cells/SwiftUI Views/StepCountCellView.swift |
StepData, StepCountCellView, StepCountCellView_Previews |
UseSwiftUIWithUIKit/MainMenuViewController.swift |
MenuItem, MainMenuViewController |
UseSwiftUIWithUIKit/SceneDelegate.swift |
SceneDelegate |
UseSwiftUIWithUIKit/Examples/SwiftUI View Controllers/HostingControllerExample.swift |
HeartHealthAlert, HeartHealthAlertView, HostingControllerViewController |