ann-flutter-flavor 0.1.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 984f73b5f299d07b74007d531c54f535f3d9dd5673c8dfe2c113a83fa04eddbc
+  data.tar.gz: 11e4d5d85dc16b3c25bf5843f47ad86c1f71d5501292c92a82081d9a7167fb9b
+SHA512:
+  metadata.gz: cc98fcdf4a4c1ea4292c53cc7cc5257128f95299718e4b07b291e984c20014f8e29bfb19734286a0466d6897543aa817bc81c1e4b50b35a5c171ab6cb94b1bda
+  data.tar.gz: 8823491564fa0e1f851efa2dc2badeefd07784b518af0ea9514a5d22481c151733865c6b0d4b86c633b428c6a30d70914446afdb66aea2ea730b88871b82410b

data/.gitignore

@@ -0,0 +1 @@
+/pkg/

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,271 @@
+PATH
+  remote: .
+  specs:
+    annai-flutter-flavor (0.1.2)
+      fastlane (>= 2.232.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (3.0.8)
+    abbrev (0.1.2)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
+    artifactory (3.0.17)
+    atomos (0.1.3)
+    aws-eventstream (1.4.0)
+    aws-partitions (1.1220.0)
+    aws-sdk-core (3.242.0)
+      aws-eventstream (~> 1, >= 1.3.0)
+      aws-partitions (~> 1, >= 1.992.0)
+      aws-sigv4 (~> 1.9)
+      base64
+      bigdecimal
+      jmespath (~> 1, >= 1.6.1)
+      logger
+    aws-sdk-kms (1.122.0)
+      aws-sdk-core (~> 3, >= 3.241.4)
+      aws-sigv4 (~> 1.5)
+    aws-sdk-s3 (1.213.0)
+      aws-sdk-core (~> 3, >= 3.241.4)
+      aws-sdk-kms (~> 1)
+      aws-sigv4 (~> 1.5)
+    aws-sigv4 (1.12.1)
+      aws-eventstream (~> 1, >= 1.0.2)
+    babosa (1.0.4)
+    base64 (0.2.0)
+    benchmark (0.5.0)
+    bigdecimal (4.0.1)
+    claide (1.1.0)
+    coderay (1.1.3)
+    colored (1.2)
+    colored2 (3.1.2)
+    commander (4.6.0)
+      highline (~> 2.0.0)
+    csv (3.3.5)
+    declarative (0.0.20)
+    diff-lcs (1.6.2)
+    digest-crc (0.7.0)
+      rake (>= 12.0.0, < 14.0.0)
+    domain_name (0.6.20240107)
+    dotenv (2.8.1)
+    emoji_regex (3.2.3)
+    excon (0.112.0)
+    faraday (1.10.5)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
+      ruby2_keywords (>= 0.0.4)
+    faraday-cookie_jar (0.0.8)
+      faraday (>= 0.8.0)
+      http-cookie (>= 1.0.0)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.1)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.2.0)
+      multipart-post (~> 2.0)
+    faraday-net_http (1.0.2)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
+    faraday_middleware (1.2.1)
+      faraday (~> 1.0)
+    fastimage (2.4.0)
+    fastlane (2.232.2)
+      CFPropertyList (>= 2.3, < 4.0.0)
+      abbrev (~> 0.1.2)
+      addressable (>= 2.8, < 3.0.0)
+      artifactory (~> 3.0)
+      aws-sdk-s3 (~> 1.197)
+      babosa (>= 1.0.3, < 2.0.0)
+      base64 (~> 0.2.0)
+      benchmark (>= 0.1.0)
+      bundler (>= 1.17.3, < 5.0.0)
+      colored (~> 1.2)
+      commander (~> 4.6)
+      csv (~> 3.3)
+      dotenv (>= 2.1.1, < 3.0.0)
+      emoji_regex (>= 0.1, < 4.0)
+      excon (>= 0.71.0, < 1.0.0)
+      faraday (~> 1.0)
+      faraday-cookie_jar (~> 0.0.6)
+      faraday_middleware (~> 1.0)
+      fastimage (>= 2.1.0, < 3.0.0)
+      fastlane-sirp (>= 1.0.0)
+      gh_inspector (>= 1.1.2, < 2.0.0)
+      google-apis-androidpublisher_v3 (~> 0.3)
+      google-apis-playcustomapp_v1 (~> 0.1)
+      google-cloud-env (>= 1.6.0, <= 2.1.1)
+      google-cloud-storage (~> 1.31)
+      highline (~> 2.0)
+      http-cookie (~> 1.0.5)
+      json (< 3.0.0)
+      jwt (>= 2.1.0, < 3)
+      logger (>= 1.6, < 2.0)
+      mini_magick (>= 4.9.4, < 5.0.0)
+      multipart-post (>= 2.0.0, < 3.0.0)
+      mutex_m (~> 0.3.0)
+      naturally (~> 2.2)
+      nkf (~> 0.2.0)
+      optparse (>= 0.1.1, < 1.0.0)
+      ostruct (>= 0.1.0)
+      plist (>= 3.1.0, < 4.0.0)
+      rubyzip (>= 2.0.0, < 3.0.0)
+      security (= 0.1.5)
+      simctl (~> 1.6.3)
+      terminal-notifier (>= 2.0.0, < 3.0.0)
+      terminal-table (~> 3)
+      tty-screen (>= 0.6.3, < 1.0.0)
+      tty-spinner (>= 0.8.0, < 1.0.0)
+      word_wrap (~> 1.0.0)
+      xcodeproj (>= 1.13.0, < 2.0.0)
+      xcpretty (~> 0.4.1)
+      xcpretty-travis-formatter (>= 0.0.3, < 2.0.0)
+    fastlane-sirp (1.0.0)
+      sysrandom (~> 1.0)
+    gh_inspector (1.1.3)
+    google-apis-androidpublisher_v3 (0.96.0)
+      google-apis-core (>= 0.15.0, < 2.a)
+    google-apis-core (0.18.0)
+      addressable (~> 2.5, >= 2.5.1)
+      googleauth (~> 1.9)
+      httpclient (>= 2.8.3, < 3.a)
+      mini_mime (~> 1.0)
+      mutex_m
+      representable (~> 3.0)
+      retriable (>= 2.0, < 4.a)
+    google-apis-iamcredentials_v1 (0.26.0)
+      google-apis-core (>= 0.15.0, < 2.a)
+    google-apis-playcustomapp_v1 (0.17.0)
+      google-apis-core (>= 0.15.0, < 2.a)
+    google-apis-storage_v1 (0.61.0)
+      google-apis-core (>= 0.15.0, < 2.a)
+    google-cloud-core (1.8.0)
+      google-cloud-env (>= 1.0, < 3.a)
+      google-cloud-errors (~> 1.0)
+    google-cloud-env (2.1.1)
+      faraday (>= 1.0, < 3.a)
+    google-cloud-errors (1.5.0)
+    google-cloud-storage (1.58.0)
+      addressable (~> 2.8)
+      digest-crc (~> 0.4)
+      google-apis-core (>= 0.18, < 2)
+      google-apis-iamcredentials_v1 (~> 0.18)
+      google-apis-storage_v1 (>= 0.42)
+      google-cloud-core (~> 1.6)
+      googleauth (~> 1.9)
+      mini_mime (~> 1.0)
+    googleauth (1.11.2)
+      faraday (>= 1.0, < 3.a)
+      google-cloud-env (~> 2.1)
+      jwt (>= 1.4, < 3.0)
+      multi_json (~> 1.11)
+      os (>= 0.9, < 2.0)
+      signet (>= 0.16, < 2.a)
+    highline (2.0.3)
+    http-cookie (1.0.8)
+      domain_name (~> 0.5)
+    httpclient (2.9.0)
+      mutex_m
+    io-console (0.8.2)
+    jmespath (1.6.2)
+    json (2.18.1)
+    jwt (2.10.2)
+      base64
+    logger (1.7.0)
+    method_source (1.1.0)
+    mini_magick (4.13.2)
+    mini_mime (1.1.5)
+    multi_json (1.19.1)
+    multipart-post (2.4.1)
+    mutex_m (0.3.0)
+    nanaimo (0.4.0)
+    naturally (2.3.0)
+    nkf (0.2.0)
+    optparse (0.8.1)
+    os (1.1.4)
+    ostruct (0.6.3)
+    plist (3.7.2)
+    pry (0.16.0)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+      reline (>= 0.6.0)
+    public_suffix (7.0.2)
+    rake (13.3.1)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    representable (3.2.0)
+      declarative (< 0.1.0)
+      trailblazer-option (>= 0.1.1, < 0.2.0)
+      uber (< 0.2.0)
+    retriable (3.2.1)
+    rexml (3.4.4)
+    rouge (3.28.0)
+    rspec (3.4.0)
+      rspec-core (~> 3.4.0)
+      rspec-expectations (~> 3.4.0)
+      rspec-mocks (~> 3.4.0)
+    rspec-core (3.4.4)
+      rspec-support (~> 3.4.0)
+    rspec-expectations (3.4.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-mocks (3.4.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-support (3.4.1)
+    ruby2_keywords (0.0.5)
+    rubyzip (2.4.1)
+    security (0.1.5)
+    signet (0.21.0)
+      addressable (~> 2.8)
+      faraday (>= 0.17.5, < 3.a)
+      jwt (>= 1.5, < 4.0)
+      multi_json (~> 1.10)
+    simctl (1.6.10)
+      CFPropertyList
+      naturally
+    sysrandom (1.0.5)
+    terminal-notifier (2.0.0)
+    terminal-table (3.0.2)
+      unicode-display_width (>= 1.1.1, < 3)
+    trailblazer-option (0.1.2)
+    tty-cursor (0.7.1)
+    tty-screen (0.8.2)
+    tty-spinner (0.9.3)
+      tty-cursor (~> 0.7)
+    uber (0.1.0)
+    unicode-display_width (2.6.0)
+    word_wrap (1.0.0)
+    xcodeproj (1.27.0)
+      CFPropertyList (>= 2.3.3, < 4.0)
+      atomos (~> 0.1.3)
+      claide (>= 1.0.2, < 2.0)
+      colored2 (~> 3.1)
+      nanaimo (~> 0.4.0)
+      rexml (>= 3.3.6, < 4.0)
+    xcpretty (0.4.1)
+      rouge (~> 3.28.0)
+    xcpretty-travis-formatter (1.0.1)
+      xcpretty (~> 0.2, >= 0.0.7)
+
+PLATFORMS
+  arm64-darwin-25
+  ruby
+
+DEPENDENCIES
+  annai-flutter-flavor!
+  pry
+  rspec (~> 3.4.0)
+
+BUNDLED WITH
+   2.7.2

data/README.md

@@ -0,0 +1,283 @@
+# ANN Flutter Flavor — Fastlane Plugin
+
+[![RubyGems](https://img.shields.io/gem/v/ann-flutter-flavor)](https://rubygems.org/gems/ann-flutter-flavor)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Fastlane plugin that reads `annspec.yaml` and provides lanes for building, signing, uploading and testing all Flutter flavors across Android, iOS and Web — without writing repetitive Fastfile boilerplate for each flavor.
+
+---
+
+## Installation
+
+Add to your `Pluginfile`:
+
+```ruby
+gem 'ann-flutter-flavor'
+```
+
+Then run:
+
+```bash
+fastlane add_plugin ann_flutter_flavor
+# or
+bundle install
+```
+
+Or add directly via Fastlane:
+
+```bash
+fastlane add_plugin ann_flutter_flavor
+```
+
+---
+
+## Quick start
+
+```ruby
+# Fastfile
+lane :deploy_android do
+  ann_compile_build(platform: :android, build_config: "release")
+  ann_upload_to_play_store(platform: :android)
+end
+
+lane :deploy_ios do
+  ann_compile_build(platform: :ios, build_config: "release")
+  ann_upload_to_app_store(platform: :ios)
+end
+```
+
+Run a lane:
+
+```bash
+bundle exec fastlane deploy_android
+bundle exec fastlane deploy_ios
+```
+
+---
+
+## Actions
+
+### `ann_compile_build` — Build all flavors for a platform
+
+Builds every flavor defined in `annspec.yaml` for a given platform. Supports building a subset of flavors via the `flavor` parameter.
+
+```ruby
+ann_compile_build(
+  platform:             :android,          # :ios, :android, or :web
+  build_config:         "release",         # "debug", "profile", "release"
+  sub_command:          "appbundle",       # "apk", "appbundle", "ipa", "web"
+  flavor:               "production",      # Comma-separated. Omit to build ALL flavors
+  clean:                false,             # Run flutter clean before building
+  main_file:            "lib/main.dart",   # Default main file (overridden per-flavor in spec)
+  skip_sound_null_safety: false,
+  skip_code_sign:       false,
+  export_options_plist: "",                # iOS only — path to ExportOptions.plist
+  additional_parameter: "",               # Extra flutter build flags
+  spec_file:            nil               # Custom path to annspec.yaml (optional)
+)
+```
+
+**Examples:**
+
+```ruby
+# Build all Android flavors
+ann_compile_build(platform: :android)
+
+# Build specific iOS flavors only
+ann_compile_build(platform: :ios, flavor: "production,staging", build_config: "release")
+
+# Build web with clean
+ann_compile_build(platform: :web, sub_command: "web", clean: true)
+```
+
+---
+
+### `ann_upload_to_play_store` — Upload Android to Google Play
+
+Builds and uploads all Android flavors to the Google Play Store using the `google_api_key` defined in `annspec.yaml`.
+
+```ruby
+ann_upload_to_play_store(
+  flavor:    "production",   # Specific flavor(s). Omit for all
+  clean:     false,
+  spec_file: nil
+)
+```
+
+---
+
+### `ann_upload_to_app_store` — Upload iOS to App Store
+
+Builds and uploads all iOS flavors to the Apple App Store using the `apple_api_key` and `export_options_plist` defined in `annspec.yaml`.
+
+```ruby
+ann_upload_to_app_store(
+  flavor:    "production",   # Specific flavor(s). Omit for all
+  clean:     false,
+  spec_file: nil
+)
+```
+
+---
+
+### `ann_upload_to_firebase` — Deploy web to Firebase Hosting
+
+Builds and deploys all web flavors to Firebase Hosting.
+
+```ruby
+ann_upload_to_firebase(
+  flavor:    "web",    # Specific flavor(s). Omit for all
+  clean:     false,
+  spec_file: nil
+)
+```
+
+---
+
+### `ann_run_tests` — Run integration tests
+
+Runs integration tests for all flavors of a given platform using emulators/simulators.
+
+```ruby
+ann_run_tests(
+  platform:       :android,   # :ios or :android
+  test_spec_file: nil         # Path to test spec YAML (optional)
+)
+```
+
+---
+
+### `ann_open_emulators` — Start emulators/simulators
+
+Opens the required emulators or simulators for a platform before running tests.
+
+```ruby
+ann_open_emulators(
+  platform:       :android,
+  test_spec_file: nil
+)
+```
+
+---
+
+### `annai_upgrade_setup` — Maintenance setup
+
+Runs comprehensive Flutter and Fastlane maintenance: `flutter upgrade`, `flutter doctor`, `bundle update`, gem install.
+
+```ruby
+annai_upgrade_setup             # Skip if already up to date
+annai_upgrade_setup(force: true) # Force run regardless
+```
+
+---
+
+### `annai_cleanup` — Clean build artifacts
+
+Runs `flutter clean` and removes platform build folders.
+
+```ruby
+annai_cleanup
+annai_cleanup(force: true)
+```
+
+---
+
+## Configuration
+
+The plugin reads `annspec.yaml` from your Flutter project root. Keys used by Fastlane actions:
+
+```yaml
+annai_app:
+  android:
+    default:
+      fastlane:
+        google_api_key: "../annai_app_data/keys/android/google-api-key.json"
+
+    flavor:
+      production:
+        main_file: "lib/flavors/main_prod.dart"
+        version_name: 2.1.0
+        version_code: 20100
+
+  ios:
+    default:
+      fastlane:
+        apple_api_key: "../annai_app_data/keys/ios/apple_api_key.json"
+        export_options_plist: "../annai_app_data/keys/ios/exportOptions.plist"
+
+    flavor:
+      production:
+        apple_id: "1234567890"        # Required for App Store upload
+        main_file: "lib/flavors/main_prod.dart"
+        version_name: 2.1.0
+        version_code: 20100
+```
+
+See the [Gradle plugin README](https://github.com/anntech-dev/android-studio-plugins/tree/main/plugins/android-build-flavorize#configuration) for the complete `annspec.yaml` field reference.
+
+---
+
+## Typical CI/CD Fastfile
+
+```ruby
+default_platform(:android)
+
+platform :android do
+
+  lane :build do
+    ann_compile_build(
+      platform:     :android,
+      build_config: "release",
+      sub_command:  "appbundle",
+      clean:        true
+    )
+  end
+
+  lane :deploy do
+    ann_upload_to_play_store
+  end
+
+  lane :test do
+    ann_open_emulators(platform: :android)
+    ann_run_tests(platform: :android)
+  end
+
+end
+
+platform :ios do
+
+  lane :build do
+    ann_compile_build(
+      platform:     :ios,
+      build_config: "release",
+      sub_command:  "ipa"
+    )
+  end
+
+  lane :deploy do
+    ann_upload_to_app_store
+  end
+
+end
+```
+
+---
+
+## Requirements
+
+- Fastlane `>= 2.232.2`
+- Ruby `>= 3.0`
+- Flutter project with `annspec.yaml` at the project root
+
+---
+
+## Related plugins
+
+- **[android-build-flavorize](https://central.sonatype.com/artifact/dev.anntech.flavorize/flavorize)** — Gradle plugin for Android build configuration
+- **[android-studio-flavorize](https://plugins.jetbrains.com/plugin/dev.anntech.studio.flavorize)** — Android Studio plugin for interactive spec sync
+
+---
+
+## License
+
+[MIT](LICENSE) © [ANN Solutions](https://github.com/anntech-dev)

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/ann-flutter-flavor.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'ann_flutter_flavor/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ann-flutter-flavor"
+  spec.version       = AnnFlutterFlavor::VERSION
+  spec.authors       = ["ANN Solutions"]
+  spec.email         = ["support@annaibrands.com"]
+  spec.summary       = "A fastlane plugin to manage Flutter build flavors and shared setup."
+  spec.homepage      = "https://github.com/anntech-dev"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Defines the fastlane dependency
+  spec.add_dependency "fastlane", ">= 2.232.2"
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'rspec', '~> 3.4.0'
+end

data/lib/ann-flutter-flavor.rb

@@ -0,0 +1,10 @@
+# This file is loaded by require 'annai-flutter-flavor'
+
+# Load the version (Good Practice)
+require 'ann_flutter_flavor/version'
+
+require 'fastlane'
+
+# Load the Fastlane plugin structure (which defines the Plugin class)
+require 'fastlane/plugin/ann_flutter_flavor'
+

data/lib/ann_flutter_flavor/version.rb

@@ -0,0 +1,3 @@
+module AnnFlutterFlavor
+  VERSION = "0.1.6"
+end