Integrating Flutter into Android Studio: a complete guide from installation to the first project

Cross-platform development has become the standard for creating mobile applications that work equally well on both Flutter has become the standard for creating mobile applications that work equally well on Android and iOS. However, many developers encounter difficulties already at the stage of setting up the environment - especially when it comes to integration Flutter SDK c Android Studio. This article will not only tell you how to add Flutter to Android Studio, but also explain why each step is important, what pitfalls can arise, and how to avoid them.

If you are switching from native development to Kotlin/Java or are just starting out in mobile development, this guide will help save you hours of searching for solutions to common mistakes. We will consider not only the basic installation, but also optimization Android Studio for working with Flutter, setting up emulators, and even the nuances of working with pubspec.yaml. And at the end - answers to the most common questions that beginners have.

1. Checking system requirements before installing Flutter

Before downloading Flutter SDK, make sure your system meets the minimum requirements. This will eliminate errors at the installation stage and save time.

To work with Flutter v Android Studio you need:

• 🖥️ Operating system: Windows 10/11 (64-bit), macOS (x86_64 or ARM), or Linux (64-bit). Support Windows 7/8 officially discontinued.
• 💾 Free disk space: no less 2.8 GB (excluding Android SDK i emulators). Recommended 10+ GB for comfortable work.
• 🔧 Development tools: Git (for version control), Android Studio 2022.3+ (or IntelliJ IDEA with plugins).
• 📱 Device for testing: physical Android smartphone with software debugging enabled USB or emulator (Android Virtual Device).

Flutter does not support 32-bit systems and virtual machines without hardware acceleration (for example, VirtualBox without Hyper-V enabled). If you use macOS on Apple Silicon (M1/M2), you will need additional configuration to work with Android Emulator.

⚠️ Attention: Hardware and software requirements may change with the release of new versions FlutterBefore installation, check the current conditions on official website.

2. Installing the Flutter SDK: step-by-step guide

Downloading and installing Flutter SDK —the first critical stage. Errors here will lead to problems with dependencies and building projects.

Follow this algorithm:

1. Download the archive from the Flutter SDK s official website. Select the version for your OS (stable channel recommended for beginners).
2. Unpack the archive to a folder without spaces and Cyrillic characters in the path (for example, C:\src\flutter or /Users/yourname/development/flutter).
3. Add Flutter to the environment variable PATH:
   • 🪟 Windows: Control Panel → System → Advanced system settings → Environment variables → add the path to flutter\bin.
   • 🍎 macOS/Linux: add a line to ~/.bashrc or ~/.zshrc:

     export PATH="$PATH:[PATH_TO_FLUTTER]/flutter/bin"

flutter doctor

If flutter doctor produces errors related to Android Licensefollow:

flutter doctor --android-licenses

and agree to all license agreements (click y for each item).

3. Setting up Android Studio to work with Flutter

Android Studio is the main tool for development on Flutter, but by default it is not configured to work with it framework. You will need:

Install plugins:

1. Open Android Studio → go to File → Settings → Plugins (or Android Studio → Preferences → Plugins to macOS).
2. Find and install two plugins:
   • 🔧 Flutter —the main plugin to support the framework.
   • 📱 Dart —the programming language in which Flutter applications are written.

Create a new Flutter project:

1. In the start window, select New Flutter Project.
2. Specify the project type - for example, Flutter Application.
3. Specify the project name (without spaces or special characters), the path to save and click Finish.

If an error occurs when creating a project "Flutter SDK not found", check:

• 📁 Is the path to correct? data-i="130">in settings Flutter SDK in settings Android Studio (File → Settings → Languages & Frameworks → Flutter).
• 🔄 Restart Android Studio after changing the path.

4. Setting up an Android emulator for testing Flutter applications

Without an emulator or a physical device, you will not be able to test your application. Flutter requires Android Emulator with support x86_64 or ARM.

How to create a virtual device:

1. Open AVD Manager to Android Studio (icon in the form of a phone with a plus).
2. Click Create Virtual Device → select a model (for example, Pixel 5).
3. Download the system image (Android 13+ recommended for the latest versions Flutter).
4. Configure the emulator parameters:
   • 🖥️ RAM: minimum 2 GB (optimally 4 GB).
   • 💾 Internal Storage: 8 GB is enough for most projects.
   • 🔄 Graphics: Hardware - GLES 2.0 for better performance.

Common problems with the emulator and their solutions:

⚠️ Attention: On macOS with Apple Silicon chip (M1/M2) standard Android Emulator does not work. Use alternatives: Android Studio Arctic Fox+ with support for ARMemulators or a physical device.

5. First launch of a Flutter project: debugging and common errors

After setting up the environment, the moment of truth has come - launching the first project. Even if everything is configured correctly, unexpected errors may occur.

How to run the project:

1. Open the file main.dart in Android Studio.
2. Select the target device (emulator or physical) in the top panel.
3. Press the green button Run (or Shift + F10).

Typical errors and their solutions:

• 🚨 "No devices available":
  • Check if the emulator is running (AVD Manager).
  • For a physical device, enable USB Debugging in Settings → For developers.
• 🚨 "Flutter plugin not installed":
  • Reinstall the plugins Flutter in Dart in Android Studio.
  • Check that the path to Flutter SDK specified correctly in the settings.
• 🚨 "Gradle build failed":
  • Update Gradle in the file android/gradle/wrapper/gradle-wrapper.properties (the current version is indicated in Gradle documentation).
  • Run flutter clean and rebuild the project.

If the application starts but displays a white screen, check:

• 📝 Correctness of the code in main.dart (there must be a widget MaterialApp).
• 🔍 Logs in the console Android Studio (Run → Debug).
💡

If the project is not built, always run flutter clean i first - this solves 80% of dependency problems. flutter pub get - this solves 80% of dependency problems.

6. Optimizing Android Studio for convenient work with Flutter

By default Android Studio is not optimized for Flutter. Several settings will significantly speed up development:

Useful settings:

• ⚡ Enable Hot Reload:
  • Keyboard shortcut: Ctrl + S (save) + R in the terminal console.
  • Or button Hot Reload in the top panel (icon with lightning).
• 🔍 Configure Dart Analysis:
  • Go to File → Settings → Editor → Inspections.
  • Disable unnecessary warnings (for example, "Unused import" for test files).
• 📁 Use .gitignore:
  • Add to the file:

    /.dart_tool/
    /build/
    /android/.gradle/
    /android/local.properties

Recommended plugins for Flutter development:

Plugin	Purpose	Installation link
Flutter Intl	Automatic generation of localizations (i18n)	Marketplace in Android Studio
Dart Data Class Generator	Generation of class templates using JSON	Marketplace in Android Studio
Rainbow CSV	Color marking CSVfiles (useful for data)	Marketplace in Android Studio

If Android Studio slows down when working with large Flutterprojects, try:

• 🔧 Enlarge Heap Size to Help → Edit Custom VM Options (add line -Xmx4G).
• 🗑️ Clear cache once a week (File → Invalidate Caches).

7. Working with dependencies: pubspec.yaml and common errors

The file is the heart of any project. Dependencies ( pubspec.yaml - anyone's heart Flutter-project. Dependencies are indicated here (packages), resources and application settings are indicated here. Errors in this file are one of the main reasons for build failures.

Basic rules of operation. with pubspec.yaml:

• 📌 Versioning:
  • Use ^1.2.3 to automatically update minor versions.
  • For stability, fix versions without ^ (for example, 1.2.3).
• 🔄 Update dependencies:
  • Run flutter pub outdated to check for outdated packages.
  • Update dependencies with command flutter pub upgrade.
• 🚫 Dependency conflicts:
  • If two packages require different versions of the same library, use dependency_overrides (carefully!).

Example of correct pubspec.yaml:

name: my_app
description: A new Flutter project

version: 1.0.0+1

environment:
sdk: ">=2.19.0 <3.0.0"

dependencies:
flutter:
sdk: flutter
cupertino_icons: ^1.0.2
http: 0.13.5 # Fixed version for stability

dev_dependencies:
flutter_test:
sdk: flutter
flutter_lints: ^2.0.0

Frequent errors and solutions:

• 🚨 "Because every version of package X depends on Y, which doesn't match...":
  How to resolve the conflict dependencies?

  Use the command flutter pub deps --style=compactto see the chain of dependencies. Then add the pubspec.yaml block dependency_overrides block with the desired package version. For example:

  dependency_overrides:
  shared_preferences: 2.0.15

  Attention: This is a temporary solution! Update the main dependencies as soon as possible.

• 🚨 "Target of URI doesn't exist: 'package:...":
  • Do flutter pub get.
  • Check for typos in the package name.

⚠️ Attention: Never commit a folder to the repository .pub-cache —it takes up gigabytes and contains temporary files. Add it to .gitignore.

FAQ: Answers to frequently asked questions

Is it possible to use Flutter in Android Studio without plugins?
Technically yes, but it is extremely inconvenient. Without plugins Flutter and Dart you will lose:
• 🔍 Syntax highlighting and code completion.
• 🐞 Built-in debugger and Hot Reload.
• 📦 Management dependencies through the interface Android Studio.

Plugins take up less 50 MB and significantly speed up development.

flutter upgrade

flutter channel beta
flutter upgrade

adb kill-server
adb start-server