Lowered minimum deployment versions for iOS and Mac Catalyst to allow launch on iOS versions 15 and 16 by adamjansch · Pull Request #782 · hummingbird-project/hummingbird

adamjansch · 2026-02-09T15:58:46Z

Fix for issue 781: #781.

The main changes are lowering the minimum deployment version in the Package.swift files to .v15 for iOS and Mac Catalyst, which are the only two platforms I'm able to test this change on.

These changes then required @available or #available attributes to be added to specific classes, extensions and methods (as dictated by the compiler). In many places, iOS 16 could be used rather than iOS 17, so I used the lower version in these places.

Before this change I was experiencing a crash as detailed in the issue linked above. After this change, my app builds and runs successfully on Apple's iOS 16 simulator, and on an iPhone 6s I have running iOS 15.8.5.

… on iOS 15 and 16 Lowered minimum deployment versions for iOS and Mac Catalyst to allow launch on iOS versions 15 and 16.

adam-fowler

If we're going to do this, let's do it properly. I've added a suggestion for platform in the Package.swift. You would then have to tag everything

@available(macOS 15, iOS 18, macCatalyst 18, tvOS 18, visionOS 2, *)

Also can you make sure you've compiled the PerformanceTest target and all the tests

adam-fowler · 2026-02-10T08:09:20Z

Package.swift

 let package = Package(
    name: "hummingbird",
-    platforms: [.macOS(.v14), .iOS(.v17), .macCatalyst(.v17), .tvOS(.v17), .visionOS(.v1)],
+    platforms: [.macOS(.v14), .iOS(.v15), .macCatalyst(.v15), .tvOS(.v17), .visionOS(.v1)],


Suggested change

platforms: [.macOS(.v14), .iOS(.v15), .macCatalyst(.v15), .tvOS(.v17), .visionOS(.v1)],

platforms: [.macOS(.v10_15), .iOS(.v13), .macCatalyst(.v13), .tvOS(.v13), .visionOS(.v1)],

Joannis · 2026-02-10T09:41:06Z

Thanks for the PR! I concur with @adam-fowler too

…l on iOS 15 and 16 Included macOS (native), tvOS, and visionOS into the lower version party.

adamjansch · 2026-02-10T21:58:47Z

@adam-fowler @Joannis Some notes on the new commit:

I went through macOS, tvOS, and visionOS platforms, as well as all the packages separately and believe I got everything.
I didn't use the versions in @adam-fowler's comment, as Xcode doesn't provide a selection for those version in the minimum deployment dropdown, and no simulators exist to test those versions.
I also didn't add specific Mac Catalyst or visionOS versions in the @available/#available attributes, as the former tracks the iOS version, and the latter is so new that all versions of visionOS are supported.

codecov · 2026-02-11T11:11:32Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.00%. Comparing base (12aed8f) to head (ebe3a99).
⚠️ Report is 4 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #782      +/-   ##
==========================================
+ Coverage   82.94%   83.00%   +0.06%     
==========================================
  Files         124      124              
  Lines        6185     6185              
==========================================
+ Hits         5130     5134       +4     
+ Misses       1055     1051       -4

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

adam-fowler · 2026-02-11T11:16:32Z

Package.swift

 let package = Package(
    name: "hummingbird",
-    platforms: [.macOS(.v14), .iOS(.v17), .macCatalyst(.v17), .tvOS(.v17), .visionOS(.v1)],
+    platforms: [.macOS(.v11), .iOS(.v15), .macCatalyst(.v15), .tvOS(.v15), .visionOS(.v1)],


The equivalent versions of macOS and iOS are three versions apart eg 11 and 14, 12 and 15. Which pair of versions should it be?

I've used the earliest versions of each platform that Xcode allowed me to select for minimum deployment version in the project settings. If you want I could raise macOS to 12.

Why can't you set iOS 14?

Xcode doesn't have that option in its drop down. All devices that run iOS 14 also run iOS 15, so there shouldn't be a reason for someone to run iOS 14.

It doesn't mean those users have iOS 15 installed. You are editing Package.swift with a text editor yeah? You can type whatever you want. I'd prefer to stick to the three versions apart and upping the requirement for macOS doesn't seem very sensible.

Package.swift may be editable in a text editor, but someone integrating Hummingbird into an iOS app will very likely be doing that in Xcode, and there's no option in Xcode for them to select a version iOS 14 as minimum.

I'm assuming the lowest version selectable in Xcode would be the minimum that Apple are willing to support, so is this 3-version difference relevant in that case?

Sources/Hummingbird/Application.swift

Sources/HummingbirdCore/Server/HTTP/HTTPServerBuilder.swift

Sources/HummingbirdCore/Server/Server.swift

Sources/HummingbirdCore/Server/ServerChildChannel.swift

… on iOS 15 and 16 Code review changes – applied version restrictions to ApplicationProtocol and Application types.

adam-fowler

PerformanceTest target requires macOS 14 etc
Also HummingbirdTesting needs @available(macOS 14, iOS 17, tvOS 17, *) wherever ApplicationProtocol is referenced
And finally you need to run swift format on the code

swift format format -ir Sources

After that we should be good

adam-fowler · 2026-02-23T10:33:19Z

Sources/PerformanceTest/main.swift

-
-struct Object: ResponseEncodable {
-    let message: String
+if #available(macOS 13, iOS 16, tvOS 16, *) {


Suggested change

if #available(macOS 13, iOS 16, tvOS 16, *) {

if #available(macOS 14, iOS 17, tvOS 17, *) {

adam-fowler · 2026-02-23T10:34:53Z

Sources/PerformanceTest/main.swift

+
+    // run app
+    try await app.runService()
 }


Suggested change

}

} else {

fatalError("Hummingbird requires macOS 14, iOS 17 or tvOS 17")

}

adam-fowler · 2026-02-23T10:37:43Z

Sources/HummingbirdTesting/Application+Test.swift

 }

 /// Extends `ApplicationProtocol` to support testing of applications
+@available(macOS 13, iOS 16, tvOS 16, *)


Suggested change

@available(macOS 13, iOS 16, tvOS 16, *)

@available(macOS 14, iOS 17, tvOS 17, *)

Issue 781 – Crash when trying to run with Hummingbird library install…

34da40f

… on iOS 15 and 16 Lowered minimum deployment versions for iOS and Mac Catalyst to allow launch on iOS versions 15 and 16.

adamjansch requested review from Joannis and adam-fowler as code owners February 9, 2026 15:58

adam-fowler reviewed Feb 10, 2026

View reviewed changes

Issue 781 – Crash when trying to run with Hummingbird library instal…

b94bc6e

…l on iOS 15 and 16 Included macOS (native), tvOS, and visionOS into the lower version party.

adam-fowler reviewed Feb 11, 2026

View reviewed changes

adam-fowler reviewed Feb 17, 2026

View reviewed changes

Issue 781 – Crash when trying to run with Hummingbird library install…

ebe3a99

… on iOS 15 and 16 Code review changes – applied version restrictions to ApplicationProtocol and Application types.

adam-fowler reviewed Feb 23, 2026

View reviewed changes

	platforms: [.macOS(.v14), .iOS(.v15), .macCatalyst(.v15), .tvOS(.v17), .visionOS(.v1)],
	platforms: [.macOS(.v10_15), .iOS(.v13), .macCatalyst(.v13), .tvOS(.v13), .visionOS(.v1)],

	if #available(macOS 13, iOS 16, tvOS 16, *) {
	if #available(macOS 14, iOS 17, tvOS 17, *) {

-}
+} else {
+    fatalError("Hummingbird requires macOS 14, iOS 17 or tvOS 17")
+}

	@available(macOS 13, iOS 16, tvOS 16, *)
	@available(macOS 14, iOS 17, tvOS 17, *)

Uh oh!

Comments

Conversation

adamjansch commented Feb 9, 2026

Uh oh!

adam-fowler left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Joannis commented Feb 10, 2026

Uh oh!

adamjansch commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov bot commented Feb 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

adam-fowler left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

adamjansch commented Feb 10, 2026 •

edited

Loading

codecov bot commented Feb 11, 2026 •

edited

Loading