2025最新版 Android Studio配置Flutter组件

Flutter 简介

Flutter 是由 Google 开发的开源 UI 工具包，用于从单一代码库为移动（iOS, Android）、Web、桌面甚至嵌入式设备构建美观、高性能的应用程序。是追求开发效率、跨平台一致性和快速迭代的现代化解决方案，正迅速成为主流。

Android Studio必备组件

在安装之前我们必须要清楚，无论是Flutter还是原生Android开发，以下组件都是必不可少的，因为它们是Android开发生态系统的核心：

总结来说：

• Android Studio 安装包自带： 特定版的 JDK—— JBR。
• Android Studio 首次启动或配置时自动下载/管理： Android SDK 的核心组件，以及通过 Gradle Wrapper 自动下载的 Gradle 。
• 需要手动安装/配置： Flutter SDK，（Dart SDK 随 Flutter SDK 一起）。
• 通过 Android Studio 插件管理器安装： Flutter Plugin 和 Dart Plugin

2025最新版 Android Studio安装及组件配置（SDK、JDK、Gradle）文中单独介绍过Android Studio原生Android版的基本配置，本文将在其基础上单独介绍Flutter版本的配置步骤。 更详细完整的对比内容可见：2025新版 万字Android Studio安装及组件配置（原生Android&Flutter）

一、Flutter SDK安装

1.前往Flutter官网下载

• 建议下载Stable（稳定版）的，我下载的是图上的版本
  
• 解压压缩包
  
  2.配置环境变量（设置国内镜像）

正如flutter官网所介绍的那样，为了加速Flutter工具的下载和运行，我们需要配置国内镜像

• 常规步骤:右键此电脑–属性–高级系统设置–环境变量
• 新建2个系统变量：
  • 变量名：PUB_HOSTED_URL
    • 变量值：https://pub.flutter-io.cn
      
  • 变量名：FLUTTER_STORAGE_BASE_URL
    • 变量值：https://storage.flutter-io.cn
      

• 点击Path,添加Flutter SDK的bin目录路径

F:\Flutter\flutter_windows_3.29.3-stable\flutter\bin

• 点击“确定”保存设置
  3.验证Flutter安装
• 打开命令提示符窗口
• 运行 flutter doctor 命令
  
• flutter doctor 会检查Flutter环境，列出需要安装或配置的其他组件
  

二、完善配置和工具链

• 解决 cmdline-tools component is missing ：
  （说明Android SDK Command-line Tools这个核心组件没有正确安装或路径配置有问题）
  1. 打开 Android Studio： Tools -> SDK Manager。
  2. 到 SDK Tools 标签页。
  3. 找到并勾选 “Android SDK Command-line Tools”
  4. 点击 Apply 或 OK 开始安装
  

• 解决 Android license status unknown ：
  （说明没有接受Android SDK的许可协议）
  1. 以管理员身份运行命令提示符
  2. 输入flutter doctor --android-licenses
  3. 按照提示输入 y 接受所有Android SDK许可证。
  
  

• 解决 Chrome - develop for the web ...... ：

  • 原因：找不到 Chrome 可执行文件，无法直接在 Flutter 中使用 Chrome 浏览器进行 Web 开发调试
  • 前往Chrome 官网下载安装
    

• 解决 Visual Studio - develop Windows apps...... ：

  • 原因：需要安装 Visual Studio，Flutter 应用在 Windows 桌面 上运行时，需要调用 Visual Studio 的 C++ 构建工具链来编译 Windows 原生代码

  • 前往Visual Studio官网下载安装
    

  • 勾选 “使用 C++ 的桌面开发” 工作负载

  • 修改目录到非C盘
    

• 重新检查一下：flutter doctor
  
  没有问题了

三、配置flutter插件

1.打开Android Studio：File–Settings–Plugins
2.搜索 Flutter和Dart，并点击 Install


3.安装完成后，重启Android Studio生效

四、创建Flutter项目

1.File–New–New Flutter Project
在下图位置选择你的flutter路径

2.填写相关内容后开始创建

3.试运行一下Flutter版

• 出现一个问题：

Error: No Windows desktop project configured. See https://flutter.dev/to/add-desktop-support to learn about adding Windows support to a project.

• 原因：

因为还没有配置好支持Windows桌面平台，Flutter本身是跨平台的，但每个新的Flutter项目默认创建时只包含了移动端（Android/iOS）和Web的配置。如果要在Windows桌面上运行，需要手动添加对Windows平台的支持。

• 解决：
  • 打开Flutter项目的命令行终端
    
  • 运行以下命令来添加Windows桌面支持：

    flutter create --platforms=windows .
    

注意：命令末尾的 . 非常重要，它表示在当前目录（即项目根目录）添加平台支持，而不是创建一个新的项目

重新试运行一下，成功