По каким критериям выбираешь пакеты для проектов?

Критерии выбора пакетов для проектов

Отличный вопрос о дисциплинированности в разработке. У меня есть четкая система оценки пакетов.

Мои критерии выбора пакета

Критерий 1: Популярность на pub.dev

Оценка ★★★★★ (10k+ лайков)  → Зелёный свет
Оценка ★★★★☆  (1k+ лайков)  → Хороший кандидат
Оценка ★★★☆☆  (100-1k)      → Нужно проверить
Оценка ★★☆☆☆  (10-100)      → Осторожно
Оценка ★☆☆☆☆  (<10)        → Избегать (high risk)

Почему это важно:

• Много лайков = много разработчиков использует
• Если есть проблемы, их найдут и исправят
• Issues решаются быстрее
• Сообщество готово помочь

Критерий 2: Активность поддержки

Условие 1: Был коммит в последний месяц
Условие 2: Issues закрываются регулярно
Условие 3: Pull requests обрабатываются
Условие 4: Документация актуальна

Проверяю:

// Пример хорошего пакета: provider
// GitHub: https://github.com/rrousselGit/provider
// - Последний коммит: 2 дня назад ✅
// - Issues за последний месяц: 20, закрыто: 18 ✅
// - Pull requests: обрабатывается быстро ✅
// - Pub.dev score: 130/130 ✅✅✅

// Плохой пример: abandoned_package
// - Последний коммит: 2 года назад ❌
// - Issues: 100+, открыты все ❌
// - Pub.dev score: 50/130 ❌

Критерий 3: Стабильность версии

Версия 1.x, 2.x+  → Стабильный API
Версия 0.x        → Может сломаться в любой момент

Правило versioning:

dependencies:
  provider: ^6.0.0      # Безопасно: любая 6.x.x
  # Минор версия (1.2.3) может быть другой
  # Патч версия обновляется без проблем
  
  experimental_lib: ^0.5.0  # Рискованно: может быть 0.6.0
  # Лучше: experimental_lib: 0.5.2

Критерий 4: Размер пакета

# Проверяю размер APK
flutter pub deps --style=compact

# Плохо:
Provider: +2 MB ❌
Advanced DI: +5 MB ❌

# Хорошо:
Provider: +2 MB ✅
Hive: +1.5 MB ✅
Dio: +1 MB ✅

Правило: Размер пакета должен быть пропорционален функционалу.

Критерий 5: Зависимости пакета

# Хорошо: минимальные зависимости
provider:
  dependencies: []
  # Ничего не требует, легкий пакет

# Хорошо: зависит от популярных
riverpod:
  dependencies: [freezed]
  # freezed популярен, стабилен

# Плохо: много неизвестных зависимостей
buggy_package:
  dependencies: [unknown_lib_1, unknown_lib_2, ...]
  # Если сломается одна зависимость, сломается всё

Критерий 6: Документация и примеры

Есть ли:
- README с примерами ✅
- API документация ✅
- Примеры кода на GitHub ✅
- Гайды для начинающих ✅
- Ответы на Stack Overflow ✅

Тест: Смогу ли я выучить этот пакет за час без видео?

Критерий 7: Null safety

// Проверяю в pub.dev:
// "Null safety: ✅ Enable" — гарантирует современность
// "Null safety: ❌ Disable" — старый пакет, рискованный

// В pubspec.yaml:
environment:
  sdk: ">=2.18.0 <4.0.0"  // Поддерживает null safety ✅
  sdk: ">=2.12.0 <3.0.0"  // Может быть старый

Критерий 8: Альтернативы

Для HTTP запросов:
- http (официальный) ✅
- dio (популярный) ✅
- chopper (генерирует код) ✅

Для state management:
- Provider ✅
- Riverpod ✅
- Bloc ✅
- GetX (спорный)

Есть 3+ хороших альтернативы? Выбираю лучшую.
Есть 1 альтернатива? Берю её.
Нет альтернатив? Осторожнее с выбором.

Мой процесс выбора (пошагово)

Шаг 1: Определить потребность

// Нам нужно: парсить JSON с validation
// Критерии:
// - Поддержка freezed (code gen)
// - Validation встроена
// - Хорошая производительность

Шаг 2: Поиск на pub.dev

Search: "json serialization validation"
Видим:
- json_serializable (4.8k лайков) ✅
- buildr (500 лайков) ✅
- manual_parsing (50 лайков) ❌

Шаг 3: Проверка критериев

1. json_serializable:
   - Лайки: 4.8k ✅
   - Обновления: вчера ✅
   - Версия: 6.x ✅
   - Размер: +0.5 MB ✅
   - Документация: отличная ✅
   - Альтернативы: есть 2+ ✅
   
   ИТОГ: ✅✅✅ Выбираем!

Шаг 4: Проверка совместимости

// Проверяю в pubspec.lock:
version: 6.7.0
dependencies:
  analyzer: ^5.12.0  // У нас есть
  build: ^2.4.0      // У нас есть

Шаг 5: Пробный интеграция

// Писню простой пример
import 'package:json_serializable/json_serializable.dart';

part 'user.g.dart';

@JsonSerializable()
class User {
  final String name;
  final int age;
  
  User({required this.name, required this.age});
  
  factory User.fromJson(Map<String, dynamic> json) =>
    _$UserFromJson(json);
  Map<String, dynamic> toJson() => _$UserToJson(this);
}

// Генерирую: flutter pub run build_runner build
// Тестирую: всё работает?

Примеры моих выборов

State Management: Riverpod

// ПОЧЕМУ:
✅ 5k+ лайков на pub.dev
✅ Активная разработка (commits каждый день)
✅ Версия 2.4 (стабильна)
✅ Отличная документация
✅ Работает с freezed (code gen)
✅ Есть альтернативы (Provider, Bloc)
✅ Производительность оптимальная
✅ Google использует в примерах

// РИСКИ:
❌ Может быть сложнее для новичков

HTTP Client: Dio

// ПОЧЕМУ:
✅ 6k+ лайков
✅ Множество фич (interceptors, cancel)
✅ Отличная обработка ошибок
✅ Поддержка WebSocket
✅ Много примеров
✅ Большое сообщество

// КОГДА НЕ ИСПОЛЬЗУЮ:
// Для простых GET запросов: http пакет (меньше)
// Для специфичных случаев: chopper (генерирует)

Local Storage: Hive

// ПОЧЕМУ:
✅ 4k+ лайков
✅ Очень быстрый (native speed)
✅ Встроенный код generation
✅ Простой API
✅ Хорошая производительность

// КОГДА РАССМАТРИВАЮ АЛЬТЕРНАТИВЫ:
// Для простых пар key-value: SharedPreferences
// Для SQL запросов: isar, sqflite
// Для сложных данных: sqlite

Красные флаги (когда избегаю пакета)

🚩 Версия 0.x и последний обновление > 1 года назад
🚩 Лайки: < 100 и специфичная функция
🚩 Issues: много открытых баг-репортов
🚩 Documentation: неполная, устаревшая
🚩 Dependencies: множество неизвестных пакетов
🚩 Breaking changes в каждой версии
🚩 Один разработчик и нет активности
🚩 Нет тестов в проекте пакета
🚩 Не поддерживает null safety
🚩 Конфликтует с другими популярными пакетами

Моя система оценки (0-100)

| Критерий | Вес | Оценка |
|----------|-----|--------|
| Популярность | 20% | ⭐ |
| Поддержка | 25% | ⭐ |
| Стабильность версии | 20% | ⭐ |
| Документация | 15% | ⭐ |
| Размер | 10% | ⭐ |
| Зависимости | 10% | ⭐ |

ИТОГО: > 80 → Зелёный свет
       60-80 → Рассмотреть альтернативы
       < 60 → Избегать

Золотое правило

Не выбирайте пакет только потому, что он "классный" или вы его видели на YouTube.

Используйте эту систему критериев, и вы избежите большинства проблем. Помните:

// Лучше использовать скучный, проверенный пакет
import 'package:http/http.dart' as http;  // 20 лет, 100% надежный

// Чем красивый, но непроверенный
import 'package:super_cool_http/super_cool_http.dart'; // 0 лайков