Flutter 框架设定

1. 官方demo解析

// Material Design 组件库,包含 runApp、Widget、MaterialApp、Scaffold、Text、ElevatedButton 等绝大多数 UI 组件
import 'package:flutter/material.dart';

// 入口函数
void main() {
  // runApp()来自material 库,初始化渲染树并驱动界面,需要传入一个实例
  runApp(const MyApp());
}

// 定义一个名为 MyApp 的类,它继承自 StatelessWidget
// StatelessWidget 是 Flutter 的无状态组件基类,来自material 库
// "无状态"指这个组件本身不持有会变化的状态,界面完全由构造时传入的参数决定,build 返回什么就显示什么,不会因为内部数据变化而重建
class MyApp extends StatelessWidget {
  const MyApp({super.key});
  // @override 是 Dart 的注解,来自 dart:core(语言内置)。它告诉编译器"这个方法覆盖了父类同名方法",拼写错误时能报错,属于安全检查,不影响运行
  @override
  // Widget:所有 UI 组件的基类,来自 material 库
  // build 是 StatelessWidget 要求子类实现的抽象方法,Flutter 在需要绘制这个组件时调用它
  // BuildContext context:构建上下文,代表这个组件在组件树中的位置
  Widget build(BuildContext context) {
    // MaterialApp 是 Flutter 提供的 Material 风格应用外壳,来自 material 库,它帮你统一配置导航(路由)、主题、本地化、标题栏等,内部会构建 Navigator、Theme 等基础设施
    return MaterialApp(
      // 应用标题
      title: 'Flutter Demo',
      // 设置应用主题
      // ThemeData:Material 主题配置类,来自 material 库
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
      ),
      // 主页
      home: const MyHomePage(title: 'Flutter Demo Home Page2'),
    );
  }
}

// 定义 MyHomePage 类,继承 StatefulWidget 
// StatefulWidget 是 Flutter 的有状态组件基类,来自 material 库,会关联一个可变的 State 对象来保存会变化的数据
class MyHomePage extends StatefulWidget {
  // 接收参数 title,并赋值给后面的 title
  const MyHomePage({super.key, required this.title});
  // StatefulWidget 上定义的任何公开字段(不以 _ 开头),都能在关联的 State 里通过 widget.字段名 读取
  final String title;

  // 重写 createState,返回 MyHomePage 对应的状态对象 _MyHomePageState
  @override
  // createState 是 StatefulWidget 的抽象方法,Flutter 创建该组件时调用它来获得 State 实例
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  // 定义计数变量
  int _counter = 0;
  // 定义方法
  void _incrementCounter() {
    // setState(...) 是 State 类提供的方法,它的作用是:触发 build 重新执行、界面刷新
    setState(() {
      _counter++;
    });
  }

// 重写 build,描述界面长什么样
  @override
  Widget build(BuildContext context) {
    // Scaffold 来自 material库,提供 Material 页面的标准结构槽位:appBar(顶栏)、body(主体)、floatingActionButton(悬浮按钮)、drawer(抽屉)等
    return Scaffold(
      // 顶部导航
      appBar: AppBar(
        // 导航背景色
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        // 导航标题,读取其StatefulWidget里面定义的字段
        title: Text(widget.title),
      ),
      // 主体
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text('You have pushed the button this many times:'),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      // 右下角悬浮按钮
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}

posted @ 2026-11-18 15:35  ---空白---  阅读(3)  评论(0)    收藏  举报