From 582628fa63165e493b6e89314f885ed7fcb28cb3 Mon Sep 17 00:00:00 2001 From: Fatih Date: Sat, 6 Jun 2026 00:10:51 +0300 Subject: [PATCH 1/2] Update Swift Package Manager docs to reflect on-by-default behavior As of Flutter 3.44 stable, Swift Package Manager is on by default. Update the two SPM pages and the shared enable/disable partial so they no longer state SPM is off by default. CocoaPods remains documented as a fallback and the opt-out section is unchanged. Fixes #13447 --- .../docs/swift-package-manager/how-to-enable-disable.md | 7 +++++-- .../swift-package-manager/for-app-developers.md | 7 +++---- .../swift-package-manager/for-plugin-authors.md | 7 +++---- 3 files changed, 11 insertions(+), 10 deletions(-) diff --git a/sites/docs/src/_includes/docs/swift-package-manager/how-to-enable-disable.md b/sites/docs/src/_includes/docs/swift-package-manager/how-to-enable-disable.md index 752fbf3eb97..cbcf99f34a1 100644 --- a/sites/docs/src/_includes/docs/swift-package-manager/how-to-enable-disable.md +++ b/sites/docs/src/_includes/docs/swift-package-manager/how-to-enable-disable.md @@ -1,7 +1,10 @@ ## How to turn on Swift Package Manager -Flutter's Swift Package Manager support is turned off by default. -To turn it on: +As of Flutter 3.44, Flutter's Swift Package Manager support is turned on by +default. You don't need to do anything to enable it. + +If you're using an older Flutter version, or you previously turned Swift Package +Manager support off, turn it on: 1. Upgrade to the latest Flutter SDK: diff --git a/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-app-developers.md b/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-app-developers.md index 31c9274caad..f679e2ce08a 100644 --- a/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-app-developers.md +++ b/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-app-developers.md @@ -6,11 +6,10 @@ description: How to use Swift Package Manager for native iOS or macOS dependenci :::warning Flutter is migrating to [Swift Package Manager][] to manage iOS and macOS native dependencies. -Flutter's support of Swift Package Manager is under development. +As of Flutter 3.44, Swift Package Manager support is [on by default][]. If you find a bug in Flutter's Swift Package Manager support, [open an issue][]. -Swift Package Manager support is [off by default][]. -Flutter continues to support CocoaPods. +Flutter continues to support CocoaPods as a fallback. ::: Flutter's Swift Package Manager integration has several benefits: @@ -23,7 +22,7 @@ Flutter's Swift Package Manager integration has several benefits: Swift Package Manager. [Swift Package Manager]: https://www.swift.org/documentation/package-manager/ -[off by default]: #how-to-turn-on-swift-package-manager +[on by default]: #how-to-turn-on-swift-package-manager [Swift packages]: https://swiftpackageindex.com/ [open an issue]: {{site.github}}/flutter/flutter/issues/new?template=2_bug.yml diff --git a/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-plugin-authors.md b/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-plugin-authors.md index 037ca5f7b75..f32b99431c1 100644 --- a/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-plugin-authors.md +++ b/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-plugin-authors.md @@ -6,11 +6,10 @@ description: How to add Swift Package Manager compatibility to iOS and macOS plu :::warning Flutter is migrating to [Swift Package Manager][] to manage iOS and macOS native dependencies. -Flutter's support of Swift Package Manager is under development. +As of Flutter 3.44, Swift Package Manager support is [on by default][]. If you find a bug in Flutter's Swift Package Manager support, [open an issue][]. -Swift Package Manager support is [off by default][]. -Flutter continues to support CocoaPods. +Flutter continues to support CocoaPods as a fallback. ::: Flutter's Swift Package Manager integration has several benefits: @@ -24,7 +23,7 @@ Flutter's Swift Package Manager integration has several benefits: [Swift Package Manager]: https://www.swift.org/documentation/package-manager/ -[off by default]: #how-to-turn-on-swift-package-manager +[on by default]: #how-to-turn-on-swift-package-manager [Swift packages]: https://swiftpackageindex.com/ [open an issue]: {{site.github}}/flutter/flutter/issues/new?template=2_bug.yml From 7e3212fdc5277c2b9e3645a2fd113df82694df05 Mon Sep 17 00:00:00 2001 From: Fatih Date: Sat, 6 Jun 2026 00:31:39 +0300 Subject: [PATCH 2/2] Use "enabled by default" terminology per review feedback Apply the review suggestions: use "enabled by default" / "disabled" / "enable it" instead of "on by default" / "turned off" / "turn it on", and update the reference-link labels accordingly. --- .../docs/swift-package-manager/how-to-enable-disable.md | 8 ++++---- .../swift-package-manager/for-app-developers.md | 4 ++-- .../swift-package-manager/for-plugin-authors.md | 4 ++-- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/sites/docs/src/_includes/docs/swift-package-manager/how-to-enable-disable.md b/sites/docs/src/_includes/docs/swift-package-manager/how-to-enable-disable.md index cbcf99f34a1..8bffd3fd617 100644 --- a/sites/docs/src/_includes/docs/swift-package-manager/how-to-enable-disable.md +++ b/sites/docs/src/_includes/docs/swift-package-manager/how-to-enable-disable.md @@ -1,10 +1,10 @@ ## How to turn on Swift Package Manager -As of Flutter 3.44, Flutter's Swift Package Manager support is turned on by -default. You don't need to do anything to enable it. +As of Flutter 3.44, Flutter's Swift Package Manager support is enabled by +default. No additional steps are required to use it. -If you're using an older Flutter version, or you previously turned Swift Package -Manager support off, turn it on: +If you're using an older Flutter version, or you previously disabled Swift Package +Manager support, you can enable it: 1. Upgrade to the latest Flutter SDK: diff --git a/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-app-developers.md b/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-app-developers.md index f679e2ce08a..ffd8ec38b77 100644 --- a/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-app-developers.md +++ b/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-app-developers.md @@ -6,7 +6,7 @@ description: How to use Swift Package Manager for native iOS or macOS dependenci :::warning Flutter is migrating to [Swift Package Manager][] to manage iOS and macOS native dependencies. -As of Flutter 3.44, Swift Package Manager support is [on by default][]. +As of Flutter 3.44, Swift Package Manager support is [enabled by default][]. If you find a bug in Flutter's Swift Package Manager support, [open an issue][]. Flutter continues to support CocoaPods as a fallback. @@ -22,7 +22,7 @@ Flutter's Swift Package Manager integration has several benefits: Swift Package Manager. [Swift Package Manager]: https://www.swift.org/documentation/package-manager/ -[on by default]: #how-to-turn-on-swift-package-manager +[enabled by default]: #how-to-turn-on-swift-package-manager [Swift packages]: https://swiftpackageindex.com/ [open an issue]: {{site.github}}/flutter/flutter/issues/new?template=2_bug.yml diff --git a/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-plugin-authors.md b/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-plugin-authors.md index f32b99431c1..7a3fe441d98 100644 --- a/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-plugin-authors.md +++ b/sites/docs/src/content/packages-and-plugins/swift-package-manager/for-plugin-authors.md @@ -6,7 +6,7 @@ description: How to add Swift Package Manager compatibility to iOS and macOS plu :::warning Flutter is migrating to [Swift Package Manager][] to manage iOS and macOS native dependencies. -As of Flutter 3.44, Swift Package Manager support is [on by default][]. +As of Flutter 3.44, Swift Package Manager support is [enabled by default][]. If you find a bug in Flutter's Swift Package Manager support, [open an issue][]. Flutter continues to support CocoaPods as a fallback. @@ -23,7 +23,7 @@ Flutter's Swift Package Manager integration has several benefits: [Swift Package Manager]: https://www.swift.org/documentation/package-manager/ -[on by default]: #how-to-turn-on-swift-package-manager +[enabled by default]: #how-to-turn-on-swift-package-manager [Swift packages]: https://swiftpackageindex.com/ [open an issue]: {{site.github}}/flutter/flutter/issues/new?template=2_bug.yml