diff --git a/sites/docs/src/content/platform-integration/ios/setup.md b/sites/docs/src/content/platform-integration/ios/setup.md
index 34d7cdf3ef..158f612dd1 100644
--- a/sites/docs/src/content/platform-integration/ios/setup.md
+++ b/sites/docs/src/content/platform-integration/ios/setup.md
@@ -53,7 +53,7 @@ an iOS physical device or on the iOS Simulator.
1. Open your preferred terminal.
- 1. Run the following command to review and sign the Xcode licenses.
+ 1. Run the following command to review and sign the Xcode licenses:
```console
$ sudo xcodebuild -license
@@ -68,13 +68,18 @@ an iOS physical device or on the iOS Simulator.
To download iOS platform support and
the latest iOS Simulator runtimes,
- run the following command in your preferred terminal.
+ run the following command in your preferred terminal:
```console
$ xcodebuild -downloadPlatform iOS
```
- 1. Install CocoaPods
+ 1. Install CocoaPods (maybe)
+
+ **As of Flutter 3.44, Swift Package Manager is the default
+ package manager for iOS and macOS.
+ If your project or its dependencies don't use CocoaPods,
+ you don't need to install it.**
To support [Flutter plugins][] that use native iOS or macOS code,
install the latest version of [CocoaPods][].
@@ -95,25 +100,52 @@ an iOS physical device or on the iOS Simulator.
## Set up an iOS device {: #set-up-devices}
-We recommend starting with the iOS Simulator as
-it's easier to get set up than a physical iOS device.
-However, you should also test your app on an actual
+Start with the iOS Simulator because
+it is easier to set up than a physical iOS device.
+However, also test your app on an actual
physical device.
-Start the iOS Simulator with the following command:
+To run your Flutter app on the iOS Simulator, follow these steps:
+
+ 1. Start the iOS Simulator
+
+ To start the Simulator,
+ run the following command in your preferred terminal:
+
+ ```console
+ $ open -a Simulator
+ ```
+
+ If you need to install a simulator for a different iOS version,
+ check out [Downloading and installing additional Xcode components][]
+ on the Apple Developer site.
+
+ 1. Verify simulator settings
-```console
-$ open -a Simulator
-```
+ You can check and change the device type in the Simulator menu under
+ **File** > **Open Simulator**.
-If you need to install a simulator for a different OS version,
-check out [Downloading and installing additional Xcode components][]
-on the Apple Developer site.
+ 1. Run your app on the Simulator
+
+ To start your Flutter app on the running simulator,
+ navigate to your Flutter project directory and run:
+
+ ```console
+ $ flutter run
+ ```
+
+ Alternatively, select your iOS Simulator from the device selector in
+ [VS Code][] or [Android Studio][],
+ and launch your app with debugging enabled.
+
+{: .steps}
[Downloading and installing additional Xcode components]: {{site.apple-dev}}/documentation/xcode/downloading-and-installing-additional-xcode-components
+[VS Code]: /tools/vs-code#running-and-debugging
+[Android Studio]: /tools/android-studio#running-and-debugging
@@ -129,14 +161,14 @@ Set up each iOS device on which you want to test.
1. On first connecting an iOS device to your Mac,
your device displays the **Trust this computer?** dialog.
- 1. Click **Trust**.
+ 1. Tap **Trust** and enter the device passcode if prompted.
1. Enable Developer Mode
Apple requires enabling **[Developer Mode][]**
- on the device to protect against malicious software.
+ on iOS 16 or later to protect against malicious software.
:::note
If the **Developer Mode** option is not visible
@@ -146,81 +178,194 @@ Set up each iOS device on which you want to test.
which makes the option appear.
:::
- 1. Tap on **Settings** >
- **Privacy & Security** >
+ 1. Open **Settings** on your iOS device.
+
+ 1. Tap **Privacy & Security** >
**Developer Mode**.
1. Tap to toggle **Developer Mode** to **On**.
- 1. Restart the device.
+ 1. Tap **Restart**.
1. When the **Turn on Developer Mode?** dialog appears,
- tap **Turn On**.
+ tap **Turn On** and enter your passcode.
+
+ 1. Configure code signing in Xcode
+
+ To deploy and test an app on a physical iOS device,
+ establish trust between your Mac and the device by
+ signing your app with an Apple development certificate.
+
+ You can use a free personal Apple ID or an Apple Developer account.
+
+ 1. Open Xcode.
+
+ 1. Sign in to Xcode with your Apple Account:
+
+ 1. Open Xcode settings (**Xcode** >
+ **Settings...** or press Cmd + ,).
+
+ 1. Select the **Accounts** tab.
+
+ 1. Click the **+** button, select **Apple ID**, and click **Continue**.
+
+ 1. Enter your Apple ID and password to sign in.
+
+ 1. Close the settings dialog.
+
+ {: type="a"}
+
+ 1. Open the default Xcode workspace for your Flutter app:
+
+ ```console
+ $ open ios/Runner.xcworkspace
+ ```
+
+ 1. In the left project navigator, select the top-level **Runner** project.
+
+ 1. In the **Runner** target settings pane,
+ select the **Signing & Capabilities** tab.
+
+ 1. Check **Automatically manage signing**.
+
+ 1. Select your development team from the **Team** dropdown menu
+ (such as **Your Name (Personal Team)**).
+
+ Xcode creates and downloads your development certificate
+ and provisioning profile.
- 1. Create a developer code signing certificate
+ 
- To send your app to a physical iOS device,
- _even_ for testing, you must establish trust
- between your Mac and the device.
- In addition to trusting the device when that
- popup appears, you must upload a signed
- developer certificate to your device.
+ 1. If automatic signing fails, verify that your project has a unique
+ **Bundle Identifier** in the **General** tab
+ (for example, `com.example.yourname.appname`).
- To create a signed development certificate,
- you need an Apple ID.
- If you don't have one, [create one][apple-account-new].
- You must also enroll in the [Apple Developer program][]
- and create an [Apple Developer account][].
- If you're just _testing_ your app on an iOS device,
- a personal Apple Developer account is free and works.
+ 
:::note Apple Developer program
- When you want to _deploy_ your app to the App Store,
+ When you want to deploy your app to the App Store,
you must upgrade your personal Apple Developer account to
- a professional account.
+ a paid [Apple Developer Program][] account.
:::
- 1. Prepare the device
+ 1. Run your app on your device
- 1. Find the **VPN & Device Management** menu under **Settings**.
+ 1. Unlock your connected iOS device.
- Toggle your certificate to **Enable**.
+ 1. In your preferred terminal,
+ navigate to your Flutter project directory and run:
- :::note
- If you can't find the **VPN & Device Management** menu,
- run your app on your iOS device once, then try again.
- :::
+ ```console
+ $ flutter run
+ ```
+
+ If multiple devices are connected, select your iOS device from the prompt
+ or pass its ID with `flutter run -d `.
+
+ You can also select your device in [VS Code][] or [Android Studio][],
+ or open the project in Xcode and click the **Run** button
+ (Cmd + R).
+
+ 1. Trust the developer certificate on the device
+
+ The first time you deploy to a physical device,
+ trust the developer certificate on iOS:
+
+ 1. On your iOS device, open **Settings**.
+
+ 1. Tap **General** >
+ **VPN & Device Management**.
+
+ 1. Under the **Developer App** section, tap your certificate name.
+
+ 1. Tap **Trust \**.
- 1. Under the **Developer App** heading,
- you should find your certificate.
+ 1. When the confirmation dialog displays, tap **Trust**.
- 1. Tap the certificate.
+ 1. If the Mac displays a **codesign wants to access key...** dialog,
+ enter your macOS password and click **Always Allow**.
- 1. Tap **Trust "<certificate>"**.
+ 1. Open your Flutter app on your device or re-run `flutter run`.
- 1. When the dialog displays, tap **Trust**.
+ 1. (Optional) Set up wireless debugging
- If the **codesign wants to access key...** dialog appears:
+ To deploy and debug your app over Wi-Fi without a USB cable:
- 1. Enter your macOS password.
+ 1. Connect your iOS device to the same Wi-Fi network as your Mac.
- 1. Tap **Always Allow**.
+ 1. Set a passcode on your iOS device if you have not done so already.
+
+ 1. In Xcode, select **Window** >
+ **Devices and Simulators**
+ (or press Shift + Cmd + 2).
+
+ 1. Select your iOS device in the left sidebar.
+
+ 1. Check **Connect via Network**.
+
+ 1. Once the network icon appears next to the device name,
+ unplug your iOS device from your Mac.
{: .steps}
-[apple-account-new]: https://support.apple.com/en-us/108647
[Developer Mode]: {{site.apple-dev}}/documentation/xcode/enabling-developer-mode-on-a-device
-[Apple Developer program]: {{site.apple-dev}}/programs/
-[Apple Developer account]: {{site.apple-dev}}/account
+[Apple Developer Program]: {{site.apple-dev}}/programs/
----
+## Validate your setup {: #validate-setup}
+
+ 1. Check for toolchain issues
+
+ To check for any issues with your iOS development setup,
+ run the `flutter doctor` command in your preferred terminal:
+
+ ```console
+ $ flutter doctor -v
+ ```
+
+ If you see any errors or tasks to complete
+ under the **Xcode** or **CocoaPods** (if relevant) sections,
+ complete and resolve them, then
+ run `flutter doctor -v` again to verify your changes.
+
+ 1. Check for iOS devices
+
+ To ensure Flutter can discover your iOS Simulator or connected iOS device,
+ run `flutter devices` in your preferred terminal:
+
+ ```console
+ $ flutter devices
+ ```
+
+ You can also list available simulators with `flutter emulators`:
+
+ ```console
+ $ flutter emulators
+ ```
+
+ If you set up everything correctly,
+ at least one entry should appear with the platform marked as **ios**.
+
+ 1. Troubleshoot setup issues
+
+ If you need help resolving any setup issues,
+ check out [Install and setup troubleshooting][troubleshoot].
+ You can also review [iOS debugging][] in Flutter.
+
+ If you still have issues or questions,
+ reach out on one of the Flutter [community][] channels.
+
+{: .steps}
+
+[troubleshoot]: /install/troubleshoot
+[iOS debugging]: /platform-integration/ios/ios-debugging
+[community]: {{site.main-url}}/community
## Start developing for iOS {: #start-developing}
-**Congratulations.**
+Congratulations!
Now that you've set up iOS development for Flutter,
you can continue your Flutter learning journey while testing on iOS
or begin improving integration with iOS.