ann_flutter_flavor 0.4.10

Multi-flavor Flutter toolkit. Reads annspec.yaml, generates typed flavor classes, and wires Android, iOS, Firebase, AdMob and RevenueCat.

Changelog

0.4.10

Added

• Three firebase helper functions: flavorFirebaseOptions() (auto-selects by build type), flavorFirebaseOptionsRelease() (always release), flavorFirebaseOptionsDebug() (always debug). The previous single flavorFirebaseOptions() function is replaced by this trio.
• auth() concrete default on AnnFlavorConfig: dispatches to authRelease() or authDebug() based on AnnFlavor.buildType. Consumers no longer need to implement auth() themselves.

Breaking

• auth() renamed to authRelease() in AnnFlavorConfig. Any class that overrides auth() must rename the override to authRelease(). The ann_flutter_flavor sync command regenerates ann_flavor.g.dart with the correct method name automatically.
• The _<Flavor>Firebase private class now exposes optionsRelease() instead of options(). Generated code is updated automatically on next sync.

Fixed

• DEF-021 (Gradle 2.0.16): PostBuildProcessingTask annotation fix — FirebaseCopyTask now runs reliably before cleanup. Update the Gradle plugin version in your project to 2.0.16.
• Version sync — bundled Gradle plugin reference (kGradlePluginVersion) updated to 2.0.16.

---

0.4.9

Version sync — updated bundled Gradle plugin reference (kGradlePluginVersion) to 2.0.15 (DEF-020: google-services.json copy path fix).

---

0.4.8

Fixed

• DEF-019: --target flag corrected to --ios-target — the flag name used by flutterfire configure v1.4.0.

---

0.4.7

Added

• DEF-019 (target field): New optional target field inside firebase blocks (iOS only) — names the Xcode target passed to flutterfire configure --target. Resolves via a 4-level cascade identical to service_account. Defaults to "Runner" when absent at all cascade levels. Valid in default.firebase, default.build_types.<bt>.firebase, flavor.<n>.firebase, and flavor.<n>.build_types.<bt>.firebase.

Fixed

• DEF-019: iOS flutterfire configure now passes --ios-out ios/Runner/GoogleService-Info.plist (exact basename required by flutterfire v1.4.0) and &&-chains a cp to the stable committed path at lib/generated/firebase/GoogleService-Info-{flavor}-{buildType}.plist followed by rm. Previously --ios-out was set to the stable path directly, causing flutterfire v1.4.0 to throw ValidationException: --ios-out basename must be exactly GoogleService-Info.plist.

---

0.4.6

Added

• DEF-017: New validate-testspec CLI command — validates anntestspec.yaml standalone, exits 1 if not found or if the file contains errors. Supports --format json for machine consumption (CI-friendly). The validate command also runs testspec validation automatically and includes a testspec key in its JSON output.
• DEF-017: sync now adds gem 'ann-flavor-cocoapods' to the Gemfile when iOS is configured in annspec.yaml. Previously the CocoaPods plugin gem was never added automatically, causing pod install to fail with "plugin ann-ios-flavorize not installed".

Fixed

• DEF-018: Generated firebase.sh now sets export CI=true at the top of the script. This suppresses flutterfire's ANSI escape codes and spinner sequences ([A[2K⠹ …) when the script is run in an IDE terminal or any non-TTY context.

• DEF-014: firebase.sh now writes google-services.json and GoogleService-Info.plist to lib/generated/firebase/ with stable flavor/buildType-scoped filenames instead of routing them to $ANN_TEMP_DIR. These files are safe to commit and are read by the Gradle and CocoaPods build plugins on every build.

  sync now appends .gitignore entries to prevent the build-plugin target copies (android/app/src/**/google-services.json and ios/**/GoogleService-Info.plist) from being committed.

  The script cleanup step is narrowed from rm -rf lib/generated/firebase/* to rm -f lib/generated/firebase/*_firebase_options.dart so committed JSON/plist sources are not wiped on re-run.

---

0.4.5

Fixed

• DEF-006: _patchSettings() now updates the Gradle plugin version in-place when the entry already exists but carries a stale version, for both KTS and Groovy DSL. Previously only the first-time insertion path wrote the correct version.

Changed

• --firebase-mode default changed from run to script (breaking change in default behaviour)

  dart run ann_flutter_flavor sync now generates lib/generated/scripts/firebase.sh by default instead of executing flutterfire configure inline. This prevents the sync step from hanging when Firebase auth is not available at sync time.

  Migration: if you relied on the old inline-execution default, add --firebase-mode inline explicitly. The --firebase-mode run value has been removed — use inline instead.

  Old	New
  dart run ann_flutter_flavor sync	Equivalent to --firebase-mode inline (old) → now --firebase-mode script (default)
  dart run ann_flutter_flavor sync --firebase-mode run	Use --firebase-mode inline
  dart run ann_flutter_flavor sync --firebase-mode script	Unchanged

---

0.4.4

Version sync — updated bundled Gradle plugin reference (kGradlePluginVersion) to 2.0.12.

---

0.4.3

Version sync — updated bundled Gradle plugin reference (kGradlePluginVersion) to 2.0.11 (firebase android default fix). No Flutter CLI behaviour changes.

---

0.4.2

Comments in generated Podfile and Gemfile — plugin 'ann-ios-flavorize' in ios/Podfile and gem "ann-flavor-flutter" in Gemfile are now preceded by a comment explaining they were added by ann_flutter_flavor, making it clear these lines should not be removed manually.

applicationId and minSdk no longer overwritten — sync no longer rewrites defaultConfig.applicationId or minSdk in android/app/build.gradle(.kts). These values are owned by the developer; per-flavor applicationId is managed by the ANN Gradle plugin at Gradle sync time.

Firebase script improvements — --firebase-mode script now generates a more robust shell script: old generated files are cleaned before re-running, each flutterfire configure call reports success/failure individually, and a summary is printed at the end. The script exits with a non-zero code if any command failed.

Accurate flutterfire configure arguments — the generated commands (both run mode and script mode) now include -i/-a (bundle ID) and --ios-build-config (e.g. Release-ledger_in), ensuring flutterfire targets the correct registered app and Xcode build configuration in multi-flavor projects.

0.4.1

service_account 4-level cascade — service_account can now be placed at default.firebase.service_account or flavor.<n>.firebase.service_account to share one key across all build types without repetition. Full cascade (most-specific wins):

1. flavor.<n>.build_types.<bt>.firebase.service_account
2. flavor.<n>.firebase.service_account
3. default.build_types.<bt>.firebase.service_account
4. default.firebase.service_account

---

0.4.0

--firebase-mode script — sync accepts --firebase-mode script to write lib/generated/scripts/firebase.sh instead of running flutterfire configure inline. Use when Firebase auth is unavailable at sync time (e.g. the service account is decoded in a later CI step). The generated script navigates to the project root automatically.

iOS config_file guard — sync now aborts with a clear error when an iOS firebase block has config_file without project_id. iOS must use project_id mode; config_file is Android-only.

sync pre-flight validation — sync now runs validate before generating any files. If the spec has errors, sync aborts immediately with exit 1 and no files are written. Warnings are printed but generation continues.

Step reorder — Firebase (flutterfire configure) now runs after the fast deterministic steps (Dart → Android → iOS) instead of second. New step order: [0] validate → [1] Dart → [2] Android → [3] iOS → [4] Firebase → [5] Fastlane → [6] Melos.

--format json — sync and validate accept --format json to emit the pre-flight result as machine-readable JSON on stdout. All other output goes to stderr. Useful for IDE integrations and CI pipelines.

doctor command — replaces version. Shows the ann_flutter_flavor version and checks each linked plugin's installed version against the expected target. The old version command has been removed.

Firebase: config_file on iOS is now a hard error — sync exits 1 immediately when an iOS firebase block contains config_file. iOS must use project_id (which triggers flutterfire configure to generate the options file). See the Firebase Setup section in the README for setup guidance.

0.3.0

Firebase service account auth — flutterfire configure now authenticates exclusively via the service_account field in annspec.yaml. ADC (gcloud auth) and firebase login are no longer used or supported. Set service_account in your firebase block alongside project_id; sync will warn if project_id is set without a service account.

validate --format json — the validate command now accepts --format json, emitting a single JSON object on stdout with all errors and warnings. Exit code 1 when any error is present. Used by the Studio plugin (1.1.0) for IDE-integrated validation.

version command — new command that reads pubspec.lock, android/settings.gradle.kts, and Gemfile.lock to compare installed plugin versions against expected targets. Exits 1 when any detectable plugin is outdated.

Firebase validation improvements — new checks:

• Error: firebase.file key (renamed to config_file in 0.1.6) is now a hard error with a migration hint
• Warning: project_id set without a service_account
• Warning: service_account set alongside config_file (ineffective)
• Warning: integrations.firebase: true set but no firebase blocks configured in spec

0.2.5

Internal publish-workflow improvements. No user-facing changes.

0.2.4

120-second timeout on flutterfire configure — prevents sync from hanging indefinitely when auth prompts or network issues stall the FlutterFire CLI.

Signing path resolution — relative cert/key paths in credentials.signing are now resolved to absolute paths before being passed to Gradle, preventing build failures when pod install or gradle are invoked from a different working directory.

0.2.2

Redesigned summary command — output is now organised by flavor × build type, showing fully resolved (cascaded) values for every field:

• Each flavor has a block per build type (release, debug, …)
• Every field shown is the effective value after the default → flavor → build type cascade: id, name, version, firebase, auth, admob, stores, custom, and Android build-type flags
• When no flavors are defined, the default values are shown per build type
• The old top-level "default" block is removed

0.2.1

enabled: false support in validate — if annspec.yaml sets enabled: false, the validate command now shows a warning at the top explaining that all plugins will ignore the file, while still running full structural validation on the rest of the spec.

Improved validate output — every error and warning now shows:

• The exact YAML path where the problem is (e.g. app.android.flavor.free.stores.google_play.priority)
• A precise description of what is wrong
• A → fix hint telling you what to add, change, or remove

Also: parse-time errors (missing app: root key, old annai_app: key) now print a clear message with a migration hint instead of a raw Dart type error.

0.2.0

Breaking: annai_app: root key renamed to app: — annspec.yaml files using the old annai_app: root key must be updated. The CLI shows a clear migration hint if the old key is detected.

0.1.9

Internal pub.dev score improvements (documentation, example, analysis options). No user-facing behaviour changes.

0.1.7

Expanded validate command — comprehensive field-level checks across the entire spec: bundle IDs, version formats, firebase mode conflicts, store IDs, signing paths, and unknown field detection.

0.1.6

buildType auto-detection — AnnFlavor.buildType is now derived automatically from Dart's kDebugMode / kReleaseMode. The buildType parameter is no longer needed in AnnFlavor.init().

flutterfire configure invoked directly during sync — removes the generated firebase.sh shell script. Firebase configuration is now driven entirely by the project_id field in annspec.yaml.

Firebase config refactored — path, firebase_app_id, and build_target fields are replaced by two mutually exclusive modes:

• config_file — path to a static google-services.json / GoogleService-Info.plist
• project_id — runs flutterfire configure during sync to generate options files

Example app added — a real flutter create example with free / pro flavors is included in the package.

0.1.4

integrations block — new top-level integrations: key in annspec.yaml with fastlane and melos flags. When enabled:

• fastlane: true — sync generates a Gemfile wiring the Fastlane plugin
• melos: true — sync patches a managed block in pubspec.yaml with Melos scripts

The managed block uses start/end markers so user-authored content outside the block is never overwritten.

0.1.3

Internal publish pipeline improvements (per-plugin tagging, unified workflow). No user-facing behaviour changes.

0.1.2

Internal CI/workflow fix. No user-facing behaviour changes.

0.1.1

Initial release.