# Deprecating your own convenience API

DevFeed: [Deprecating your own convenience API](<https://devfeed.tech/articles/deprecating-your-own-convenience-api-51710.md>)

Original publisher: [Read original article](<https://swiftwithmajid.com/2026/05/19/deprecating-your-own-convenience-api/>)

Author: Majid Jabrayilov (cmecid@gmail.com)

Published: 2026-05-19T00:00:00Z

Content type: tutorial

Language: en

Sources: [Swift with Majid](<https://devfeed.tech/sources/swift-with-majid.md>)

Topics: [iOS](<https://devfeed.tech/topics/ios.md>), [Swift](<https://devfeed.tech/topics/swift.md>), [implementation](<https://devfeed.tech/topics/implementation.md>), [Compiler](<https://devfeed.tech/topics/compiler.md>)

Tags: [compiler](<https://devfeed.tech/tags/compiler.md>), [how-to](<https://devfeed.tech/tags/how-to.md>), [implementation](<https://devfeed.tech/tags/implementation.md>), [ios](<https://devfeed.tech/tags/ios.md>), [swift](<https://devfeed.tech/tags/swift.md>), [swift-ios-development-apple-watch-iphone-ipad-swiftui-macos-uikit-dev-wwdc-tutorial-guide-redux-tea](<https://devfeed.tech/tags/swift-ios-development-apple-watch-iphone-ipad-swiftui-macos-uikit-dev-wwdc-tutorial-guide-redux-tea.md>), [swift-language-features](<https://devfeed.tech/tags/swift-language-features.md>)

## AI overview

A Swift tutorial on deprecating custom convenience APIs used to bridge behavior across iOS versions. It explains how availability annotations can make the compiler flag transitional code as warnings and later errors when the app's minimum platform version increases.

## Source excerpt

Almost after every major update of iOS, we got new APIs that we use on the most recent platform but can't use on the previous one. Usually, I solve this kind of thing by introducing my own convenience code that runs new APIs on the available versions and my custom implementation or stubs on old platform versions.