DevOps e rilasci

Ambienti, flavor e rilasci Flutter: setup enterprise

Guida pratica agli ambienti, flavor e strategie di rilascio in Flutter enterprise: dev, staging e production, dart-define, branching e CI/CD.

Fabrizio Billeci
Fabrizio Billeci
15 febbraio 2026 · 6 min di lettura
Ambienti, flavor e rilasci Flutter: setup enterprise

Introduzione

In ambito enterprise, un'app Flutter deve coesistere con più ambienti (dev, staging, production), eventuali varianti (flavor per clienti diversi o white-label) e un processo di rilascio strutturato. Gestire tutto in modo professionale richiede configurazioni chiare, convenzioni e automazione.

Questo articolo copre gli ambienti, i flavor, il versioning, le strategie di branching e l'integrazione con CI/CD per progetti Flutter di livello enterprise.

Ambienti vs flavor: differenze

Prima di tutto, chiariamo la distinzione:

  • Ambienti (Environments): configurano dove punta l'app — quale API, database, servizi esterni. Es: development, staging, production. Stesso codice, variabili diverse (URL, chiavi API, feature flag).
  • Flavor: varianti strutturali dell'app — app name, icona, applicationId/bundleId, possibilmente feature diverse. Es: free vs paid, white-label per clienti diversi. In Flutter i flavor sono i product flavors di Android e gli scheme di iOS.

In pratica spesso si combinano: un flavor staging può puntare all'ambiente staging, un flavor production a production. Oppure flavor per clienti (clientA, clientB) ciascuno con propri ambienti.

Ambienti in Flutter

Run modes (Debug / Profile / Release)

Flutter offre tre modalità di esecuzione: debug (interpretato, hot reload, debugging), profile (ottimizzato per profiling), release (ottimizzato per produzione). Non vanno confuse con gli ambienti: sono modalità di compilazione.

dart-define e dart-define-from-file

Per iniettare variabili d'ambiente a compile-time:

flutter run --dart-define=API_URL=https://api.dev.example.com
flutter build apk --dart-define=ENV=production --dart-define=API_URL=https://api.example.com

In Dart si leggono con const String.fromEnvironment('API_URL'). Con molte variabili, il comando diventa lungo; si usa --dart-define-from-file con un file JSON:

// env.production.json
{
  "API_URL": "https://api.example.com",
  "ENV": "production"
}

// build
flutter build apk --dart-define-from-file=env.production.json

Attenzione ai segreti: i file di env con API key non vanno committati. Usare .gitignore e popolare i valori in CI da secret store. Per massima sicurezza, le chiavi sensibili andrebbero gestite lato server, non nel client.

Flavor: configurazione Android e iOS

Android (product flavors)

In android/app/build.gradle.kts si definiscono flavor dimensions e product flavors:

android {
  flavorDimensions += "env"
  productFlavors {
    create("staging") {
      dimension = "env"
      applicationIdSuffix = ".staging"
      versionNameSuffix = "-staging"
    }
    create("production") {
      dimension = "env"
    }
  }
}

Ogni flavor ha un applicationId diverso: si possono installare staging e production sullo stesso dispositivo. Per variabili Dart per flavor, si passano --dart-define in fase di build.

iOS (schemes e configurations)

iOS non ha flavor nativi. Si usano schemes (es. MyApp-Staging, MyApp-Production) e configurations (Debug, Release). Ogni scheme può avere un bundleId diverso, variabili di build (Info.plist) e configurazioni Xcode. Lo setup manuale richiede più passi; tool come flutter_flavorizr aiutano ad automatizzare.

flutter_flavorizr

Package che genera la configurazione di flavor per Android e iOS da un file flavorizr.yaml. Utile per progetti nuovi o per standardizzare setup multi-flavor. Richiede Ruby e Xcodeproj per iOS.

Entry point e bootstrap per ambiente

Per avere entry point diversi (es. main_dev.dart, main_staging.dart, main_prod.dart) si possono usare target Flutter:

flutter run -t lib/main_staging.dart --flavor staging
flutter build apk -t lib/main_production.dart --flavor production

Oppure un unico main.dart che legge String.fromEnvironment('ENV') e carica la configurazione corretta. L'approccio con file separati è più esplicito; quello con env var è più snello.

Strategie di branching enterprise

GitFlow

Modello classico per release pianificate e più versioni in produzione. Prevede: main (production-ready), develop (integrazione), branch feature/*, release/* (stabilizzazione), hotfix/* (fix urgenti). Ideale per team grandi, cicli di rilascio lunghi, necessità di supportare versioni multiple.

GitHub Flow / Trunk-Based

Più semplice: un branch main sempre deployabile, feature branch corti che si mergiano via PR. Adatto a team che rilasciano spesso, con CI/CD aggressivo. Trunk-Based spinge ulteriormente: integrazione continua su un solo branch, feature flag per nascondere work in progress.

Convenzioni suggerite

  • Branch: TICKET-123-descrizione o feature/nome, fix/nome.
  • Non push diretto su main: sempre via PR con review e CI verde.
  • main sempre buildabile e testato.
  • Tag per release: v1.2.3 (semver).

Versioning e build number

Flutter usa version in pubspec.yaml: 1.2.3+45 dove 1.2.3 è il version name (visibile agli utenti) e 45 il build number (versionCode su Android, CFBundleVersion su iOS). Gli store richiedono build number sempre crescenti.

In CI si può: usare Fastlane con increment_build_number; oppure script che impostano --build-name e --build-number al momento del build (flutter build appbundle --build-name=1.0.0 --build-number=123). Il build number può derivare da commit count, pipeline ID o da un file/secret gestito in CI.

CI/CD e pipeline

Per ambienti enterprise, la pipeline dovrebbe:

  • Eseguire test (unit, widget, integration) su ogni PR.
  • Build per ogni flavor/ambiente richiesto (es. staging su merge in develop, production su merge/tag in main).
  • Usare secret per API key e config; non committare file sensibili.
  • Generare artifact (APK, AAB, IPA) e pubblicarli su store (manual approval per production) o su Firebase App Distribution / TestFlight per staging.
  • Opzionale: creare tag e release notes automatiche.

Strumenti comuni: GitHub Actions, GitLab CI, Codemagic, Bitrise, Fastlane. Fastlane integra bene con Flutter per build, signing e upload verso store.

Checklist per setup enterprise

  • Ambienti distinti (dev, staging, prod) con URL e config separati.
  • Flavor configurati su Android e iOS (applicationId/bundleId per ambiente o per cliente).
  • dart-define o dart-define-from-file per variabili; file sensibili in .gitignore.
  • Branching strategy documentata; protezione di main, PR obbligatori.
  • Versioning semantico; build number auto-incrementato in CI.
  • Pipeline CI/CD con test, build per flavor, deploy su staging/prod.
  • Convenzioni di naming e documentazione per il team.

Conclusione

Un setup professionale di ambienti, flavor e rilasci in Flutter richiede chiarezza tra ambienti (dove punta l'app) e flavor (quale variante si costruisce), uso corretto di dart-define, configurazione Android/iOS e una strategia di branching e CI/CD coerente. Investire tempo in questa struttura all'inizio del progetto riduce errori, deploy errati e confusione in team e in produzione.

Accanto ai rilasci, vale la pena curare la sicurezza di token, storage e rete. Se stai impostando un rilascio, parliamone.

Fabrizio Billeci
Fabrizio Billeci
Sviluppatore app Flutter e full-stack · Catania

Torna al blog

Articoli correlati

Hai un progetto in mente?

Raccontami obiettivi e tempi: ti rispondo con una proposta concreta, una roadmap e una stima economica.

Parliamo del tuo progetto