Перейти к содержимому

Быстрый старт

На этой странице — минимум, который нужен, чтобы связать приложение с помощью CherryPick. Предполагается, что пакет cherrypick уже установлен.

Модуль объединяет биндинги, которые говорят CherryPick, как создавать каждую зависимость. Переопределите builder и вызовите bind<T>() для каждого типа, который нужно предоставить:

import 'package:cherrypick/cherrypick.dart';
class AppModule extends Module {
@override
void builder(Scope currentScope) {
// Готовый экземпляр.
bind<ApiClient>().toInstance(ApiClientMock());
// Фабрика, вызывается при каждом resolve.
bind<String>().toProvide(() => "Hello, CherryPick!");
}
}

Корневой скоуп — вершина дерева зависимостей. Установите в него модули один раз при запуске:

final rootScope = CherryPick.openRootScope();
rootScope.installModules([AppModule()]);

Запросите тип у скоупа. Для асинхронных биндингов используйте resolveAsync, а tryResolve — когда отсутствие биндинга это нормальная ситуация, а не ошибка. Подробнее — в API разрешения зависимостей.

final greeting = rootScope.resolve<String>();
print(greeting); // выведет: Hello, CherryPick!

Когда приложение (или тест) завершается, закройте скоуп. Это освободит все Disposable, которыми он владеет. Всегда используйте await — даже если сейчас освобождать нечего:

await CherryPick.closeRootScope();

Добавьте cherrypick_flutter и оберните приложение в CherryPickProvider. Виджеты ниже получают доступ к скоупам через CherryPickProvider.of(context):

import 'package:cherrypick/cherrypick.dart';
import 'package:cherrypick_flutter/cherrypick_flutter.dart';
import 'package:flutter/material.dart';
void main() {
CherryPick.openRootScope().installModules([AppModule()]);
runApp(const CherryPickProvider(child: MyApp()));
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
final scope = CherryPickProvider.of(context).openRootScope();
return MaterialApp(home: Text(scope.resolve<String>()));
}
}

CherryPickProvider.of(context).openSubScope(scopeName: 'feature') открывает подскоуп для фичи или экрана.