Set up iOS development

Learn how to set up your development environment to run, build, and deploy Flutter apps for iOS devices.

With Xcode, you can run Flutter apps on an iOS physical device or on the iOS Simulator.

1. Install Xcode

   If you haven't done so already, install and set up the latest version of Xcode.

   If you've already installed Xcode, update it to the latest version using the same installation method you used originally.

2. Set up Xcode command-line tools

   To configure the Xcode command-line tools to use the version of Xcode you installed, run the following command in your preferred terminal:

   sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

   If you downloaded Xcode elsewhere or need to use a different version, replace /Applications/Xcode.app with the path to there instead.

3. Agree to the Xcode licenses

   After you've set up Xcode and configured its command-line tools, agree to the Xcode licenses.

   1. Open your preferred terminal.

   2. Run the following command to review and sign the Xcode licenses.

      sudo xcodebuild -license

   3. Read and agree to all necessary licenses.

      Before agreeing to the terms of each license, read each with care.

4. Download prerequisite tooling

   To download iOS platform support and the latest iOS Simulator runtimes, run the following command in your preferred terminal.

   xcodebuild -downloadPlatform iOS

5. Install Rosetta

   If you're developing on an Apple Silicon (ARM) Mac, install Rosetta 2:

   sudo softwareupdate --install-rosetta --agree-to-license

6. Install CocoaPods

   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.

   If you've already installed CocoaPods, update it by following the CocoaPods update guide.

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 physical device.

open -a Simulator

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.

Continue learning Flutter

• Write your first app
• Learn the fundamentals
• Explore Flutter widgets
• Check out samples
• Learn about Dart

Build for iOS

• Build and deploy to iOS
• Bind to native iOS code
• Leverage system frameworks
• Embed native iOS views
• Use Swift Package Manager