跨平台开发 / 系统课时
创建并运行第一个项目
创建并运行第一个项目
本篇解决 Flutter 初学者从空环境到运行第一个应用的问题,通过 Flutter CLI 创建工程、启动设备并验证默认应用运行结果,建立完整开发闭环。
学习目标
- 掌握 Flutter CLI 创建项目的基本流程
- 学会选择模拟器或真机运行 Flutter 应用
- 理解首次运行时构建、安装和启动过程
创建 Flutter 项目
Flutter CLI 提供统一的项目创建入口。创建项目时,CLI 会生成 Dart 代码、平台工程以及构建配置文件。
bash
flutter create hello_flutter
cd hello_flutter预期结果
text
Flutter 项目目录 hello_flutter 创建完成,并进入项目根目录。生成后的项目包含 lib、android、ios 等目录,其中 lib/main.dart 是 Flutter 应用默认入口。
检查可运行设备
运行应用前,需要确认 Flutter 可以发现目标设备。
bash
flutter devices预期输出
text
<device-name> • <device-id> • ios • iOS <version>如果使用 Android 模拟器或 iOS 模拟器,需要先启动对应模拟器;如果使用真机,需要确保设备已经连接并完成信任授权。
启动默认应用
在项目根目录执行运行命令:
bash
flutter run预期结果
text
Launching lib/main.dart on <device-name> in debug mode...
Running Gradle/Xcode build...
Flutter run key commands displayed.Flutter 会先编译平台工程,再将应用安装到目标设备。首次运行通常较慢,因为需要生成缓存和构建依赖。
修改入口代码验证热重载
默认入口文件是 lib/main.dart。修改界面文本后,可以使用热重载快速查看效果。
dart
import 'package:flutter/material.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(title: const Text('Flutter Demo')),
body: const Center(
child: Text('Hello Flutter'),
),
),
);
}
}预期结果
text
设备屏幕显示 Flutter Demo 标题栏,并显示 Hello Flutter 文本。修改代码后,在运行终端按 r 可以触发热重载,Flutter 会保留当前应用状态并刷新界面。
首次运行失败时的定位顺序
遇到启动失败时,不要直接修改业务代码,可以按照以下顺序检查:
- 使用
flutter doctor -v确认开发环境完整 - 使用
flutter devices确认设备可见 - 检查 iOS 真机是否完成签名和信任设置
- 查看终端中的具体构建错误信息
完成一次创建、运行和修改验证后,Flutter 开发环境就具备了继续学习 Widget、状态管理和页面构建的基础。
按自己的节奏,确认真正理解。