跨平台开发 / 系统课时

创建并运行第一个项目

创建并运行第一个项目

本篇解决 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、状态管理和页面构建的基础。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建并运行第一个项目

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

登录哪都通