Быстрый старт
На этой странице — минимум, который нужен, чтобы связать приложение с помощью CherryPick.
Предполагается, что пакет cherrypick уже установлен.
1. Опишите модуль
Заголовок раздела «1. Опишите модуль»Модуль объединяет биндинги,
которые говорят 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!"); }}2. Откройте скоуп и установите модуль
Заголовок раздела «2. Откройте скоуп и установите модуль»Корневой скоуп — вершина дерева зависимостей. Установите в него модули один раз при запуске:
final rootScope = CherryPick.openRootScope();rootScope.installModules([AppModule()]);3. Получите зависимости
Заголовок раздела «3. Получите зависимости»Запросите тип у скоупа. Для асинхронных биндингов используйте resolveAsync, а tryResolve —
когда отсутствие биндинга это нормальная ситуация, а не ошибка. Подробнее —
в API разрешения зависимостей.
final greeting = rootScope.resolve<String>();print(greeting); // выведет: Hello, CherryPick!4. Закройте скоуп
Заголовок раздела «4. Закройте скоуп»Когда приложение (или тест) завершается, закройте скоуп. Это освободит все
Disposable, которыми он владеет. Всегда используйте
await — даже если сейчас освобождать нечего:
await CherryPick.closeRootScope();Использование во Flutter
Заголовок раздела «Использование во Flutter»Добавьте 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') открывает
подскоуп для фичи или экрана.
Что дальше
Заголовок раздела «Что дальше»- Аннотации — генерация модулей и внедрения полей вместо ручного кода.
- Иерархические подскоупы — изоляция фич и экранов.
- Пример приложения — полноценное приложение на CherryPick.
- Линтинг — ловите типичные ошибки прямо в IDE.