tiny_frame 是一个用于 Flutter 的微型框架插件，旨在帮助开发者更轻松地处理和管理 Flutter 应用中的状态和路由。它提供了一种简单的方式来组织代码、管理状态和处理导航，使得开发小型到中型应用变得更加高效。

安装

首先，你需要在 pubspec.yaml 文件中添加 tiny_frame 依赖：

dependencies:
  flutter:
    sdk: flutter
  tiny_frame: ^0.1.0 # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

基本用法

tiny_frame 提供了几个核心概念，包括 Frame、Page 和 StateManager。下面是一个简单的示例，展示如何使用 tiny_frame 来管理状态和路由。

1. 创建 Frame

Frame 是 tiny_frame 的核心类，用于管理应用的状态和路由。你可以在应用的入口处创建一个 Frame 实例：

import 'package:flutter/material.dart';
import 'package:tiny_frame/tiny_frame.dart';

void main() {
  final frame = Frame(
    initialPage: HomePage(),
    stateManager: AppStateManager(),
  );

  runApp(MyApp(frame: frame));
}

class MyApp extends StatelessWidget {
  final Frame frame;

  MyApp({required this.frame});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'TinyFrame Demo',
      home: frame.builder(),
    );
  }
}

2. 创建 Page

Page 是 tiny_frame 中的一个概念，用于表示应用中的一个页面。你可以通过继承 Page 类来创建自定义页面：

class HomePage extends Page {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Home'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 导航到另一个页面
            Frame.of(context).push(AnotherPage());
          },
          child: Text('Go to Another Page'),
        ),
      ),
    );
  }
}

class AnotherPage extends Page {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Another Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 返回到上一个页面
            Frame.of(context).pop();
          },
          child: Text('Go Back'),
        ),
      ),
    );
  }
}

3. 管理状态

tiny_frame 提供了 StateManager 来管理应用的状态。你可以通过继承 StateManager 类来创建自定义的状态管理类：

class AppStateManager extends StateManager {
  int _counter = 0;

  int get counter => _counter;

  void incrementCounter() {
    _counter++;
    notifyListeners();
  }
}

在页面中，你可以通过 Frame.of(context).stateManager 来访问状态管理器，并根据需要更新状态：

class HomePage extends Page {
  [@override](/user/override)
  Widget build(BuildContext context) {
    final stateManager = Frame.of(context).stateManager as AppStateManager;

    return Scaffold(
      appBar: AppBar(
        title: Text('Home'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Counter: ${stateManager.counter}'),
            ElevatedButton(
              onPressed: () {
                stateManager.incrementCounter();
              },
              child: Text('Increment Counter'),
            ),
            ElevatedButton(
              onPressed: () {
                Frame.of(context).push(AnotherPage());
              },
              child: Text('Go to Another Page'),
            ),
          ],
        ),
      ),
    );
  }
}