Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Flutter and app store releases

Flutter iOS build fails: UIApplication does not conform to protocol 'Launcher'

ErrorUIApplication does not conform to protocol 'Launcher'

Short answer

This is a compile error inside the url_launcher_ios plugin, not in your code. An old plugin version does not build with the newer iOS SDK in recent Xcode. The release notes say 6.3.1 fixed it. Upgrade url_launcher_ios, and raise url_launcher's constraint if it holds the old one back.

  • Applies to Flutter 3.35, Xcode 26, url_launcher_ios 6.3.1 and later
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Read which url_launcher_ios version is locked in your project.

    grep -n -A3 "url_launcher_ios" pubspec.lock
  2. 2Match what you see, then jump to its fix

    1. 1pubspec.lock shows a version lower than 6.3.1.The locked url_launcher_ios is older than 6.3.1Fix
    2. 2The upgrade command leaves url_launcher_ios on the old version.The url_launcher constraint holds the iOS package backFix

What does the error look like?

  • UIApplication does not conform to protocol 'Launcher'
  • Error in url_launcher_ios while building the iOS app in Xcode

Cause 1 of 2

The locked url_launcher_ios is older than 6.3.1

1Check

The package changelog lists 6.3.1 as the release that fixes a compile error when conforming UIApplication to Launcher in the iOS 18 SDK.

grep -n -A3 "url_launcher_ios" pubspec.lock

2Fix

Upgrade the plugin to the highest version your pubspec.yaml allows, then rebuild.

flutter pub upgrade
flutter build ios --no-codesign

3Verify

pubspec.lock now shows 6.3.1 or later and the build passes.

grep -n -A3 "url_launcher_ios" pubspec.lock

Confirmed by pub.dev

Did this fix it?

Cause 2 of 2

The url_launcher constraint holds the iOS package back

1Check

The lockfile moves only within the constraints in pubspec.yaml, so an old upper bound on url_launcher keeps the old iOS implementation.

grep -n "url_launcher" pubspec.yaml
dart pub upgrade --major-versions --dry-run

2Fix

Raise the url_launcher constraint, then upgrade. Commit pubspec.yaml first so you can undo it; --major-versions also updates the constraints.

dart pub upgrade --major-versions url_launcher

3Verify

Run the iOS build again.

flutter build ios --no-codesign

Confirmed by dart.dev

Did this fix it?

How do I stop it coming back?

  • Upgrade packages with flutter pub upgrade before moving to a new Xcode major version, not after the build breaks.
  • Commit pubspec.lock for apps so every machine and CI builds the same plugin versions.
  • Build for iOS in CI on the Xcode version you ship with.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Projects of mine built on the same technologies:

Related fixes

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.