Sample CodeiOS, iPadOS, Mac CatalystReviewed 2026-07-21View on Apple Developer

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 AppDelegateHostingConfigurationViewControllerDataStoreUIKit 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

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

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

  • AppDelegate is 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