diff --git a/sites/docs/src/content/platform-integration/ios/setup.md b/sites/docs/src/content/platform-integration/ios/setup.md
index dccd8757e8..2bc5ffe8fe 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
@@ -79,16 +79,20 @@ 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][].
+ Install CocoaPods using [Homebrew][] by running 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
@@ -133,7 +137,7 @@ Set up each iOS device on which you want to test.

- 1. Configure your physical iOS device
+ 1. Enable Developer Mode
Apple requires enabling **[Developer Mode][]**
on the device to protect against malicious software.
@@ -176,7 +180,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 091a379c43..42913331d5 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
@@ -72,17 +72,21 @@ 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][].
+ Install CocoaPods using [Homebrew][] by running 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