From e5e5fc0795273a8d5a78c40cabfe6170a47f5144 Mon Sep 17 00:00:00 2001 From: Kevin Lamenzo Date: Tue, 4 Aug 2026 20:45:12 +0000 Subject: [PATCH 1/3] Fix for ticket 542694885 (GitHub issue #12446) --- .../src/content/platform-integration/ios/setup.md | 13 +++++++++---- .../src/content/platform-integration/macos/setup.md | 13 +++++++++---- 2 files changed, 18 insertions(+), 8 deletions(-) diff --git a/sites/docs/src/content/platform-integration/ios/setup.md b/sites/docs/src/content/platform-integration/ios/setup.md index dccd8757e87..5a1bee93d69 100644 --- a/sites/docs/src/content/platform-integration/ios/setup.md +++ b/sites/docs/src/content/platform-integration/ios/setup.md @@ -79,16 +79,21 @@ an iOS physical device or on the iOS Simulator. To support [Flutter plugins][] that use native iOS or macOS code, install the latest version of [CocoaPods][]. - Install CocoaPods by following the - [CocoaPods installation guide][]. + We recommend using [Homebrew][] to install CocoaPods. + Run the following command: - If you've already installed CocoaPods, - update it by following the [CocoaPods update guide][]. + ```console + $ brew install cocoapods + ``` + + To learn about other installation methods, + see the [CocoaPods installation guide][]. {: .steps} [xcode]: {{site.apple-dev}}/xcode/ [cocoapods]: https://guides.cocoapods.org/using/getting-started.html#installation +[Homebrew]: https://brew.sh/ [Flutter plugins]: /packages-and-plugins/developing-packages#types [CocoaPods installation guide]: https://guides.cocoapods.org/using/getting-started.html#installation [CocoaPods update guide]: https://guides.cocoapods.org/using/getting-started.html#updating-cocoapods diff --git a/sites/docs/src/content/platform-integration/macos/setup.md b/sites/docs/src/content/platform-integration/macos/setup.md index 091a379c438..a39dc2e33e9 100644 --- a/sites/docs/src/content/platform-integration/macos/setup.md +++ b/sites/docs/src/content/platform-integration/macos/setup.md @@ -72,17 +72,22 @@ compile and debug native Swift and Objective-C code. To support [Flutter plugins][] that use native macOS code, install the latest version of [CocoaPods][]. - Install CocoaPods following the - [CocoaPods installation guide][]. + We recommend using [Homebrew][] to install CocoaPods. + Run the following command: - If you've already installed CocoaPods, - update it following the [CocoaPods update guide][]. + ```console + $ brew install cocoapods + ``` + + To learn about other installation methods, + see the [CocoaPods installation guide][]. {: .steps} [xcode]: {{site.apple-dev}}/xcode/ [Flutter plugins]: /packages-and-plugins/developing-packages#types [CocoaPods]: https://cocoapods.org/ +[Homebrew]: https://brew.sh/ [CocoaPods installation guide]: https://guides.cocoapods.org/using/getting-started.html#installation [CocoaPods update guide]: https://guides.cocoapods.org/using/getting-started.html#updating-cocoapods From 90b40046d03cd2168fc2bf2b5408a6a9bbed56c1 Mon Sep 17 00:00:00 2001 From: Kevin Lamenzo Date: Thu, 6 Aug 2026 14:55:43 +0000 Subject: [PATCH 2/3] Apply senior writer review style fixes --- sites/docs/src/content/platform-integration/ios/setup.md | 6 +++--- sites/docs/src/content/platform-integration/macos/setup.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/sites/docs/src/content/platform-integration/ios/setup.md b/sites/docs/src/content/platform-integration/ios/setup.md index 5a1bee93d69..d34e7d435d2 100644 --- a/sites/docs/src/content/platform-integration/ios/setup.md +++ b/sites/docs/src/content/platform-integration/ios/setup.md @@ -44,7 +44,7 @@ an iOS physical device or on the iOS Simulator. ``` If you downloaded Xcode elsewhere or need to use a different version, - replace `/Applications/Xcode.app` with the path to there instead. + replace `/Applications/Xcode.app` with the path to your Xcode installation. 1.

Agree to the Xcode licenses

@@ -138,7 +138,7 @@ Set up each iOS device on which you want to test. ![Trust Mac](/assets/images/docs/setup/trust-computer.png) - 1.

Configure your physical iOS device

+ 1.

Enable Developer Mode

Apple requires enabling **[Developer Mode][]** on the device to protect against malicious software. @@ -181,7 +181,7 @@ Set up each iOS device on which you want to test. :::note Apple Developer program When you want to _deploy_ your app to the App Store, - you'll need to upgrade your personal Apple Developer account to + you must upgrade your personal Apple Developer account to a professional account. ::: diff --git a/sites/docs/src/content/platform-integration/macos/setup.md b/sites/docs/src/content/platform-integration/macos/setup.md index a39dc2e33e9..c7942ee7374 100644 --- a/sites/docs/src/content/platform-integration/macos/setup.md +++ b/sites/docs/src/content/platform-integration/macos/setup.md @@ -44,7 +44,7 @@ compile and debug native Swift and Objective-C code. ``` If you downloaded Xcode elsewhere or need to use a different version, - replace `/Applications/Xcode.app` with the path to there instead. + replace `/Applications/Xcode.app` with the path to your Xcode directory. 1.

Agree to the Xcode licenses

From 0b67edc2c4fe8e305e9812378e09b449dd030262 Mon Sep 17 00:00:00 2001 From: Kevin Lamenzo Date: Thu, 6 Aug 2026 15:30:44 +0000 Subject: [PATCH 3/3] Fix style guideline: avoid first-person pronouns --- sites/docs/src/content/platform-integration/ios/setup.md | 3 +-- sites/docs/src/content/platform-integration/macos/setup.md | 3 +-- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/sites/docs/src/content/platform-integration/ios/setup.md b/sites/docs/src/content/platform-integration/ios/setup.md index d34e7d435d2..2bc5ffe8fe0 100644 --- a/sites/docs/src/content/platform-integration/ios/setup.md +++ b/sites/docs/src/content/platform-integration/ios/setup.md @@ -79,8 +79,7 @@ an iOS physical device or on the iOS Simulator. To support [Flutter plugins][] that use native iOS or macOS code, install the latest version of [CocoaPods][]. - We recommend using [Homebrew][] to install CocoaPods. - Run the following command: + Install CocoaPods using [Homebrew][] by running the following command: ```console $ brew install cocoapods diff --git a/sites/docs/src/content/platform-integration/macos/setup.md b/sites/docs/src/content/platform-integration/macos/setup.md index c7942ee7374..42913331d59 100644 --- a/sites/docs/src/content/platform-integration/macos/setup.md +++ b/sites/docs/src/content/platform-integration/macos/setup.md @@ -72,8 +72,7 @@ compile and debug native Swift and Objective-C code. To support [Flutter plugins][] that use native macOS code, install the latest version of [CocoaPods][]. - We recommend using [Homebrew][] to install CocoaPods. - Run the following command: + Install CocoaPods using [Homebrew][] by running the following command: ```console $ brew install cocoapods