Software requirements

#

To write and compile Flutter code for Android, you must have the following version of Windows and the listed software packages.

Operating system

#

Flutter supports developing on 64-bit versions of Windows 10 and 11.

Development tools

#

Download and install the Windows version of the following packages:

  • Git for Windows to manage Flutter versions and your own source code versioning.

  • Android Studio to debug and compile Java or Kotlin code for Android.

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

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:

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've installed Visual Studio Code and the Flutter extension for VS Code.

Prompt VS Code to install Flutter

#
  1. Launch VS Code.

  2. To open the Command Palette, press Control + Shift + P.

  3. In the Command Palette, type flutter.

  4. Select Flutter: New Project.

  5. VS Code prompts you to locate the Flutter SDK on your computer.

    1. If you have the Flutter SDK installed, click Locate SDK.

    2. If you don't have the Flutter SDK installed, click Download SDK.

      This option sends you the Flutter install page if you haven't installed Git for Windows as directed in the development tools prerequisites.

  6. When prompted Which Flutter template?, ignore it. Press Esc. You can create a test project after checking your development setup.

Download the Flutter SDK

#
  1. 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.

  2. Click Clone Flutter.

    While downloading Flutter, VS Code displays these pop-up notifications:

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

    The download and installation take a few minutes. If you suspect that the download has hung, click Cancel, then start the installation again.

    When the Flutter installation 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?
  3. Click Add SDK to PATH.

    When successful, a notification displays:

    The Flutter SDK was added to your PATH
  4. VS Code might display a Google Analytics notice.

    If you agree, click OK.

  5. To enable flutter in all PowerShell windows:

    1. Close, then reopen all PowerShell windows.
    2. Restart VS Code.

Download then install Flutter

#

To install Flutter, download the Flutter SDK bundle from its archive, move the bundle to where you want it stored, then extract the SDK.

  1. Download the following installation bundle to get the latest stable release of the Flutter SDK.

    (loading...)

    For other release channels, and older builds, check out the SDK archive.

    The Flutter SDK should download to the Windows default download directory: %USERPROFILE%\Downloads.

    If you changed the location of the Downloads directory, replace this path with that path. To find your Downloads directory location, check out this Microsoft Community post.

  2. Create a folder where you can install Flutter.

    Consider creating a directory at %USERPROFILE% (C:\Users\{username}) or %LOCALAPPDATA% (C:\Users\{username}\AppData\Local).

  3. Extract the file into the directory you want to store the Flutter SDK.

    PS C:\> Expand-Archive `
          –Path $env:USERPROFILE\Downloads\flutter_sdk_v1.0.0.zip `
          -Destination $env:USERPROFILE\dev\

    When finished, the Flutter SDK should be in the C:\user\{username}\dev\flutter directory.

Update your Windows PATH variable

#

Help

To run Flutter commands in PowerShell, add Flutter to the PATH environment variable. This section presumes that you installed the Flutter SDK in %USERPROFILE%\dev\flutter.

  1. Press Windows + Pause.

    If your keyboard lacks a Pause key, try Windows + Fn + B.

    The System > About dialog displays.

  2. Click Advanced System Settings > Advanced > Environment Variables...

    The Environment Variables dialog displays.

  3. In the User variables for (username) section, look for the Path entry.

    1. If the entry exists, double-click on it.

      The Edit Environment Variable dialog displays.

      1. Double-click in an empty row.

      2. Type %USERPROFILE%\dev\flutter\bin.

      3. Click the %USERPROFILE%\dev\flutter\bin entry.

      4. Click Move Up until the Flutter entry sits at the top of the list.

      5. Click OK three times.

    2. If the entry doesn't exist, click New....

      The Edit Environment Variable dialog displays.

      1. In the Variable Name box, type Path.

      2. In the Variable Value box, type %USERPROFILE%\dev\flutter\bin

      3. Click OK three times.

  4. To enable these changes, close and reopen any existing command prompts and PowerShell instances.

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
  • 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.

  1. Launch Android Studio.

    The Welcome to Android Studio dialog displays.

  2. Follow the Android Studio Setup Wizard.

  3. Install the following components:

    • Android SDK Platform, API 35
    • Android SDK Command-line Tools
    • Android SDK Build-Tools
    • Android SDK Platform-Tools
    • Android Emulator
  1. Launch Android Studio.

  2. Go to the Settings dialog to view the SDK Manager.

    1. If you have a project open, go to Tools > SDK Manager.

    2. 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.

  3. Click SDK Platforms.

  4. Verify that Android API 35 has been selected.

    If the Status column displays Update available or Not installed:

    1. Select Android API 35.

    2. Click Apply.

    3. When the Confirm Change dialog displays, click OK.

      The SDK Quickfix Installation dialog displays with a completion meter.

    4. 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.

  5. Click SDK Tools.

  6. Verify that the following SDK Tools have been selected:

    • Android SDK Command-line Tools
    • Android SDK Build-Tools
    • Android SDK Platform-Tools
    • Android Emulator
  7. If the Status column for any of the preceding tools displays Update available or Not installed:

    1. Select the needed tools.

    2. Click Apply.

    3. When the Confirm Change dialog displays, click OK.

      The SDK Quickfix Installation dialog displays with a completion meter.

    4. When the install finishes, click Finish.

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.

  1. Enable VM acceleration on your development computer.

  2. Start Android Studio.

  3. Go to the Settings dialog to view the SDK Manager.

    1. If you have a project open, go to Tools > Device Manager.

    2. 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.

  4. Click Virtual.

  5. Click Create Device.

    The Virtual Device Configuration dialog displays.

  6. Select either Phone or Tablet under Category.

  7. Select a device definition. You can browse or search for the device.

  8. Click Next.

  9. Click x86 Images.

  10. Click one system image for the Android version you want to emulate.

    1. 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.

    2. When the download completes, click Finish.

  11. Click Next.

    The Virtual Device Configuration displays its Verify Configuration step.

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

  13. Click Show Advanced Settings and scroll to Emulated Performance.

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

    This enables hardware acceleration and improves rendering performance.

  15. Verify your AVD configuration. If it is correct, click Finish.

    To learn more about AVDs, check out Managing AVDs.

  16. 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.

Set up your target Android device

#

Help

To configure your Flutter app to run on a physical Android device, you need a supported version of Android.

  1. Enable Developer options and USB debugging on your device as described in the Android documentation.

  2. [Optional] To leverage wireless debugging, enable Wireless debugging on your device as described in the Android documentation.

  3. Install the Google USB Driver.

  4. Plug your device into your Windows computer. If your device prompts you, authorize your computer to access your device.

  5. Verify that Flutter recognizes your connected Android device.

    In PowerShell, run:

    c:\> flutter devices

    By default, Flutter uses the version of the Android SDK where your adb tool is based. To use a different Android SDK installation path with Flutter, set the ANDROID_SDK_ROOT environment variable to that installation directory.

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.

  1. Open an elevated console window.

  2. Run the following command to enable signing licenses.

    C:> 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.

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

Check your development setup

#

Help

Run Flutter doctor

#

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

  1. Open PowerShell.

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

    PS C:> flutter doctor

As you chose to develop for Android, you do not need all components. If you followed this guide, the command should output [✓] for the tooling and platforms you set up.

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

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:

Manage your Flutter SDK

#

To learn more about managing your Flutter SDK installation, consult the following resources.