[PAGE ISSUE]: 'Start building Flutter iOS apps on macOS' - we seem to skip over explicit inline instructions to install XCode

[sethladd]

Page URL

https://docs.flutter.dev/get-started/install/macos/mobile-ios/

Page source

https://github.com/flutter/website/tree/main/src/content/get-started/install/macos/mobile-ios.md

Describe the problem

Following the install process, it appears we don't explicitly tell someone to install Xcode inline at the right point.

Actual:

Under "Development Tools" I saw a summary of what I assumed is what we will do by following these steps. Including installing Xcode. I glanced over this section because it didn't sound like I needed to do this right now.

Especially because the "Development Tools" section talks about installing CocoaPods, but later on in the article, we explicitly call out a step to install CocoaPods.

So, when you get to $ sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch' , that will fail because you didn't install XCode (again, because it was kind of hidden/implied above).

Expected fix

Expected:

Under "Configure iOS development", the first sub-header should be "Install Xcode", before "Configure XCode".

This matches the later explicit "Install CocoaPods" instructions later.

Additional context

No response

I would like to fix this problem.

• [ ] I will try and fix this problem on docs.flutter.dev.