We refer to Flutter official website to select the most important steps.
git installed, type git version in your Terminal.git installed, use Homebrew.homebrew installed, type brew install git.You can build apps with Flutter using any text editor or integrated development environment (IDE) combined with Flutter’s command-line tools.
Using an IDE with a Flutter extension or plugin provides code completion, syntax highlighting, widget editing assists, debugging, and other features.
Popular options include:
The Flutter team recommends installing Visual Studio Code 1.75 or later and the Flutter extension for VS Code. This combination simplifies installing the Flutter SDK.
To install the Flutter SDK, you can use the VS Code Flutter extension or download and install the Flutter bundle yourself. Here recommend use the VS Code Flutter extension.
Open VS Code.
To open the Command Palette, press Command + Shift + P.
In the Command Palette, type flutter.
Select Flutter: New Project.
VS Code prompts you to locate the Flutter SDK on your computer.
If you have the Flutter SDK installed, click Locate SDK.
If you do not have the Flutter SDK installed, click Download SDK.
This option sends you the Flutter install page if you have not installed Git for Windows as directed in the development tools prerequisites.
When prompted Which Flutter template?, ignore it. Press Esc. You can create a test project after checking your development setup.
When the Select Folder for Flutter SDK dialog displays, choose where you want to install Flutter.
VS Code places you in your user profile to start. Choose a different location.
Consider ~/development/
Click Clone Flutter.
While downloading Flutter, VS Code displays this pop-up notification:
Downloading the Flutter SDK. This may take a few minutes.
This download takes a few minutes. If you suspect that the download has hung, click Cancel then start the installation again.
Once it finishes downloading Flutter, the Output panel displays.
Checking Dart SDK version...
Downloading Dart SDK from the Flutter engine ...
Expanding downloaded archive...
When successful, VS Code displays this pop-up notification:
Initializing the Flutter SDK. This may take a few minutes.
While initializing, the Output panel displays the following:
Building flutter tool...
Running pub upgrade...
Resolving dependencies...
Got dependencies.
Downloading Material fonts...
Downloading Gradle Wrapper...
Downloading package sky_engine...
Downloading flutter_patched_sdk tools...
Downloading flutter_patched_sdk_product tools...
Downloading windows-x64 tools...
Downloading windows-x64/font-subset tools...
This process also runs flutter doctor -v. At this point in the procedure, ignore this output. Flutter Doctor might show errors that don’t apply to this quick start.
When the Flutter install succeeds, VS Code displays this pop-up notification:
Do you want to add the Flutter SDK to PATH so it's accessible
in external terminals?
VS Code may display a Google Analytics notice.
If you agree, click OK.
To enable flutter in all Terminal windows:
If you have installed all prerequisites and the Flutter SDK, you should be able to start developing Flutter on macOS for mobile-android.
Refer to Setup Android Development Environment to configure the Android environment.
Start Android Studio.
Go to the Settings dialog to view the SDK Manager.
If you have a project open, go to Tools > SDK Manager.
If the Welcome to Android Studio dialog displays, click the More Options icon that follows the Open button and click SDK Manager from the dropdown menu.
Click SDK Platforms.
Verify that Android API 33.0.0 has been selected.
If the Status column displays Update available or Not installed:
Select Android API 33.0.0.
Click Apply.
When the Confirm Change dialog displays, click OK.
The SDK Quickfix Installation dialog displays with a completion meter.
When the install finishes, click Finish.
After you installed the latest SDK, the Status column might display Update available. This means some additional system images might not be installed. You can ignore this and continue.
Click SDK Tools.
Verify that the following SDK Tools have been selected:
If the Status column for any of the preceding tools displays Update available or Not installed:
Select the needed tools.
Click Apply.
When the Confirm Change dialog displays, click OK.
The SDK Quickfix Installation dialog displays with a completion meter.
When the install finishes, click Finish.
To configure your Flutter app to run in the Android emulator, follow these steps:
Enable VM acceleration on your development computer.
Start Android Studio.
Go to the Settings dialog to view the SDK Manager.
If you have a project open, go to Tools > Device Manager.
If the Welcome to Android Studio dialog displays, click the More Options icon that follows the Open button and click Device Manager from the dropdown menu.
Click Virtual.
Click Create Device.
The Virtual Device Configuration dialog displays.
Select either Phone or Tablet under Category.
Select a device definition. You can browse or search for the device.
Click Next.
Click x86 Images if your Mac runs on an Intel CPU or ARM Images if your Mac runs on an Apple CPU.
Click one system image for the Android version you want to emulate.
If the desired image has a Download icon to the right of the Release Name, click it.
The SDK Quickfix Installation dialog displays with a completion meter.
When the download completes, click Finish.
Click Next.
The Virtual Device Configuration displays its Verify Configuation step.
To rename the Android Virtual Device (AVD), change the value in the AVD Name box.
Click Show Advanced Settings.
Scroll to Emulated Performance.
From the Graphics dropdown menu, select Hardware - GLES 2.0.
This enables hardware acceleration.
Verify your AVD configuration. If it is correct, click Finish.
To learn more about AVDs, check out Managing AVDs.
In the Device Manager dialog, click the Run icon to the right of your desired AVD. The emulator starts up and displays the default canvas for your selected OS version and device.
Before you can use Flutter and after you install all prerequisites, agree to the licenses of the Android SDK platform.
Open an elevated console window.
Run the following command to enable signing licenses.
$ flutter doctor --android-licenses
If you accepted the Android Studio licenses at another time, this command returns:
[========================================] 100% Computing updates...
All SDK package licenses accepted.
You can skip the next step.
Before agreeing to the terms of each license, read each with care.
The flutter doctor command validates that all components of a complete Flutter development environment for macOS.
Open the Terminal.
To verify your installation of all the components, run the following command.
$ flutter doctor
As you chose to develop for Android, you do not need all components. If you followed this guide, the result of your command should resemble:
Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.13.4, on macOS A.B chipset, locale en)
[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.0)
[!] Chrome - develop for the web
[!] Xcode - develop for iOS and macOS (Xcode not installed)
[✓] Android Studio (version 2022.3 (Giraffe) or later)
[✓] VS Code (version 1.81.1)
[✓] Connected device (1 available)
[✓] Network resources
! Doctor found issues in 2 categories.
We refer to Flutter official website to select the most important steps.
To write and compile Flutter code for mobile-ios, you must have the following version of macOS and the listed software packages.
Flutter supports macOS 10.14 (Mojave) or later.
> Important: When installing on an Apple Silicon Mac, install the Rosetta translation environment. Some components require the Rosetta.
sudo softwareupdate --install-rosetta --agree-to-license
Download and install the macOS version of the following packages:
git installed, type git version in your Terminal.git installed, use Homebrew.homebrew installed, type brew install git.The developers of the preceding software provide support for those products. To troubleshoot installation issues, consult that product’s documentation.
You can build apps with Flutter using any text editor or integrated development environment (IDE) combined with Flutter’s command-line tools.
Using an IDE with a Flutter extension or plugin provides code completion, syntax highlighting, widget editing assists, debugging, and other features.
Popular options include:
The Flutter team recommends installing Visual Studio Code 1.75 or later and the Flutter extension for VS Code. This combination simplifies installing the Flutter SDK.
To install the Flutter SDK, you can use the VS Code Flutter extension or download and install the Flutter bundle yourself. Here we recommend use VS Code Flutter extension.
Open VS Code.
To open the Command Palette, press Command + Shift + P.
In the Command Palette, type flutter.
Select Flutter: New Project.
VS Code prompts you to locate the Flutter SDK on your computer.
If you have the Flutter SDK installed, click Locate SDK.
If you do not have the Flutter SDK installed, click Download SDK.
This option sends you the Flutter install page if you have not installed Git for Windows as directed in the development tools prerequisites.
When prompted Which Flutter template?, ignore it. Press Esc. You can create a test project after checking your development setup.
When the Select Folder for Flutter SDK dialog displays, choose where you want to install Flutter.
VS Code places you in your user profile to start. Choose a different location.
Consider ~/development/
Click Clone Flutter.
While downloading Flutter, VS Code displays this pop-up notification:
Downloading the Flutter SDK. This may take a few minutes.
This download takes a few minutes. If you suspect that the download has hung, click Cancel then start the installation again.
Once it finishes downloading Flutter, the Output panel displays.
Checking Dart SDK version...
Downloading Dart SDK from the Flutter engine ...
Expanding downloaded archive...
When successful, VS Code displays this pop-up notification:
Initializing the Flutter SDK. This may take a few minutes.
While initializing, the Output panel displays the following:
Building flutter tool...
Running pub upgrade...
Resolving dependencies...
Got dependencies.
Downloading Material fonts...
Downloading Gradle Wrapper...
Downloading package sky_engine...
Downloading flutter_patched_sdk tools...
Downloading flutter_patched_sdk_product tools...
Downloading windows-x64 tools...
Downloading windows-x64/font-subset tools...
This process also runs flutter doctor -v. At this point in the procedure, ignore this output. Flutter Doctor might show errors that don’t apply to this quick start.
When the Flutter install succeeds, VS Code displays this pop-up notification:
Do you want to add the Flutter SDK to PATH so it's accessible
in external terminals?
VS Code may display a Google Analytics notice.
If you agree, click OK.
To enable flutter in all Terminal windows:
If you have installed all prerequisites and the Flutter SDK, you should be able to start developing Flutter on macOS for mobile-ios.
Refer to Setup iOS Development Environment to configure the iOS environment.
To develop Flutter apps for macOS, install Xcode to compile to native bytecode.
To configure the Xcode command-line tools to use the installed version, run the following commands.
$ sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'
To use the latest version of Xcode, use this path. If you need to use a different version, specify that path instead.
To install the iOS Simulator, run the following command.
$ xcodebuild -downloadPlatform iOS
Sign the Xcode license agreement.
$ sudo xcodebuild -license
Try to keep to the current version of Xcode.
With Xcode, you can run Flutter apps on an iOS device or on the simulator.
To prepare to run and test your Flutter app on the iOS simulator, follow this procedure.
To start the Simulator, run the following command:
open -a Simulator
Set your Simulator to use a 64-bit device. This covers the iPhone 5s or later.
From Xcode, choose a simulator device type.
From the Simulator app, go to File > Open Simulator > Choose your target iOS device.
To check the device version in the Simulator, open the Settings app > General > About.
The simulated high-screen density iOS devices might overflow your screen. If that appears true on your Mac, change the presented size in the Simulator app.
| Display Size | Menu command | Keyboard shortcut |
|---|---|---|
| Small | Window > Physical Size | Cmd + 1 |
| Moderate | Window > Point Accurate | Cmd + 2 |
| HD accurate | Window > Pixel Accurate | Cmd + 3 |
| Fit to screen | Window > Fit Screen | Cmd + 4 |
If your apps depend on Flutter plugins with native macOS code, install CocoaPods. Built using Ruby, CocoaPods handles the bundling of various dependencies across Flutter and macOS code.
To install and set up CocoaPods, run the following commands:
Install Homebrew if necessary.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install ruby using Homebrew.
$ brew install ruby
Install cocoapods using Homebrew.
$ brew install cocoapods
Using Homebrew reduces potential issues with chipsets and install permissions.
The flutter doctor command validates that all components of a complete Flutter development environment for macOS.
Open the Terminal.
To verify your installation of all the components, run the following command.
$ flutter doctor
As you chose to develop for iOS, you do not need all components. If you followed this guide, the result of your command should resemble:
Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.13.4, on macOS A.B chipset, locale en)
[!] Android toolchain - develop for Android devices
[!] Chrome - develop for the web
[✓] Xcode - develop for iOS and macOS (Xcode 15)
[!] Android Studio (not installed)
[✓] VS Code (version 1.81.1)
[✓] Connected device (1 available)
[✓] Network resources
! Doctor found issues in 3 categories.
Open the Command Palette.
Go to View > Command Palette or press + Shift + P.
Type flutter
Select the Flutter: New Project.
When prompted for Which Flutter Project, select Application.
Create or select the parent directory for the new project folder.
When prompted for a Project Name, enter test_drive.
Press Enter.
Wait for project creation to complete.
Open the lib directory, then the main.dart.
To learn what each code block does, check out the comments in that Dart file.
The previous commands create a Flutter project directory called my_app that contains a simple demo app that uses Material Components.
Run your example application on your desktop platform or in an iOS simulator or Android emulator.
Though you can deploy your app to the web, don’t choose that target for this tutorial. The web target doesn’t support hot reload at this time.
Open the Command Palette.
Go to View > Command Palette or press + Shift + P.
Type flutter
Select the Flutter: Select Device.
If no devices are running, this command prompts you to enable a device.
Select a target device from Select Device prompt.
After you select a target, start the app. Go to Run > Start Debugging or press F5.
Wait for the app to launch.
You can watch the launch progress in the Debug Console view.
After the app build completes, your device displays your app.
Congratulations, your flutter development environment for both Android and iOS is now successfully configured.
Mobile Development Expert with expertise in Flutter and React Native
Discover more Tech Basics content
Setting up an efficient iOS development environment requires careful configuration of tools, SDKs, and workflows that maximize productivity. This step-by-step guide covers Xcode installation and optimization, simulator configuration, device provisioning, debugging tools setup, and essential third-party utilities that streamline iOS application development from project initialization to App Store deployment.
User interface development has undergone radical transformation over the past decades, from static HTML pages to dynamic, interactive applications. This comprehensive analysis explores the historical progression of UI technologies, emerging patterns in modern development, and future trends that will shape how we build user interfaces, including the rise of component-based architectures and AI-assisted development.
Android development requires a sophisticated toolchain that supports modern app development practices and device fragmentation challenges. This detailed guide covers Android Studio installation and configuration, SDK management, emulator optimization, debugging tools setup, and build system configuration that enables efficient development and testing across the diverse Android ecosystem.
Starting macOS application development from scratch requires understanding Apple's development ecosystem, design principles, and platform-specific technologies. This beginner-friendly guide introduces the fundamentals of macOS app development, covering development tools setup, AppKit and SwiftUI frameworks, app architecture patterns, and distribution through the Mac App Store.
Flutter for macOS development opens new possibilities for creating native desktop applications with familiar mobile development patterns. This comprehensive guide covers the complete development lifecycle from environment setup to App Store deployment, including macOS-specific APIs, native integrations, window management, menu systems, and performance optimization techniques that ensure smooth desktop user experiences.
Flutter development requires deep understanding of its architecture, performance characteristics, and ecosystem to build production-ready applications that scale effectively. This comprehensive analysis provides an in-depth perspective on Flutter's strengths and limitations, covering widget architecture, state management solutions, platform integration strategies, and performance optimization techniques that enable developers to make informed decisions and build exceptional cross-platform applications.
