Flutter功能扩展插件freefeos的使用

Flutter功能扩展插件freefeos的使用

FreeFEOS 是一个 Flutter 插件, 也是一个简单的 Flutter 库操作系统和高级 Flutter 开发框架, 它能够为应用提供诸多高级功能.

📢重要通知

因开发者学业原因, 自2024年9月起至2025年春季高考结束(2025年5月12日)期间项目进入维护状态, 仅提供重大错误修复, 预计更新频率最多每月一次, 敬请谅解, 谢谢!

🍀这是什么?

FreeFEOS 是一个 Flutter 插件, 也是一个简单的 Flutter 库操作系统和高级 Flutter 开发框架, 它能够为应用提供诸多高级功能.

截图

📚快速开始

1. 搭建开发环境:

   • Flutter: 安装指南
   • Rust: 安装指南
   • LLVM: 安装指南

2. 创建新的Flutter项目

   • 可以使用命令行、VSCode 或 IntelliJ IDEA 等工具创建 Flutter 项目。

3. 添加依赖

   • 在 pubspec.yaml 中添加依赖:

     dependencies:
       freefeos: ^最新版本号
     

   • 更新依赖:

     flutter pub get
     

4. 编写代码

5. 添加标签

   • 最后记得在 README.md 中添加标签（非必需）。

     

📔更新日志

有关详细信息，请参阅 CHANGELOG 文件.

👍参与开发

如果您还不了解 Flutter, 请查看以下资源：

• Flutter 插件包 开发指南
• Flutter 官方文档 在线文档

致谢

• FreeRTOS: FreeFEOS 项目命名的灵感来源.
• 一个木函: Base64 编码/解码.

许可

该项目采用 BSD-3-Clause 许可证。有关详细信息，请参阅 LICENSE 文件.

示例代码

import 'dart:async';

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

/// 入口函数
Future<void> main() async {
  // 使用运行器启动应用
  await FreeFEOSLauncher(
    plugins: <FreeFEOSPlugin>[ExamplePlugin()],
    initApi: (exec) async => Global.exec = exec,
  )(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: Global.appName,
      theme: ThemeData(
        useMaterial3: true,
        colorScheme: ColorScheme.fromSeed(
          seedColor: Colors.blue,
          brightness: MediaQuery.platformBrightnessOf(
            context,
          ),
        ),
      ),
      initialRoute: '/',
      routes: {
        '/': (context) => const HomePage(),
        '/details': (context) => const DetailsPage(),
      },
    );
  }
}

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

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

class _HomePageState extends State<HomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Home'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'You have pushed the button this many times:',
            ),
            ValueListenableBuilder(
              valueListenable: Global.counter,
              builder: (context, value, child) {
                return Text(
                  value.toString(),
                  style: Theme.of(context).textTheme.headlineMedium,
                );
              },
            ),
            FilledButton(
              onPressed: () => Navigator.of(
                context,
                rootNavigator: false, // 不要使用根导航
              ).pushNamed('/details'),
              child: const Text('DetailsPage'),
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () async {
          await Global.exec(
            Global.channel,
            Global.add,
          );
        },
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}

class DetailsPage extends StatefulWidget {
  const DetailsPage({super.key});

  [@override](/user/override)
  State<DetailsPage> createState() => _DetailsPageState();
}

class _DetailsPageState extends State<DetailsPage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Details'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const Text('DetailsPage'),
            FilledButton(
              onPressed: () => Navigator.of(
                context,
                rootNavigator: false, // 不要使用根导航
              ).pop(),
              child: const Text('Back'),
            ),
          ],
        ),
      ),
    );
  }
}

/// Global全局类
class Global {
  const Global();

  static FreeFEOSExec exec = (
    String channel,
    String method, [
    dynamic arguments,
  ]) async {
    final example = ExamplePlugin();
    if (channel == example.pluginChannel) {
      try {
        example.invoke(method, arguments);
      } on Exception {
        rethrow;
      }
    }
    return await null;
  };

  /// 应用名称
  static const String appName = 'FreeFEOS 示例应用';
  static const String appDescription = '演示如何使用freefeos';
  static const String developerName = 'wyq0918dev';
  static final Uri officialWebsite = Uri.parse('');
  static final Uri feedbackWebsite = Uri.parse('');

  /// 计数
  static final ValueNotifier<int> counter = ValueNotifier(0);

  /// 计数器
  static const String add = 'add';
  static const String channel = 'example_channel';
}

final class ExamplePlugin implements FreeFEOSPlugin {
  ExamplePlugin();

  /// "ExampleAuthor"为作者信息, 替换为你自己的名字即可, 通过[pluginAuthor]方法定义.
  [@override](/user/override)
  String get pluginAuthor => 'ExampleAuthor';

  /// "example_channel"为插件的通道, 可以理解为插件的唯一标识, 我们通常使用全小写英文字母加下划线的命名方式, 通过[pluginChannel]方法定义.
  [@override](/user/override)
  String get pluginChannel => Global.channel;

  /// "Example description"为插件的描述, 通过[pluginDescription]方法定义.
  [@override](/user/override)
  String get pluginDescription => 'Example description';

  /// "Example Plugin"为插件的名称, 通过[pluginName]方法定义.
  [@override](/user/override)
  String get pluginName => 'ExamplePlugin';

  /// 插件的用户界面
  [@override](/user/override)
  Widget pluginWidget(BuildContext context) {
    return const Center(
      child: Text('Hello, World!'),
    );
  }

  /// [onMethodCall]方法为插件的方法调用.
  [@override](/user/override)
  Future<dynamic> onMethodCall(
    String method, [
    dynamic arguments,
  ]) async {
    switch (method) {
      case Global.add:
        Global.counter.value++;
        return Global.counter.value;
      default:
        return await null;
    }
  }

  Future<dynamic> invoke(
    String method, [
    dynamic arguments,
  ]) async {
    return await onMethodCall(
      method,
      arguments,
    );
  }
}