跳到正文
教程首页
FlutterCH 02ch02_first_app

ch02-first-app

第一个 Flutter App:main、runApp、Widget、热重载。完整工程共 100 个文件,其中 60 个文本源文件可在下面在线阅读。

60

在线文本文件

3,337

源码行数

dart / c / yaml

语言

275 KB

打包体积

在线阅读源码

左侧按目录浏览,点击文件切换。右上角可复制代码、复制路径或单独下载文件。在线视图只覆盖文本源码,完整工程请下载 zip。

textxmldartjsonkotlin

60 text files · 3,337 lines

dartlib/main.dart
// 第 2 章 · 第一个 Flutter App。
//
// 整个程序的入口只有两行:定义 App 这个 Widget,然后把它交给 runApp。
// 对照 C/Go:没有手写窗口创建、没有消息循环、没有渲染线程——框架全包了。
import 'package:flutter/material.dart';

import 'src/home_page.dart';

void main() {
  // runApp 是 Flutter 唯一的"启动函数":
  //   1. 建立引擎与渲染管线;2. 把 widget 树挂到根上;3. 永不返回(事件循环接手)。
  runApp(const DartBookApp());
}

/// App 根 Widget。
///
/// 继承 StatelessWidget 的类必须实现 build(),且 build() 必须是**纯函数**:
/// 只依赖入参(这里无入参)与继承来的 context,不产生副作用。
/// 框架会在任何时候(热重载、父级重建、主题变化)反复调用它。
class DartBookApp extends StatelessWidget {
  const DartBookApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '第一个 Flutter App',
      // 桌面端调试时右上角的 DEBUG 横幅很碍事,教程里统一关掉。
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        useMaterial3: true,
        colorScheme: ColorScheme.fromSeed(seedColor: const Color(0xFF00695C)),
      ),
      // home 是路由栈的根页面;路由系统在 ch09 展开。
      home: const HomePage(),
    );
  }
}

代码构成:text 60 KB · xml 41 KB · dart 9 KB · json 4 KB

本地运行

zip → 解压 → 执行
$cd examples/ch02-first-app && flutter run -d macos(Linux → -d linux,Windows → -d windows,Android → 设备 id)

这个 zip 里有什么

  • • 完整工程目录(含 Android / iOS / 桌面平台脚手架)
  • • lib / bin / test / native 全部源码与测试
  • • pubspec.yaml、锁文件与平台配置文件
  • • 已排除 .dart_tool / build / target / ephemeral 等构建产物

已验证

  • flutter analyze(0 告警)、flutter test(4 个用例全绿)、flutter build macos --debug(真实构建并启动成功)
查看全部示例