Flutter功能未定义插件stark的探索使用

什么是Stark?

Stark 是一个为Dart开发者设计的轻量级依赖注入框架。它不依赖于Dart的反射API（mirrors），而是采用了基于工厂的方法，这提高了性能和实现的简易性。

快速开始

添加依赖

在您的Flutter或Dart项目中添加依赖：

dependencies:
  ...
  stark: 4.0.0

使用示例

导入stark

import 'package:stark/stark.dart';

定义模块

final appModule = {
    single((i) => Api()), 
    single<Repository>((i) => MyRepository(i.get())),
    factory((i) => UseCase(i.get())), 
    factoryWithParams((i, p) => ViewModel(i.get(), p["dynamicParam"])),
};

初始化Stark

//可以传递多个模块列表
Stark.init([
  appModule,
  domainModule,
  presentationModule
]);

带有日志记录器初始化：

Stark.init([...], logger: Logger());

获取注入实例

class LoginScreen extends StatefulWidget{
  @override
  State<StatefulWidget> createState() => LoginScreenState();
}

class LoginScreenState extends State<LoginScreen>{
  final _loginViewModel = Stark.get<LoginViewModel>();

  @override
  Widget build(BuildContext context) {
    return Container(
      //...
    );
  }
}

单例定义

final myModule = {
    single((i) => Api(i.get())), 
};

带动态参数的单例：

final myModule = {
    singleWithParams((i,p) => Api(p["token"])), 
};

工厂定义

final myModule = {
    factory((i) => UseCase()), 
};

带动态参数的工厂：

final myModule = {
    factoryWithParams((i,p) => Api(p["token"])), 
};

命名注入

final myModule = {
    single((i) => Api(), named: "DEFAULT"), 
    single((i) => Api(), named: "EXTERNAL"), 
};

//获取命名注入
Stark.get<Api>(named: "DEFAULT");

动态参数

final myModule = {
    singleWithParams((i,p) => Api(p["token"])), 
    factoryWithParams((i,p) => MyPresenter(p["view"])), 
};

//获取带动态参数的实例
Stark.get<Api>(params: { "token" : "Bearer asdasdad"});
Stark.get<MyPresenter>(params: { "view" : this});

范围注入

你可以将类与Stark组件混合以关联注射生命周期到你的小部件：

class _MyHomePageState extends State<MyHomePage> with StarkComponent {
  ViewModel _viewModel;

  @override
  void initState() {
    super.initState();

    //视图模型实例将在该小部件状态调用dispose时被销毁。
    _viewModel = get<ViewModel>(
        params: <String, dynamic>{'name': 'Custom dynamic param'});
  }
  ...
}

可处理接口

当实现了可处理接口的注射被销毁时，会调用dispose方法，这对于ViewModel特别有用：

class LoginViewModel implements Disposable {
    @override
    dispose(){
      //当LoginViewModel被销毁时调用此方法，用于销毁RX主题或流。
    }
}

架构组件

为了支持不同的架构类型和状态管理，我们已将这些架构组件移动到新的库中：

• stark_mvp: Stark库，适用于MVP架构
• stark_bloc: Stark库，适用于flutter_bloc项目

示例代码

以下是一个完整的示例，演示了如何使用Stark进行依赖注入：

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

void main() => runApp(MyApp());

// API: 这里你可以使用Dio等库发起HTTP请求
class Api {
  Future<String> getText() async {
    await Future.delayed(const Duration(milliseconds: 500));
    return 'example Api async return';
  }
}

// Repository接口的实现
abstract class Repository {
  Future<String> getText();
}

// Repository的具体实现，注入了Api作为参数
class MyRepository implements Repository {
  MyRepository(this._api);
  final Api _api;

  @override
  Future<String> getText() async {
    final apiResult = await _api.getText();
    return apiResult;
  }
}

// Presenter的具体实现，注入了Repository作为参数
class Presenter  {
  Presenter(this._repository);

  final Repository _repository;

  Future<String> getText() async {
    final repositoryResult = await _repository.getText();
    return repositoryResult;
  }
}

class MyApp extends StatelessWidget {
  // 示例的Stark模块
  final module = {
    single((i) => Api()),
    single<Repository>((i) => MyRepository(i.get())),
    singleWithParams((i, p) => Presenter(i.get())),
  };

  @override
  Widget build(BuildContext context) {
    // 初始化Stark
    Stark.init([module], logger: Logger(level: Level.DEBUG));

    // 正常的Material App
    return MaterialApp(
      title: 'Stark Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Stark Example'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  State<StatefulWidget> createState() => _MyHomePageState();
}

class _MyHomePageState extends InjectableState<MyHomePage> {

  final presenter = Stark.get<Presenter>();
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: FutureBuilder<String>(
          // 直接调用presenter
          future: presenter.getText(),
          builder: (context, snapshot) {
            if (snapshot.hasData) {
              return Text(snapshot.data ?? '');
            }
            return const CircularProgressIndicator();
          },
        ),
      ),
    );
  }
}

通过上述内容和示例代码，您可以了解如何在Flutter应用中使用Stark进行依赖注入，并根据需要调整和扩展其功能。希望这对您有所帮助！