macOS: Update minimum macOS version to 10.15 #168101

cbracken · 2025-04-30T20:55:01Z

This updates the Flutter minimum macOS version from 10.14 to 10.15 adds a migrator for existing apps, and updates our own examples, tests, and benchmark apps to 10.15. A follow-up patch will drop macOS 10.15 @available checks in the embedder.

This is required in order to use Swift in the embedder and not need to bundle the Swift runtime libs in every app that uses Flutter. Swift stable ABI was introduced in macOS 10.14.4.

As of March 2025, usage of macOS 10.14 is approximately 1.2~1.8% depending on source of statistics, see example public usage data here:
https://gs.statcounter.com/macos-version-market-share/desktop/worldwide

This patch makes the following changes:

Updates mac_deployment_target from 12.0 to 13.0.
Changes templates to MACOSX_DEPLOYMENT_TARGET, MinimumOSVersion, and Podfile platform :osx to 10.15.
Adds migrator for Podfile part to migrate platform :osx, '10.14' -> platform :osx, '10.15'
Compiles with -mmacosx-version-min=10.15
Runs the migrator on all example apps and integration tests.
Updates examples, tests to macOS 10.15 deployment target

Issue: #167745

Pre-launch Checklist

I read the Contributor Guide and followed the process outlined there for submitting PRs.
I read the Tree Hygiene wiki page, which explains my responsibilities.
I read and followed the Flutter Style Guide, including Features we expect every widget to implement.
I signed the CLA.
I listed at least one issue that this PR fixes in the description above.
I updated/added relevant documentation (doc comments with ///).
I added new tests to check the change I am making, or this PR is test-exempt.
I followed the breaking change policy and added Data Driven Fixes where supported.
All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel on Discord.

iOS deployment target was migrated from 12 to 13 in: * flutter#167737 macOS deployment target was migrated from 10.14 to 10.15 in: * flutter#168101 Issue: flutter#167735 Issue: flutter#167745

cbracken · 2025-04-30T22:34:39Z

/cc all the people who might care about this. Blog entry added in the doc.

hellohuanlin · 2025-04-30T22:45:37Z

packages/flutter_tools/test/general.shard/macos/macos_project_migration_test.dart

@@ -218,7 +218,7 @@ keep this 2
      expect(testLogger.statusText, isEmpty);
    });

-    testWithoutContext('Xcode project is migrated from 10.11 to 10.14', () async {
+    testWithoutContext('Xcode project is migrated from 10.11 to 10.15', () async {


curious how migration script works - say a user is on 10.11, do they run migration scripts for 10.12, 10.13, 10.14, and then finally 10.15? Or is it migrating from any versions above directly to 10.15?

It migrates directly, but only if the deployment target is one we set in the Xcode project template. If they updated it themselves to something specific, they are on their own:

https://github.com/flutter/flutter/pull/168101/files/fd43a43386f9ce5a07aad729d7c360628a9640ac#diff-346db78c4cd00cab61b70cc48b895efee275ecbbfed6ef55e6b8ae7436375e29R38-R40

…er#168101)

This reverts commit f524fe3.

This reverts commit 4c5d0de.

cbracken added 4 commits April 29, 2025 13:34

Increase mac_deployment_target from 10.14 to 10.15

93aac04

macOS: migrate templates/podhelper to macOS 10.15

0e6c2bc

macOS: update migrator to migrate to 10.15

408fb8a

macOS: Migrate examples/tests/benchmarks to 10.15

bf56055

cbracken requested a review from a team as a code owner April 30, 2025 20:55

update flag

fd43a43

cbracken requested review from loic-sharma, vashworth and hellohuanlin April 30, 2025 22:03

cbracken changed the title ~~bump macos 10.14 to 10.15~~ macOS: Update minimum macOS version to 10.15 Apr 30, 2025

cbracken requested review from stuartmorgan-g and zanderso April 30, 2025 22:23

hellohuanlin approved these changes Apr 30, 2025

View reviewed changes

cbracken added the autosubmit Merge PR when tree becomes green via auto submit App label May 1, 2025

cbracken added this pull request to the merge queue May 1, 2025

Merged via the queue into flutter:master with commit 4c5d0de May 1, 2025
178 checks passed

cbracken deleted the bump-macos-10.14-to-10.15 branch May 1, 2025 04:31

flutter-dashboard bot removed the autosubmit Merge PR when tree becomes green via auto submit App label May 1, 2025

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 1, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

75572e3

…er#168101)

engine-flutter-autoroll mentioned this pull request May 1, 2025

Roll Flutter from cfb887cd5f41 to b982d4274953 (190 revisions) flutter/packages#9189

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 1, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

86cfd87

…er#168101)

engine-flutter-autoroll mentioned this pull request May 2, 2025

Roll Flutter from cfb887cd5f41 to 48f87a5fe76a (210 revisions) flutter/packages#9190

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 2, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

bef22c2

…er#168101)

engine-flutter-autoroll mentioned this pull request May 2, 2025

Roll Flutter from cfb887cd5f41 to 9ffc2d9ef3a6 (211 revisions) flutter/packages#9191

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 2, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

8c01d2e

…er#168101)

engine-flutter-autoroll mentioned this pull request May 2, 2025

Roll Flutter from cfb887cd5f41 to 057a77b49e39 (212 revisions) flutter/packages#9192

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 2, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

11ecbba

…er#168101)

engine-flutter-autoroll mentioned this pull request May 2, 2025

Roll Flutter from cfb887cd5f41 to 07b09836576b (213 revisions) flutter/packages#9193

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 2, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

cb33137

…er#168101)

engine-flutter-autoroll mentioned this pull request May 2, 2025

Roll Flutter from cfb887cd5f41 to f454856afce9 (214 revisions) flutter/packages#9194

Closed

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 2, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

ea52ee6

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 3, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

3b66b11

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 3, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

a69f4cd

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 4, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

844a114

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 5, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

e680080

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 5, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

645b496

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 5, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

4e14d5c

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 5, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

b31a97a

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 5, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

8cab07f

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 5, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

9551b08

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 5, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

d981517

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 5, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

4a40d10

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 6, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

f5cb63e

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 6, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

bdd75c2

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 6, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

75e4758

…er#168101)

engine-flutter-autoroll added a commit to engine-flutter-autoroll/packages that referenced this pull request May 6, 2025

4c5d0de98 macOS: Update minimum macOS version to 10.15 (flutter/flutt…

2a13069

…er#168101)

pranavo72bex added a commit to pranavo72bex/flutter that referenced this pull request May 7, 2025

Revert "macOS: Update minimum macOS version to 10.15 (flutter#168101)"

7d6ea0c

This reverts commit f524fe3.

pranavo72bex added a commit to pranavo72bex/flutter that referenced this pull request May 7, 2025

Revert "macOS: Update minimum macOS version to 10.15 (flutter#168101)"

5fbeb65

This reverts commit 4c5d0de.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

macOS: Update minimum macOS version to 10.15 #168101

macOS: Update minimum macOS version to 10.15 #168101

cbracken commented Apr 30, 2025 •

edited

Loading

cbracken commented Apr 30, 2025

hellohuanlin Apr 30, 2025

jmagman Apr 30, 2025

macOS: Update minimum macOS version to 10.15 #168101

macOS: Update minimum macOS version to 10.15 #168101

Conversation

cbracken commented Apr 30, 2025 • edited Loading

Pre-launch Checklist

cbracken commented Apr 30, 2025

hellohuanlin Apr 30, 2025

Choose a reason for hiding this comment

jmagman Apr 30, 2025

Choose a reason for hiding this comment

cbracken commented Apr 30, 2025 •

edited

Loading