Windows 搭建Flutter开发环境教程

Flutter 之 Windows 环境搭建教程(全网最全，亲测有效 2025 年 1月 6日更新, flutter 3.27.1 版本没问题)

此教程为：flutter 3.27.1 + gradle 8.10.2 + 插件8.7.3测试没问题

录制了视频：1月6日_哔哩哔哩_bilibili

Flutter SDK 安装

下载地址：

• 国内加速访问：https://flutter.cn/docs/development/tools/sdk/releases

• 官网镜像：https://flutter.dev/docs/development/tools/sdk/releases

解压:

将安装包 zip 解压到你想安装 Flutter SDK 的路径，最好不要放到 C 盘，如果不知道放在那个目录，可以跟着本教程放在 D:\java\flutter 目录下：

全局环境变量配置：

找到 此电脑 => 右键 选择 属性 => 点击 高级系统设置 => 会弹出系统属性的窗口，点击 环境变量 按钮 => 找到 path 变量，再双击，之后会弹框出来 => 点击 新建, 然后分别输入flutter解压安装的bin目录和dart-sdk的缓存目录，如不会找，则跟着本教程配置为：

D:\java\flutter\bin 和 D:\java\flutter\bin\cache\dart-sdk

加速镜像地址配置

flutter的包管理，类似于前端的npm，java的maven, 项目中加载包或打包到真机上运行的的时候，需要下载对应的包，由于国内加载国外的镜像很慢，所以需要在 全局环境变量额外中添加配置 加速镜像地址, 如下所示：

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

• 配置 PUB_HOSTED_URL 加速地址

• 配置 FLUTTER_STORAGE_BASE_UR 加速地址

 安装 Android Studio

Step 1

下载 Android Studio

下载地址：https://developer.android.google.cn/studio

如果无法打开上面链接，找老师要安装包

Step 2

下载完成后，双击安装包。Android Studio Setup 将显示在屏幕上，点击 Next

Step 3

需要安装 Android Studio 和 Android Virtual Device（安卓虚拟设备）, 默认设置，不做其他处理，继续点击 Next

Step 4

该步骤需要设置 Android Studio 的安装位置，默认是c盘，我们建议不安装在c 盘，本教程安装到 D:\java\Android\Android Studio 目录下，再点击 Next

Step 5

点击 Install

之后就进入安装页面了，需要等待几分钟，之后进入到安装完成界面，点击 Finish

，并启动 Android Studio！

Step 6

如下所示 安装flutter插件

安装 Android SDK

步骤如下两图所示

检测 flutter 运行环境

安装完Flutter SDK 和 Android studio以后，在命令行中，运行 flutter doctor ，可以检测 flutter 所需的环境条件是否都满足

flutter doctor

Android license status unknown.
这个在命令行中，直接给出了解决方案： 运行 flutter doctor --android-licenses

终于安装完成了！

 检查flutter 环境变量配置成功与否

打开 cmd 命令（window 图标 +R 键，弹出窗口，输入cmd 即可以打开命令窗口） => 输入 flutter --version

到此，Flutter sdk 安装配置成功了

项目中配置国内加速下载gradle版本（2025-1-6 更新）

修改项目中的android/gradle/wrapper/gradle-wrapper.properties文件，将 distributionUrl 配置为国内下载地址，如下所示

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
# 这里配置成腾讯的地址，gradle版本为8.10.2，2025年1月这里有且仅推荐使用8.10.x版本（这个版本也是官方推荐的版本），不要使用7.x的版本
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.9-all.zip

配置gradle加速下载依赖源（2025-1-6 更新 ）

flutter项目中，项目的依赖大概分成三种:

场景一： flutter sdk自带依赖

场景二： flutter 第三方插件（不带原生交互），如：dio  get 等插件

场景三： flutter 第三方插件（带原生交互） ，如 fluttertoast、connectivity_plus等插件

针对【场景一】和【场景二】这两种只需要配置如下，就可以加速下载依赖

先配置pub相关的环境变量，上面我们配置过了

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

修改项目中的android/build.gradle仓库地址，配置如下

allprojects {
    repositories {
        // 腾讯云镜像
        maven { url 'https://mirrors.cloud.tencent.com/maven/' }
        // 阿里云镜像
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        google() // Google 的 Maven 仓库
        mavenCentral() // Maven Central 仓库
    }
}

rootProject.buildDir = "../build"
subprojects {
    project.buildDir = "${rootProject.buildDir}/${project.name}"
}
subprojects {
    project.evaluationDependsOn(":app")
}

tasks.register("clean", Delete) {
    delete rootProject.buildDir
}

修改项目中的android/settings.gradle配置如下：

// 插件管理块，用于配置插件的仓库和解析策略
pluginManagement {
    def flutterSdkPath = {
        def properties = new Properties()
        file("local.properties").withInputStream { properties.load(it) }
        def flutterSdkPath = properties.getProperty("flutter.sdk")
        assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
        return flutterSdkPath
    }()

    includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

    // 配置插件仓库
    repositories {
        // 腾讯云镜像
        maven { url 'https://mirrors.cloud.tencent.com/maven/' }
        // 阿里云镜像
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        // 华为云镜像
        maven { url 'https://repo.huaweicloud.com/repository/maven' }
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

// 插件配置块，用于声明项目中使用的插件
plugins {
    // Flutter 插件加载器
    id "dev.flutter.flutter-plugin-loader" version "1.0.0"
    // 测试过了 8.7.3 + 2.1.0 + gradle 10.2是官方最新推荐搭配
    // 这里说明一下7.3.0 + 1.7.10 + gradle7.6.3 这个版本不推荐使用了，有些包下载巨慢
    // Android 应用插件，版本 8.7.3，不立即应用（apply false）
    id "com.android.application" version "8.7.3" apply false
    // Kotlin Android 插件，版本 2.1.0，不立即应用（apply false）
    id "org.jetbrains.kotlin.android" version "2.1.0" apply false
}

include ":app"

运行项目使用技巧：非常重要，非常重要，非常重要

新建项目或者新拉取的项目，可以先把项目中所依赖的包下载到本地缓存中，本地缓存的目录默认是：C:\Users\yzx\.gradle\caches，真机打包运行的时候直接从本地缓存中加载即可，那么怎么预先下载项目依赖呢？

先进入到当前项目的/android 目录下，运行如下两个命令:

其中： -x test 表示跳过测试，这个参数必须添加，因为很多插件都有测试案列，多多少少都有问题，比如 shared_preferences 插件测试案列就会存在问题，因此添加这个参数可以跳过测试

# 如果第一次执行下面命令，其中会下载 kotlin-compiler-embeddable:xxx 插件，这个插件会下载比较慢，慢慢等待或者多次执行下载，直到下载成功即可
.\gradlew clean  

 .\gradlew build -x test

均运行成功，则表示项目所需要的依赖都下载到本地了，以后再也不需要弄了（当然如果后面加上了新的插件，需要重新运行命令）

注意（非常重要）：

1. 如果运行错误，可以先删除本地缓存 C:\Users\yzx\.gradle\caches ，这样可以排除一些原因
2. 下面是常用、且容易出现问题的插件：

   connectivity_plus、permission_handler、fluttertoast、path_provider、fluttertoast、shared_preferences等等

3. 只有新增依赖，或者依赖版本升级，才运行：

    .\gradlew clean  

    .\gradlew build -x test 这个两个指令，否则直接运行即可

真机调试

真机调试推荐工具：下载地址：GitHub - barry-ran/QtScrcpy: Android real-time display control software 巨好用