Flutter环境搭建Windows

最新推荐文章于 2025-05-02 17:13:45 发布

原创最新推荐文章于 2025-05-02 17:13:45 发布 · 770 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#flutter

Flutter 专栏收录该内容

1 篇文章

订阅专栏

本文详细介绍了在Windows上搭建Flutter开发环境的步骤，包括Flutter SDK的下载、环境变量配置、使用国内镜像、检查环境、Android SDK的获取与配置、Android Studio的Flutter插件安装，以及创建并运行第一个Flutter项目的完整过程。遇到的Gradle构建问题及解决方法也一并说明。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

首发于https://blog.youkuaiyun.com/android1314mini/category_9972337.html

一、Flutter SDK

下载

https://flutter.dev/docs/development/tools/sdk/releases#windows
本次使用的是v1.12.13+hotfix.9版本

配置环境变量

下载完成后,把flutter sdk\bin的全路径加入系统环境变量path中
flutter sdk环境变量添加

使用镜像

由于在国内访问Flutter有时可能会受到限制，Flutter官方为中国开发者搭建了临时镜像，大家可以将如下环境变量加入到用户环境变量中：

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

在这里插入图片描述

注意：此镜像为临时镜像，并不能保证一直可用，读者可以参考https://flutter.io/community/china
以获得有关镜像服务器的最新动态。

检查Flutter环境

在Flutter命令行运行如下命令来查看是否还需要安装其它依赖，如果需要，安装它们。

flutter doctor

该命令检查你的环境并在命令行窗口中显示报告。Dart SDK已经在打包在Flutter SDK里了，没有必要单独安装Dart。仔细检查命令行输出以获取可能需要安装的其他软件或进一步需要执行的任务。

执行完成后,如下图所示
在这里插入图片描述

[√] Flutter (Channel stable, v1.12.13+hotfix.9, on Microsoft Windows [Version 10.0.17763.1158], locale zh-CN) (表示flutter环境安装完成)
[X] Android toolchain - develop for Android devices (表示Android SDK环境未配置)
    X Unable to locate Android SDK.
      Install Android Studio from: https://developer.android.com/studio/index.html
      On first launch it will assist you in installing the Android SDK components.
      (or visit https://flutter.dev/setup/#android-setup for detailed instructions).
      If the Android SDK has been installed to a custom location, set ANDROID_HOME to that location.
      You may also want to add it to your PATH environment variable.

[!] Android Studio (not installed) (Android Studio未安装)
[!] IntelliJ IDEA Ultimate Edition (version 2019.2) (IntelliJ IDEA 未安装Flutter和Dart插件)
    X Flutter plugin not installed; this adds Flutter specific functionality.
    X Dart plugin not installed; this adds Dart specific functionality.
[!] Connected device (未连接设备,ps:android模拟器或者android真机)
    ! No devices available

! Doctor found issues in 4 categories.

二、Android SDK配置

Android SDK获取

方法1 : 使用Android Studio

下载Android Studio

https://developer.android.google.cn/studio/#downloads
有zip和exe,随意下载
本次下载的是android-studio-ide-192.6392135-windows.zip版本
运行android-studio\bin下的studio64.exe
不导入配置
在这里插入图片描述

选择自己的JDK，没有的话，使用AndroidStudio默认的

选择主题（黑和白）

全部勾选上，前3个是Android SDK相关的，第4个是Android虚拟机硬件加速，第5个是Android虚拟机，
选择Android SDK安装目录

方法2: 自行下载Android SDK(不推荐)

目前官网上已经没有单独的SDK下载安装包
可以去https://www.androiddevtools.cn/这个网站下载,不过最新的SDK是android 5.0版本的。

Android SDK环境变量配置

增加ANDROID_HOME配置
在这里插入图片描述

把platform-tools和tools添加到Path环境变量中。
在这里插入图片描述
配置完成后,flutter doctor,发现 Android toolchain - develop for Android devices 这一项还是×号
需要重启电脑
在运行flutter doctor,变成下面的样子

运行flutter doctor --android-licenses
一直输入 y 就可以
最后, 再次运行flutter doctor,发现 Android toolchain终于OK了
在这里插入图片描述

三、开发工具配置Flutter插件

Windows上可以采用Android Studio、IntelliJ IDEA、VS Code等。
由于Android Studio是基于IntelliJ IDEA开发的，所以Android Studio和IntelliJ IDEA配置方法类似。

Android Studio

在这里插入图片描述
搜索Flutter，选择Install

同意

确认安装Dart

重启开发工具

执行flutter doctor命令
发现Android Studio (version 3.6)这一项已经打钩了

四、第一个Flutter项目

创建Flutter项目

在这里插入图片描述

完成后自动打开项目。

运行Flutter项目

点击运行项目按钮，发现提示未找到Android模拟器。
在这里插入图片描述

启动模拟器

由于我们在之前创建了模拟器, 如果未创建,参考下面的方法

方法1：

在这里插入图片描述

方法2：

在这里插入图片描述
运行成功后

创建模拟器

假如没有模拟器，就需要先创建模拟器，点击 Create Virtual Device
在这里插入图片描述

运行项目

点击运行按钮,运行项目
在这里插入图片描述
会发现一直卡在Running Gradle task ‘assembleDebug’…

解决方案Running Gradle task ‘assembleDebug’…

修改项目中android/build.gradle文件中 buildscript 和allprojects 中的

google()
jcenter()

改为阿里云镜像

maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/jcenter' }
maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }

在这里插入图片描述