Flutter功能未知插件simply的介绍（由于介绍为undefined，基于名称推测） Flutter简化操作或功能插件simply的使用

Flutter功能未知插件simply的介绍

Simply 是一个旨在帮助开发者更快更轻松地创建生产级 Flutter 应用程序的插件。它处理诸如依赖注入和状态管理等话题，使开发者能够专注于构建美观的用户界面（这是 Flutter 的主要目的）。

动机

在普通的 Flutter 应用程序中，可能会有类似以下的代码：

void main(){
  runApp(MyApp());
}

class MyApp extends StatelessWidget{
  [@override](/user/override)
  Widget build(BuildContext context) {
    // 所有的代码都放在这里！
  }
}

然而，这会导致大量逻辑集中在 MyApp 类中，特别是随着代码的增长，例如：

• 执行异步操作，如初始化数据库、向远程 API 记录某些内容或初始化 Firebase。
• 当用户更改语言或主题时，重新构建整个应用程序。

最终，这将导致 MyApp 类内部混乱，因为它同时处理了 UI 逻辑和初始化逻辑。Simply 帮助你更好地组织应用程序。

开始使用

要开始使用 Simply，只需使用 SimpleMaterialApp 类，它只是一个帮助你组织应用程序的 StatelessWidget。

最简单的示例

以下是最简单的可工作的应用程序：

import 'package:simply/simply.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends SimpleMaterialApp {
  [@override](/user/override)
  Future<void> initialize() async {}

  [@override](/user/override)
  MaterialApp buildApp(String payload, GlobalKey<NavigatorState> navigatorKey) => MaterialApp(body: SomePage());

  [@override](/user/override)
  Widget splashPage() => SimpleSplashPage();

  [@override](/user/override)
  Widget startupErrorPage(String errorMessage) => SimpleStartupErrorPage(errorMessage);
}

主要方法

这里有四个主要的方法需要重写：

1. initialize (可选): 这个方法处理两个主要功能：

   • 注入所有 UI/视图所需的依赖项。
   • 执行在应用程序启动时需要调用的所有耗时的功能，如准备数据库或连接到远程 API。

2. buildApp: 这与普通 StatelessWidget 中的正常 build 方法相对应，主要区别在于每次应用程序重新加载时都会被调用，而不是只调用一次。

3. splashPage: 这是一个用户可以看到的屏幕，当你的耗时功能正在运行时。如果你不想实现自定义启动页面或没有耗时的功能，可以使用 SimpleSplashPage。

4. startupErrorPage: 如果发生任何初始化错误，用户会看到这个页面。如果你不想实现自定义页面，可以始终使用 SimpleStartupErrorPage。

依赖注入

Simply 允许在应用程序启动时注入依赖项，并且可以在任何其他位置轻松访问它们。

假设我们有一个依赖于从某些存储中获取数据的特定存储库，我们称之为 IMenuItemsRepository，我们只需要让它扩展 SimpleService 类，以便能够注入并区分服务和其他类型。

abstract class IMenuItemsRepository extends SimpleService {
  Future<List<String>> getMenuItemNames();
}

然后，在应用程序级别注入该依赖项的具体实现。例如，你有一个名为 LocalMenuItemsRepository 的类：

class MyApp extends SimpleMaterialApp {
  [@override](/user/override)
  Future<void> initialize() async {
    Simply.register<IMenuItemsRepository>(
      service: LocalMenuItemsRepository(),
    );
  }
  // ...
}

然后，你可以使用 Simply 在 UI 中获取依赖项（它会被传递给整个树）：

[@override](/user/override)
Widget build(BuildContext context) {
  var menuItemsRepo = Simply.get<IMenuItemsRepository>(context);
  // 使用依赖项...
}

这种方式保持了 UI 逻辑的清晰和解耦。

重新加载应用程序

你可能希望因为全局事件（如更改语言或主题）而重新加载应用程序。你可以从代码中的任何地方轻松做到这一点：

Simply.reload("Theme changed");

这将导致整个应用程序重新构建，并且 buildApp 方法将被调用，参数 payload 携带你发送的消息，并且还会传递之前注册的服务提供者。

class MyApp extends SimpleMaterialApp {
  [@override](/user/override)
  MaterialApp buildApp(String payload) {
    IThemeService themeService = Simply.get<IThemeService>();
    return CustomMaterialApp(
      widget: const HomePage(),
      theme: themeService.currentTheme,
    );
  } 
}

导航

Simply 提供类似于原生导航的方法，以确保在导航过程中正确传递所有依赖项。唯一的区别是它直接接受小部件，而不是接受 MaterialPageRoute。

Simply.navPush(view: TargetPage());
Simply.navReplace(view: TargetPage());
Simply.navPop();
Simply.navigator;

高级话题

注入生命周期

Simply 支持两种类型的依赖注入技术：

• scoped（默认）：每次调用时创建新实例。
• singleton：仅注入一次并且永远不变。

默认情况下，注入将是 scoped，这意味着每次从服务提供者请求注入的服务时都会创建一个新的实例。如果你想切换到 singleton 注入方法以永久注入特定的服务实例，可以使用以下代码：

class MyApp extends SimpleMaterialApp {
  [@override](/user/override)
  Future<void> initialize() async {
    registry.register<IMenuItemsRepository>(
      service: LocalMenuItemsRepository(),
      method: InjectionMethod.singleton,
    );
  }
  // ...
}

完整示例 DEMO

以下是完整的示例 DEMO：

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

void main() {
  Simply.register<MenuItemsRepo>(service: MenuItemsRepo());
  runApp(
    const MaterialApp(
      home: TestWidget(),
    ),
  );
}

// Home Page
class TestWidget extends StatelessWidget {
  const TestWidget({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("Simple Restaurant")),
      body: Center(
        child: FutureBuilder<List<String>>(
          future: Simply.get<MenuItemsRepo>().getMenuItemNames(),
          builder: (context, snapshot) {
            if (!snapshot.hasData) {
              return const CircularProgressIndicator();
            }
            return ListView.builder(
              itemBuilder: (context, index) => ListTile(
                title: Text(snapshot.data![index]),
              ),
              itemCount: snapshot.data!.length,
            );
          },
        ),
      ),
    );
  }
}

// Dependencies
class MenuItemsRepo {
  Future<List<String>> getMenuItemNames() async {
    return ["Burger", "Pizza", "Juice"];
  }
}