Обзор
CherryPick — лёгкий модульный инструмент внедрения зависимостей для Dart и Flutter. Вы описываете, как создавать сервисы, в модулях, устанавливаете модули в скоуп и получаете зависимости из этого скоупа — синхронно или асинхронно, по типу или по имени. Скоупы образуют дерево, поэтому у фич и экранов могут быть свои изолированные зависимости, которые освобождаются предсказуемо.
CherryPick работает и в чистом Dart (CLI, сервер), и во Flutter-приложениях. Связывание можно
писать вручную или поручить его cherrypick_generator на основе аннотаций.
Ключевые возможности
Заголовок раздела «Ключевые возможности»Скоупы и композиция
- Корневой скоуп и именованные подскоупы любой вложенности — см. Иерархические подскоупы
- Модульная композиция: связанные биндинги собираются в модули
Биндинги и разрешение
- Синхронные и асинхронные провайдеры
- Провайдеры с параметрами времени выполнения
- Именованные экземпляры для нескольких реализаций одного типа
- Жизненный цикл синглтонов
- Null-safe разрешение через
tryResolve/tryResolveAsync
Надёжность и инструменты
- Автоматическое освобождение всех зарегистрированных
Disposable - Обнаружение циклических зависимостей в одном скоупе или между скоупами
- Логирование состояния и событий DI через наблюдателей
- Аннотации и кодогенерация вместо шаблонного кода
- Lint-плагин для IDE (
cherrypick_lint), который ловит неверное использование API во время набора кода
| Пакет | Назначение |
|---|---|
cherrypick |
Ядро DI: скоупы, модули, биндинги |
cherrypick_flutter |
CherryPickProvider для дерева виджетов |
cherrypick_annotations + cherrypick_generator |
Кодогенерация на основе аннотаций |
talker_cherrypick_logger |
Логирование событий DI через Talker |
cherrypick_lint |
Плагин анализатора для IDE и dart analyze |
Подробности и ссылки — в разделе Пакеты и ресурсы.
Что дальше
Заголовок раздела «Что дальше»- Установите пакеты.
- Пройдите Быстрый старт: первый модуль и скоуп.
- Когда освоитесь, переходите к основным концепциям.