Что такое PDD?

PDD (Package Dependency Declaration)

PDD — это подход к организации зависимостей в проектах, который помогает избежать циклических зависимостей и упростить архитектуру приложения.

Основная концепция

PDD предполагает явное описание всех зависимостей между пакетами/модулями на высшем уровне. Это позволяет:

• Предотвратить циклические зависимости — инструмент проверяет граф зависимостей и выявляет проблемы на этапе сборки
• Упростить анализ архитектуры — легко понять, какие модули зависят друг от друга
• Улучшить тестируемость — четкие границы между модулями упрощают написание юнит-тестов
• Облегчить рефакторинг — видно, какие модули нужно обновить при изменениях

Применение в Flutter

В контексте Flutter разработки PDD используется для:

1. Организации пакетов — разделение приложения на отдельные пакеты с четкими зависимостями
2. Управления pubspec.yaml — явное описание зависимостей и их версий
3. Слоистой архитектуры — разделение на слои (presentation, business logic, data, domain)

Пример архитектуры

applib (main app)
├── features/
│   ├── user_profile/
│   ├── authentication/
│   └── home/
├── shared/ (общие компоненты)
├── data/ (repository, API)
├── domain/ (entities, use cases)
└── presentation/ (UI)

Правила зависимостей

• Presentation → Domain → Data
• Features не должны зависеть друг от друга напрямую
• Shared может быть использовано всеми слоями
• Data может содержать interface'ы из Domain

Инструменты проверки

Для проверки циклических зависимостей в Flutter используют:

• dart_code_metrics — анализирует зависимости
• pub — встроенная система управления пакетами
• custom scripts — проверка архитектуры проекта

Применение PDD значительно улучшает качество кода и упростает его поддержку в долгосрочной перспективе.