Flutter 开发环境配置

Flutter 开发环境配置总流程

1. 安装 Flutter SDK
   把 Flutter SDK 解压到固定目录，比如：
   D:\Softward\flutter
2. 安装 Android Studio
   它主要提供两样东西：

• Android SDK
• Android 模拟器

1. 安装 Android SDK
   SDK 可以放在类似目录：
   D:\Softward\AndroidSDK
2. 配置环境变量
   至少要配这几个：

ANDROID_HOME=D:\Softward\AndroidSDK
ANDROID_SDK_ROOT=D:\Softward\AndroidSDK
Path += D:\Softward\flutter\bin

如果国内网络慢，也可以加：

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

1. 安装 Windows 开发依赖
   如果要打包 Windows 桌面应用，还需要安装：

• Visual Studio 2022
• 勾选 Desktop development with C++

注意这里是 Visual Studio，不是 VS Code。

1. 检查环境
   打开终端运行：

flutter doctor
flutter doctor -v

目标是把主要项都检查通过：

• Flutter
• Android toolchain
• Chrome 或其他可选项
• Visual Studio
• Android Studio

1. 接受 Android licenses
   如果 doctor 提示协议没通过，就运行：

flutter doctor --android-licenses

然后一路确认。

1. 创建项目
   进入工作目录后执行：

flutter create .

或者新建指定目录：

flutter create FlutterDemo

1. 启动模拟器或连接真机
   有两种方式：

• Android Studio 的 Device Manager 启动模拟器
• USB 连接安卓手机并打开开发者选项和 USB 调试

1. 查看设备
   确认 Flutter 能识别设备：

flutter devices

1. 首次运行项目
   在项目根目录执行：

flutter run

或者指定设备：

flutter run -d emulator-5554

1. 日常开发
   最常用命令：

• flutter run 运行
• r 热重载
• R 热重启
• q 退出运行
• flutter analyze 检查代码
• flutter test 跑测试

VS Code 配置流程

1. 安装 VS Code
2. 安装两个扩展

• Flutter
• Dart

1. 用 VS Code 打开 Flutter 项目根目录
2. 等右下角识别 Flutter SDK 和设备
3. 选择运行设备
4. 按 F5 或点运行按钮启动

补充一点：
Run and Debug 里看到 Dart & Flutter 就够了，大多数 Flutter 项目不需要你手写 .vscode/launch.json。

Android 打包

开发调试时直接：

flutter run

生成安装包常用这几个：

flutter build apk --debug
flutter build apk --release
flutter build appbundle --release

输出位置通常是：

• APK：
  D:\codex\FlutterDemo\build\app\outputs\flutter-apk\
• AAB：
  D:\codex\FlutterDemo\build\app\outputs\bundle\release\

如果是公司项目上架应用商店，通常更常见的是 appbundle。

Windows 打包

如果环境完整，可以执行：

flutter build windows

输出一般在：

D:\codex\FlutterDemo\build\windows\x64\runner\Release\

这个目录里通常会有：

• 主程序 .exe
• flutter_windows.dll
• data 目录
• 插件相关 dll

这次实践里踩过的坑

1. ADB 异常
   表现：

• 模拟器在线，但 Flutter 连不上
• 提示 adb daemon 启动失败

常见原因：

• adb 进程卡死
• Android Studio 和 VS Code 同时抢设备
• 真机未授权

处理思路：

• 重启 adb
• 重新插拔真机
• 确认手机已点"允许 USB 调试"
• 尽量不要多个工具同时占用同一设备

1. 模拟器卡死
   表现：

• 页面点不动
• 停在最近任务页
• Device Manager 某些按钮不可点

处理思路：

• 先关闭当前模拟器
• 再重新启动
• 如果菜单里的 Cold Boot 是灰的，通常说明模拟器还没真正停掉

1. Gradle 下载慢或失败
   表现：

• 首次 Android 构建卡住
• Gradle wrapper 下载超时

处理思路：

• 确认网络
• 必要时手动下载 Gradle 对应压缩包
• 放到 .gradle\wrapper\dists\... 对应目录