跨平台开发 / 系统课时

安装 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 获取环境状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Flutter SDK 并验证环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通