跨平台开发 / 系统课时
安装 Flutter SDK 并验证环境
安装 Flutter SDK 并验证环境
本节解决 Flutter 开发的第一个实际问题:如何正确安装 Flutter SDK,并确认操作系统、工具链和依赖环境满足开发要求。完成后,你将能够使用 flutter doctor 快速定位环境缺失项。
学习目标
- 理解 Flutter SDK 的组成和安装后的验证方式
- 掌握使用 flutter doctor 检查开发环境的方法
- 能够根据检查结果处理常见环境问题
Flutter SDK 安装后的环境组成
Flutter SDK 不只是一个命令行工具,它包含 Dart SDK、Flutter 命令、开发脚手架和构建相关工具。安装完成后,开发者主要通过 flutter 命令创建项目、运行应用和检查环境。
在正式开发前,通常需要确认以下组件可用:
| 组件 | 作用 |
|---|---|
| Flutter SDK | 提供 Flutter 框架和命令工具 |
| Dart SDK | 支持 Dart 编译和运行 |
| Git | Flutter SDK 更新和版本管理依赖 |
| IDE 插件 | 提供代码补全、调试能力 |
使用 flutter doctor 检查环境
Flutter 提供 flutter doctor 命令检查当前机器状态。它会扫描 Flutter SDK、Android 工具链、编辑器以及连接设备,并给出缺失项提示。
bash
flutter doctor预期输出
text
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter
[✓] Android toolchain
[✓] Connected device
Some issues were found. See the summary above for details.实际输出会根据本机安装情况变化。绿色勾选表示对应环境已经满足要求,黄色或红色提示需要进一步处理。
根据检查结果处理问题
常见问题通常集中在以下几个方向:
| 提示类型 | 处理方式 |
|---|---|
| Flutter SDK 未找到 | 检查 PATH 环境变量是否包含 Flutter 目录 |
| Android toolchain 缺失 | 安装 Android SDK 并接受许可证 |
| 无可用设备 | 启动模拟器或连接真实设备 |
| IDE 未检测 | 安装对应 Flutter 插件 |
例如 Android 许可证未接受时,可以执行:
bash
flutter doctor --android-licenses预期结果
text
All SDK package licenses accepted.验证 Flutter 项目运行能力
环境检查通过后,可以创建一个最小项目验证完整链路。
bash
flutter create hello_flutter
cd hello_flutter
flutter run预期结果
text
Launching lib/main.dart on <DEVICE> in debug mode...
Running Gradle task 'assembleDebug'...
Flutter run key commands.其中 <DEVICE> 表示实际连接的设备名称,不同开发环境会有所不同。
安装验证通过后,后续 Flutter 学习中的 Widget 编写、调试和打包流程都建立在这个基础环境之上。遇到构建失败时,也应优先重新运行 flutter doctor 获取环境状态。
按自己的节奏,确认真正理解。