Flutter高效模块集成插件fast_module的使用

Flutter高效模块集成插件fast_module的使用

特性

• flutter组件化容器

入门指南

• fast_module_manager 负责注册模块、注册路由、模块之间通讯。
• fast_module_protocol 需要模块来实现, 提供路由以及接受消息。

使用方法

1. 主函数配置

// 1. 首先注册模块
FastModuleManager.registerBuilder((manager) {
    manager.register(ModuleA());
});

// 2. 动态路由 任选一种
GetMaterialApp(onGenerateRoute: FastModuleManager.instance().onGenerateRoute(settings));

//  2. 静态路由 任选一种
GetMaterialApp(getPages: FastModuleManager.instance().pages());

2. 子模块配置

假设你的文件结构如下：

lib
  src
     业务代码
  ykq_ble_modules.dart
  main.dart 

在 ykq_ble_modules.dart 文件中实现以下代码：

class ModuleA extends FastModuleProtocol {

  // 提供子模块路由
  [@override](/user/override)
  GetPageRoute? onGenerateRoute(RouteSettings settings) {
    switch (settings.name) {
      case 'module/A':
         return GetPageRoute(settings: settings, page: () => A(), bindings: ABingdings());
      default:
        return null;
    }
  }

   // 接收其他模块发送的消息 
  [@override](/user/override)
  onReceivedMessage({String evnetName = '', arguments}) {
    if (evnetName == 'msg') {
      // 处理消息逻辑
    }
  }

   // 子模块的初始化任务
  [@override](/user/override)
  void init() {
   TXSDK.init();
   JPPush.init();
   // 其他初始化任务
  }
  
  // ... app生命周期监听 等等
}

3. 模块间通信

final 返回值 = FastModuleManager.instance().dispatch(模块名, 事件名, 参数);

完整示例Demo

example/lib/main.dart

import 'package:example/app/moduleA/detail/bindings/detail_binding.dart';
import 'package:example/app/moduleA/detail/views/detail_view.dart';
import 'package:example/main_moudle.dart';
import 'package:fast_module/fast.dart';
import 'package:fast_module/fast_module_protocol.dart';
import 'package:flutter/material.dart';
import 'package:get/get.dart';

void main() {
  // 注册模块
  FastModuleManager.registerBuilder((manager) {
    manager.register(MainMoudle());
    manager.register(ModuleA());
    manager.register(ModuleB());
    manager.register(ModuleC());
  });

  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    // 主项目路由配置
    return GetMaterialApp(
      title: 'Flutter Demo',
      getPages: FastModuleManager.instance().pages(),
      home: Text('省略...'),
    );
  }
}

/*
主项目: 依赖的子模块

主项目: pubspec.yaml 文件结构

dependencies:
  flutter:
    sdk: flutter

  ModuleA:
    path: ../ModuleA
  ModuleB: ^1.0.0
  ModuleC: 
    git: 
      url: 'git.com'
      ref: 1.0.0

模块A, 目录结构: 
 lib
   src
      业务代码
   ykq_ble_modules.dart
   main.dart 
*/

// ModuleA 实现
class ModuleA extends FastModuleProtocol {
  // 提供子模块路由
  [@override](/user/override)
  GetPageRoute? onGenerateRoute(RouteSettings settings) {
    switch (settings.name) {
      case 'module/A':
         return GetPageRoute(settings: settings, page: () => A(), bindings: ABingdings());
      default:
        return null;
    }
  }

  // 接收其他模块发送的消息
  [@override](/user/override)
  onReceivedMessage(String eventName, arguments) {
    return super.onReceivedMessage(eventName, arguments);
  }

  // 子模块的初始化任务
  [@override](/user/override)
  void init() {
    // 初始化任务
    // TXSDK.init();
    // JPPush.init();
  }
}

// 跟A 一样
class ModuleB extends FastModuleProtocol {}

// 跟A 一样
class ModuleC extends FastModuleProtocol {}