{"id":53372,"date":"2026-09-30T16:45:13","date_gmt":"2026-09-30T20:45:13","guid":{"rendered":"https:\/\/mjtsai.com\/blog\/?p=53372"},"modified":"2026-09-30T16:45:13","modified_gmt":"2026-09-30T20:45:13","slug":"backporting-swiftui-apis","status":"publish","type":"post","link":"https:\/\/mjtsai.com\/blog\/2026\/09\/30\/backporting-swiftui-apis\/","title":{"rendered":"Backporting SwiftUI APIs"},"content":{"rendered":"

Dave DeLong<\/a>:<\/p>\n

\n

I can improve the process of removing<\/em> backwards compatibility shims by using conditional compilation to remind me when they’re no longer necessary!<\/p>\n

[…]<\/p>\n

This does mean that the first time we change our deployment target, we’ll get a bunch of compilation errors. But given the nature of how Backport<\/code> is implemented, this should be a relatively quick process to move past. (And of course, you’re welcome to use #warning<\/code> instead of #error<\/code>).<\/p>\n<\/blockquote>\n\n

Shaps Benkau<\/a>:<\/p>\n

\n

SwiftUIBackports mirrors Apple’s SwiftUI API names, shapes, behavior, documentation, and availability where practical. This keeps app code familiar today, and easy to migrate away from once your deployment target reaches the native API.<\/p>\n

Backports are discovered through .backport<\/code>, the Backport<\/code> namespace, or backport<\/code>-prefixed environment values.<\/p>\n<\/blockquote>\n\n

Majid Jabrayilov<\/a>:<\/p>\n

\n

Usually, we don’t see many new APIs in intermediate releases like 27.1, but this time is different. Apple introduced several new iPhone Duo-related APIs in the 27.1 release. This week, we will learn how to use all of these new APIs without bumping your project’s target version.<\/p>\n

[…]<\/p>\n

Here we introduced the toolbarVerticalBehavior<\/code> function on the Backport<\/code> type that handles availability checks and calls the new APIs if available or returns a plain view when it is not available.<\/p>\n<\/blockquote>\n\n

Previously:<\/p>\n