vmf (Version Manager Flavors) #

Herramienta CLI profesional para automatizar la gestión de flavors y versionado en proyectos Flutter.

✨ Características #

• Inicialización interactiva de flavors con configuración automática (vmf init)
• Modificación inteligente de build.gradle(.kts) con detección de sintaxis Kotlin DSL/Groovy
• Generación automática de keystores con keytool para cada flavor (Android)
• Configuración automática de signingConfigs, buildTypes, flavorDimensions y productFlavors (Android)
• Eliminación de duplicados y limpieza automática de bloques previos
• Build optimizado para flavors con flags de producción (vmf build <flavor>)
• Versionado semántico automatizado (vmf version [patch|minor|major])
• Compatibilidad multiplataforma (Windows, macOS, Linux)

⚠️ Nota importante: Actualmente vmf solo configura automáticamente Android. Para iOS, web y desktop, solo maneja el versionado y build básico de Flutter.

📦 Instalación #

Instalación local en proyecto: #

# pubspec.yaml
dev_dependencies:
  vmf:
    path: ./vmf

Instalación global: #

dart pub global activate --source path ./vmf

🚀 Uso #

Inicialización de flavors #

# Ejecutar en la raíz de tu proyecto Flutter
vmf init

¿Qué hace vmf init?

1. Solicita cantidad de flavors, nombres y datos de configuración
2. Pide applicationId, nombre de app y credenciales de keystore para cada flavor
3. Genera automáticamente los keystores con keytool si no existen
4. Detecta y limpia bloques previos en build.gradle(.kts) para evitar duplicados
5. Modifica inteligentemente build.gradle(.kts) agregando:
   • signingConfigs con las credenciales de cada flavor
   • buildTypes (debug/release) con signingConfig apropiado
   • flavorDimensions configurado correctamente
   • productFlavors con applicationId y resValue para app_name
6. Actualiza AndroidManifest.xml para usar @string/app_name
7. Elimina carpetas inválidas de recursos creadas en ejecuciones previas
8. Guarda configuración en vmf_config.json para referencia

Build de flavors #

# Build para un flavor específico
vmf build dev
vmf build prod

¿Qué hace vmf build?

• Lee la versión actual de pubspec.yaml
• Ejecuta build optimizado de Flutter con flags de producción:
  • --flavor <flavor> (flavor especificado)
  • --release (modo release)
  • --obfuscate (ofusca el código)
  • --no-tree-shake-icons (mantiene todos los íconos)
  • --split-debug-info=./build/debug (separa info de debug)
  • --build-name y --build-number desde pubspec.yaml
• Muestra resultado y errores del build

Gestión de versiones #

# Incrementar patch (por defecto): 1.0.0+1 → 1.0.1+2
vmf version

# Incrementar minor: 1.0.1+2 → 1.1.0+3
vmf version minor

# Incrementar major: 1.1.0+3 → 2.0.0+4
vmf version major

¿Qué hace vmf version?

• Si existe version: en pubspec.yaml, la incrementa según el tipo y suma 1 al build number
• Si no existe, la crea con valor inicial version: 1.0.0+1
• Mantiene formato semántico: major.minor.patch+build

🔧 Tecnologías y compatibilidad #

• Dart CLI con dependencias mínimas
• Configuración automática de Android: Kotlin DSL (build.gradle.kts) y Groovy DSL (build.gradle)
• Generación automática de keystores usando keytool del sistema
• Multiplataforma: Windows (PowerShell), macOS, Linux
• Detección inteligente de sintaxis y estructura de archivos

Soporte por plataforma: #

• ✅ Android: Configuración completa (flavors, keystores, signing, manifests)
• ⚠️ iOS: Solo versionado y build básico (sin configuración de schemes/targets)
• ⚠️ Web: Solo versionado y build básico (sin configuración específica)
• ⚠️ Desktop (Windows/macOS/Linux): Solo versionado y build básico

📁 Estructura generada #

Después de ejecutar vmf init, tu proyecto tendrá:

android/app/
├── build.gradle(.kts)          # Actualizado con flavors y signingConfigs
├── dev_keystore.jks            # Keystore generado para flavor dev
├── prod_keystore.jks           # Keystore generado para flavor prod
└── src/main/
    └── AndroidManifest.xml     # Actualizado para usar @string/app_name

vmf_config.json                 # Configuración de flavors guardada

🎯 Objetivo #

Proporcionar una herramienta profesional y automatizada para la gestión completa de flavors y versionado en Android Flutter, eliminando la configuración manual propensa a errores y optimizando el flujo de desarrollo.

Enfoque actual: Configuración completa de Android con planes futuros para iOS, web y desktop.

🚀 Roadmap futuro #

Próximas características planeadas: #

• 📱 iOS: Configuración automática de schemes, targets y Info.plist
• 🌐 Web: Configuración de diferentes entornos y builds
• 🖥️ Desktop: Configuración específica para Windows, macOS y Linux
• 🔄 Configuración unificada: Single source of truth para todos los flavors multiplataforma

🤝 Contribuciones #

Este proyecto está diseñado para ser publicado en pub.flutter-io.cn como herramienta estándar de la comunidad Flutter.