Fancy Flutter

Fancy 是一个轻量级的状态管理包，用于简化 Flutter 中的控制器管理和依赖注入。受 GetX 等框架的启发，Fancy 提供了一种简洁的方式来管理状态、依赖关系和 UI 更新，而无需过多的样板代码。

功能

• 高效的状态管理：使用 FancyBaseController 来管理你的应用状态，内置支持初始化、清理和监听器管理。
• 依赖注入：通过 Fancy 轻松注册和检索依赖项，实现简单的依赖管理和服务定位。
• 自定义小部件：利用 FancyBuilder 创建响应式 UI 组件，当状态变化时自动重建。
• 继承小部件集成：使用 FancyMaterialApp 提供一致的上下文，以便在整个应用中进行依赖注入。

开始使用

安装

在你的 pubspec.yaml 文件中添加以下内容：

dependencies:
  fancy_flutter: 0.0.1 # 或最新版本

使用

步骤

1. 定义控制器：通过扩展 FancyBaseController 创建控制器，并实现你的业务逻辑。
2. 注册依赖项：使用 Fancy.register 注册服务和控制器。
3. 构建小部件：使用 FancyBuilder 创建响应式 UI 组件，当状态变化时自动重建。

示例

以下是使用 Fancy Flutter 的完整示例代码：

import 'package:flutter/material.dart';
import 'package:fancy_flutter/fancy.dart';

// 示例服务
class AuthService {
  // AuthService 实现
}

// 示例控制器
class AuthController extends FancyBaseController {
  final AuthService _authService = Fancy.get<AuthService>();

  String _username = '';
  String _password = '';

  String get username => _username;
  String get password => _password;

  void updateUsername(String username) {
    _username = username;
    fancyUpdate(); // 触发状态更新
  }

  void updatePassword(String password) {
    _password = password;
    fancyUpdate(); // 触发状态更新
  }

  void login() {
    // 处理登录逻辑
  }

  [@override](/user/override)
  void onInit() {
    super.onInit();
    // 初始化认证状态
  }

  [@override](/user/override)
  void onStart() {
    super.onStart();
    // 启动逻辑
  }

  [@override](/user/override)
  void onDispose() {
    super.onDispose();
    // 清理逻辑
  }
}

import 'package:example/injector.dart';
import 'package:fancy_flutter/fancy_flutter.dart';
import 'package:flutter/material.dart';
import 'auth_controller.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  final injector = AppDependenciesEnjector();
  injector.registerDependencies();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return FancyStateInjector(
      injector: FancyDependencyInjector(),
      child: const MaterialApp(
        home: LoginPage(),
      ),
    );
  }
}

class LoginPage extends StatelessWidget {
  const LoginPage({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: FancyBuilder<AuthController>(
          builder: (controller) {
            return Column(
              mainAxisSize: MainAxisSize.min,
              children: [
                TextField(
                  onChanged: controller.updateUsername,
                ),
                TextField(
                  onChanged: controller.updatePassword,
                ),
                ElevatedButton(
                  onPressed: controller.login,
                  child: const Text('Login'),
                ),
                // 添加一个 Text 小部件以观察状态变化
                Text('Username: ${controller.username}'),
                Text('Password: ${controller.password}'),
              ],
            );
          },
        ),
      ),
    );
  }
}