Flutter通用功能插件general_lib_flutter的使用

Flutter通用功能插件general_lib_flutter的使用

1. 简介

general_lib_flutter 是由Global Corporation开发的一个Flutter插件，旨在提供一系列通用的功能和工具，帮助开发者更高效地构建跨平台应用。该插件包含了路由管理、状态管理、网络请求等功能，简化了开发流程。

2. 安装

在使用 general_lib_flutter 之前，首先需要将其添加到项目的 pubspec.yaml 文件中：

dependencies:
  flutter:
    sdk: flutter
  general_lib_flutter: ^1.0.0  # 请根据实际情况选择合适的版本

然后运行以下命令来安装依赖：

flutter pub get

3. 示例代码

下面是一个完整的示例demo，展示了如何使用 general_lib_flutter 插件来创建一个简单的Flutter应用。该示例包括路由管理、页面导航等功能。

/* 
 * 本软件/程序/源代码由Global Corporation的开发者创建
 * 社交媒体：
 *   - Youtube: https://youtube.com/[@Global_Corporation](/user/Global_Corporation) 
 *   - Github: https://github.com/globalcorporation
 *   - TELEGRAM: https://t.me/GLOBAL_CORP_ORG_BOT
 * 
 * 所有代码脚本均100%原创，未复制/窃取其他代码。如果引用了其他代码，会在代码顶部注明来源。
 * 
 * 如果您想编辑代码，请务必保留原作者的署名（不要修改）。
 */

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

void main(List<String> args) {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(MyApp());
}

/// 主应用程序类
class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return route.toMaterialApp();
  }

  /// 路由管理器
  final RouteGeneralLibFlutter route = RouteGeneralLibFlutter(
    onNotFoundRoute: (context, routeData) {
      return const HomePage();  // 当找不到路由时返回主页
    },
    onErrorRoute: (context, routeData) {
      return const HomePage();  // 当路由发生错误时返回主页
    },
  );
}

/// 主页
class HomePage extends StatefulWidget {
  const HomePage({super.key});

  [@override](/user/override)
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  double value = 0;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("主页"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const Text("进度条:"),
            LinearProgressIndicator(
              value: value,
              minHeight: 10,
              borderRadius: BorderRadius.circular(10),
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          // 导航到签到页面
          context.navigator().pushNamed("/sign", arguments: "测试参数");

          // 模拟进度条增加
          handleFunction(
            onFunction: (context, statefulWidget) async {
              if (value >= 1) {
                value = 0;
              }
              setState(() {});
              while (true) {
                await Future.delayed(const Duration(milliseconds: 10));
                value += 0.001;
                setState(() {});
                if (value >= 1) {
                  break;
                }
              }
            },
          );
        },
        child: const Icon(Icons.navigate_next),
      ),
    );
  }
}

/// 签到页面
class SignPage extends StatelessWidget {
  const SignPage({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    // 获取传递的参数
    final String? args = ModalRoute.of(context)?.settings.arguments as String?;

    return Scaffold(
      appBar: AppBar(
        title: const Text("签到页面"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const Text("欢迎来到签到页面"),
            Text("接收到的参数: $args"),
          ],
        ),
      ),
    );
  }
}