Flavor Tools #

CLI-утилита для быстрого создания и управления flavors в Flutter-проектах. Автоматически настраивает iOS (Xcode project, xcconfig, schemes) и Android (Gradle, AndroidManifest).

Возможности #

• Создание flavor для iOS и Android одной командой
• Пакетное создание из YAML-конфига (create-all)
• Обновление существующих flavors (update)
• Настройка target device family для iOS
• Поддержка Kotlin DSL (build.gradle.kts) и Groovy (build.gradle)
• Автоопределение настроек из существующего Xcode-проекта (SWIFT_VERSION, IPHONEOS_DEPLOYMENT_TARGET и др.)
• Проверка дубликатов перед созданием
• Поддержка flutter_launcher_icons

Установка #

dependencies:
  flavor_tools: ^1.0.6

или

dart pub add flavor_tools

Глобальная установка (опционально) #

dart compile exe bin/flavor_tools.dart -o flavor_tools
mv flavor_tools /usr/local/bin/

Команды #

create — создание одного flavor #

dart run flavor_tools create \
  -p com.example.app \
  -f dev \
  -d "My App Dev"

create-all — пакетное создание из YAML #

dart run flavor_tools create-all -c flavor_tools.yaml

Формат flavor_tools.yaml:

flavors:
  dev:
    package_name: com.example.app.dev
    display_name: "My App Dev"
  staging:
    package_name: com.example.app.staging
    display_name: "My App Staging"
  prod:
    package_name: com.example.app
    display_name: "My App"
    team_id: "ABC123"
    icons_launcher: true

Каждый flavor поддерживает поля:

При повторном запуске create-all автоматически определяет изменения и обновляет только те flavors, у которых поменялся конфиг.

update — обновление существующего flavor #

dart run flavor_tools update \
  -f dev \
  -p com.example.newpackage \
  -d "New Display Name"

set-target-device-family — целевые устройства iOS #

dart run flavor_tools set-target-device-family -d "1,2"

• 1 — iPhone
• 2 — iPad
• 1,2 — iPhone и iPad

Запуск flavor #

flutter run --flavor=dev

Что генерируется #

iOS:

• XCBuildConfiguration для Debug, Release, Profile
• xcconfig-файлы (ios/Flutter/Debug-{flavor}.xcconfig, Release-{flavor}.xcconfig)
• Xcode scheme (ios/Runner.xcodeproj/xcshareddata/xcschemes/{flavor}.xcscheme)
• Обновление Info.plist и Runner.entitlements

Android:

• flavorDimensions и productFlavors в build.gradle / build.gradle.kts
• resValue для app_name в каждом flavor
• Обновление AndroidManifest.xml