1.前言
2.Git
- Flutter 依赖 Git 拉取资源,必须先装
- 装完后确保配置好环境变量
- 验证:打开终端输入 git --version,显示版本号即成功
3.Android Studio
- 下载 Android Studio:国内镜像地址:[https://www.android-studio.org/](Android Studio) 中文社区(避免官网下载慢)
- 安装 Android Studio
- 首次启动配置
- 打开 Android Studio,选择 "Do not import settings"
- 进入 "Welcome" 界面后,点击 "SDK Manager"(图标像个下载箭头)
- 在 "SDK Platforms" 中:
- 勾选 "Android 13 (Tiramisu)"(API 33,兼容性最好)
- 勾选底部 "Show Package Details",确保选中 "Android SDK Platform 33"
- 在 "SDK Tools" 中:
- 勾选 "Android SDK Build-Tools 33.0.2"
- 勾选 "Android SDK Command-line Tools (latest)"
- 点击 "Apply" 安装,等待完成(约 500MB,国内网络需 5-10 分钟)
4.Flutter SDK
- 版本选择:优先 稳定版,例如:3.16.0,https://storage.flutter-io.cn/flutter_infra_release/releases/stable/windows/flutter_windows_3.16.0-stable.zip
- 解压路径:放到无中文 / 空格的目录(如 C:\flutter\)
- 配置环境变量:右键 “此电脑”→“属性”→“环境变量”→ 系统变量Path→ 新增 C:\flutter\bin(替换为你的实际路径)
- 配置镜像依赖:推荐通过镜像下载,外网访问慢,可能失败
新增系统变量:
变量名:PUB_HOSTED_URL,值:https://mirrors.aliyun.com/dart-pub/
变量名:FLUTTER_STORAGE_BASE_URL,值:https://mirrors.aliyun.com/flutter/
flutter --version
flutter doctor
5.运行项目
flutter create my_demo
- 配置依赖的镜像:打开项目中的 android/build.gradle
buildscript {ext.kotlin_version = '1.9.0'repositories {// 国内镜像优先maven { url 'https://maven.aliyun.com/repository/google' }maven { url 'https://maven.aliyun.com/repository/jcenter' }maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }// 官方仓库放后面google()mavenCentral()}dependencies {classpath 'com.android.tools.build:gradle:7.4.2'classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"}
}allprojects {repositories {// 国内镜像优先maven { url 'https://maven.aliyun.com/repository/google' }maven { url 'https://maven.aliyun.com/repository/jcenter' }maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }maven { url 'https://storage.flutter-io.cn/download.flutter.io' } // Flutter国内仓库// 官方仓库放后面google()mavenCentral()}
}task clean(type: Delete) {delete rootProject.buildDir
}
flutter pub get
flutter run
5.常见问题:
- Java和Gradle版本兼容问题:
- 查看Gradle版本:android\gradle\wrapper\gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip