Getting started instructions for using Xcode to build a macOS app

[DamianLettie]

What information is missing?

I couldn't find instructions in https://docs.flutter.dev/get-started for using Xcode to build a macOS app.

I tried:

1. flutter create my_app
2. Open my_app/macos/Runner.xcworkspace in Xcode.
3. Build.

It failed with:

error: Unable to load contents of file list: '[...]/my_app/macos/Flutter/ephemeral/FlutterInputs.xcfilelist' (in target 'Flutter Assemble' from project 'Runner')
error: Unable to load contents of file list: '[...]/my_app/macos/Flutter/ephemeral/FlutterOutputs.xcfilelist' (in target 'Flutter Assemble' from project 'Runner')

I got it working by using the flutter command-line tool to build the project once before opening the workspace in Xcode. e.g.:

1. flutter create my_app
2. cd my_app
3. flutter build macos
4. Open my_app/macos/Runner.xcworkspace in Xcode.
5. Build.

These steps, or the preferred equivalent, should be documented on docs.flutter.dev.

How would you like us to fix this problem?

Include a section on using Xcode to build a macOS app on https://docs.flutter.dev/get-started.