Start building Flutter Android apps on Windows

Get started
Install
Windows
Make Android apps
Verify system requirements
#
To install and run Flutter, your Windows environment must meet the following
hardware and software requirements.

Hardware requirements
#
Your Windows Flutter development environment must meet the following minimal
hardware requirements.

Requirement Minimum Recommended

x86_64 CPU Cores 4 8
Memory in GB 8 16
Display resolution in pixels WXGA (1366 x 768) FHD (1920 x 1080)
Free disk space in GB 11.0 60.0
Software requirements
#
To write and compile Flutter code for Android, you must have the following version
of Windows and the listed software packages.

Tip
You do not need to install Dart separately as the Flutter SDK includes the full
Dart SDK.

Operating system
#
Flutter supports 64-bit version of Microsoft Windows 10 or later. These versions of
Windows should include the required Windows PowerShell 5 or later.

Development tools
#
Download and install the Windows version of the following packages:

Git for Windows 2.27 or later to manage source code.

Android Studio 2024.1.1 (Koala) or later to debug and compile Java or Kotlin code
for Android. Flutter requires the full version of Android Studio.

The developers of the preceding software provide support for those products. To
troubleshoot installation issues, consult that product's documentation.

When you run the current version of flutter doctor, it might list a different
version of one of these packages. If it does, install the version it recommends.

Configure a text editor or IDE

#
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:

Visual Studio Code 1.86 or later with the Flutter extension for VS Code.
Android Studio 2024.1.1 (Koala) or later with the Flutter plugin for IntelliJ.
IntelliJ IDEA 2024.1 or later with the Flutter plugin for IntelliJ.
Recommended
The Flutter team recommends installing Visual Studio Code 1.86 or later and the
Flutter extension for VS Code. This combination simplifies installing the Flutter
SDK.

Install the Flutter SDK

#
To install the Flutter SDK, you can use the VS Code Flutter extension or download
and install the Flutter bundle yourself.

Use VS Code to install Flutter

#
To install Flutter using these instructions, verify that you have installed Visual
Studio Code 1.86 or later and the Flutter extension for VS Code.

Prompt VS Code to install Flutter

#
Launch VS Code.

To open the Command Palette, press Control + 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.

Download the Flutter SDK

#
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 %USERPROFILE% or C:\dev.

Warning
Don't install Flutter to a directory or path that meets one or both of the
following conditions:

The path contains special characters or spaces.

The path requires elevated privileges.
As an example, C:\Program Files fails both conditions.

Click Clone Flutter.

While downloading Flutter, VS Code displays this pop-up notification:

Downloading the Flutter SDK. This may take a few minutes.

content_copy
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...
content_copy
When successful, VS Code displays this pop-up notification:

Initializing the Flutter SDK. This may take a few minutes.

content_copy
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...
content_copy
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?
content_copy
Click Add SDK to PATH.

When successful, a notification displays:

The Flutter SDK was added to your PATH

content_copy
VS Code may display a Google Analytics notice.

If you agree, click OK.

To enable flutter in all PowerShell windows:

Close, then reopen all PowerShell windows.

Restart VS Code.
Configure Android development
#
Configure the Android toolchain in Android Studio
#
Help
To create Android apps with Flutter, verify that the following Android components
have been installed.

Android SDK Platform, API 35.0.2

Android SDK Command-line Tools
Android SDK Build-Tools
Android SDK Platform-Tools
Android Emulator
If you haven't installed these, or you don't know, continue with the following
procedure.

Otherwise, you can skip to the next section.

Launch Android Studio.

The Welcome to Android Studio dialog displays.

Follow the Android Studio Setup Wizard.

Install the following components:

Android SDK Platform, API 35.0.2

Android SDK Command-line Tools
Android SDK Build-Tools
Android SDK Platform-Tools
Android Emulator
Configure your target Android device
#
Set up the Android emulator
#
Help

To configure your Flutter app to run in an Android emulator, follow these steps to
create and select an emulator.

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.

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 Configuration step.

To rename the Android Virtual Device (AVD), change the value in the AVD Name box.

Click Show Advanced Settings and scroll to Emulated Performance.

From the Graphics dropdown menu, select Hardware - GLES 2.0.

This enables hardware acceleration and improves rendering performance.

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 Android OS
version and device.

Agree to Android licenses

#
Help

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.

C:> flutter doctor --android-licenses

content_copy
If you accepted the Android Studio licenses at another time, this command returns:

[========================================] 100% Computing updates...

All SDK package licenses accepted.
content_copy
You can skip the next step.

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

Troubleshooting licensing issues

#
Check your development setup
#
Help

Run Flutter doctor

#
The flutter doctor command validates that all components of a complete Flutter
development environment for Windows.

Open PowerShell.

To verify your installation of all the components, run the following command.

PS C:> flutter doctor

content_copy
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.29.1, on Microsoft Windows 11 [Version
10.0.22621.3155], locale en)
[✓] Windows version (Installed version of Windows is version 10 or higher)
[✓] Android toolchain - develop for Android devices (Android SDK version 35.0.2)
[!] Chrome - develop for the web
[!] Visual Studio - develop Windows apps
[✓] Android Studio (version 2024.2)
[✓] VS Code (version 1.96)
[✓] Connected device (1 available)
[✓] Network resources

! Doctor found issues in 2 categories.

content_copy
Troubleshoot Flutter doctor issues
#
When the flutter doctor command returns an error, it could be for Flutter, VS Code,
Android Studio, the connected device, or network resources.

If the flutter doctor command returns an error for any of these components, run it
again with the verbose flag.

PS C:> flutter doctor -v

content_copy
Check the output for other software you might need to install or further tasks to
perform.

If you change the configuration of your Flutter SDK or its related components, run
flutter doctor again to verify the installation.

Start developing Android on Windows apps with Flutter

#
Congratulations. Having installed all prerequisites and the Flutter SDK, you can
start developing Flutter apps for Android on Windows.

To continue on your learning journey, consult the following guides:

Learn how to write your first Flutter app

Flutter fundamentals docs
Manage your Flutter SDK
#
To learn more about managing your Flutter SDK install, consult the following
resources.
Upgrade Flutter
Add web as a build target
Add Windows desktop compilation tools
Uninstall Flutter
Next
Create your first app
chevron_right
Was this page's content helpful?
Unless stated otherwise, the documentation on this site reflects the latest stable
version of Flutter. Page last updated on 2024-10-28. View source or report an
issue.

Flutter logo
Except as otherwise noted, this site is licensed under a Creative Commons
Attribution 4.0 International License, and code samples are licensed under the 3-
Clause BSD License.