ann-flutter-flavor 0.1.2

data/lib/fastlane/plugin/ann_flutter_flavor/helper/lanes_setup.rb

@@ -0,0 +1,161 @@
+require 'fileutils'
+require 'fastlane/action'
+
+module FastlaneFlutterFlavor
+  # Helper class containing maintenance and environment setup logic
+  class SetupLanes
+    # (upgrade_setup and cleanup) are inherently cross-platform.
+    def initialize(root_folder:, status_manager:)
+      @root_folder = root_folder
+      @status_manager = status_manager
+    end
+
+    # ------------------------------------
+    # Core Maintenance and Setup
+    # ------------------------------------
+
+    def upgrade_setup(force: false)
+      begin
+        Fastlane::UI.message("🚀 Starting maintenance and environment checks...")
+
+        # 1. Update Flutter SDK
+        Fastlane::UI.message("-> Step 1: Running 'flutter upgrade' to update SDK.")
+        Fastlane::Actions::sh("flutter", "upgrade")
+
+        # 2. Aggressive Cleanup: Delete lock files and call cleanup lane to remove build artifacts
+        if force
+            Fastlane::UI.message("-> Step 2: Running aggressive pre-resolution cleanup (deleting lock files and build artifacts)...")
+            Dir.chdir @root_folder do
+                pubspec_lock_path = File.join(@root_folder, "pubspec.lock")
+                gemfile_lock_path = File.join(@root_folder, "Gemfile.lock")
+
+                # Delete Dart lock file
+                if File.exist?(pubspec_lock_path)
+                    Fastlane::UI.message("   -> Deleting pubspec.lock to force full Flutter dependency re-resolution.")
+                    FileUtils.rm_f(pubspec_lock_path)
+                end
+
+                # Delete Ruby lock file
+                if File.exist?(gemfile_lock_path)
+                    Fastlane::UI.message("   -> Deleting Gemfile.lock to force full Ruby dependency re-resolution.")
+                    FileUtils.rm_f(gemfile_lock_path)
+                end
+            end
+
+            # Call cleanup which, with force: true, deletes ios/Podfile.lock, ios/Pods, and all build folders
+            cleanup(force: force)
+        end
+
+        # 3. Resolve Dependencies: Ruby first, then Flutter (Root task)
+        Dir.chdir @root_folder do
+          Fastlane::UI.message("-> Step 3: Resolving Ruby and Dart dependencies...")
+
+          # Resolve Ruby dependencies (Gemfile.lock is regenerated here)
+          bundle_install_command = ["bundle", "install"]
+          bundle_update_command = ["bundle", "update"]
+          bundle_install_command << "--force" if force
+          bundle_update_command << "--force" if force
+
+          Fastlane::UI.message("   -> Running 'bundle install' and 'bundle update'#{force ? ' (with --force)' : ''}...")
+          Fastlane::Actions::sh(*bundle_install_command)
+          Fastlane::Actions::sh(*bundle_update_command)
+
+          # Resolve Dart dependencies (pubspec.lock is regenerated here)
+          Fastlane::UI.message("   -> Running 'flutter pub get' to re-resolve Dart dependencies.")
+          Fastlane::Actions::sh("flutter", "pub", "get")
+        end
+
+        # 4. Resolve Native iOS Dependencies
+        ios_dir = File.join(@root_folder, "ios")
+        if File.directory?(ios_dir)
+          Fastlane::UI.message("-> Step 4: Running 'pod install' in the 'ios' directory to ensure native dependencies are linked.")
+
+          # Use --repo-update when force is true to fix "CocoaPods could not find compatible versions" errors.
+          pod_command = ["bundle", "exec", "pod", "install"]
+          if force
+            pod_command << "--repo-update"
+            Fastlane::UI.message("   -> Adding '--repo-update' flag to pod install for aggressive source update.")
+          end
+
+          Dir.chdir ios_dir do
+            Fastlane::Actions::sh(*pod_command)
+          end
+        else
+          Fastlane::UI.important("   -> Skipped 'pod install': 'ios' directory not found (likely not an iOS-enabled project).")
+        end
+
+        # 5. Doctor check (Root task)
+        Fastlane::UI.message("-> Step 5: Running 'flutter doctor' for final verification.")
+        Fastlane::Actions::sh("flutter", "doctor")
+
+        # Pass nil for platform since this is a cross-platform action
+        @status_manager.logSuccess nil, "upgrade_setup", nil
+        return true
+      rescue => e
+        Fastlane::UI.error "❌ Error during environment setup or upgrade: #{e}"
+        Fastlane::UI.error e
+        # Pass nil for platform since this is a cross-platform action
+        @status_manager.logError nil, "upgrade_setup", nil, e
+        return false
+      end
+    end
+
+    # ------------------------------------
+    # Core Cleanup
+    # ------------------------------------
+
+    def cleanup(force: false)
+      begin
+        Fastlane::UI.message("🧹 Cleaning build artifacts...")
+
+        # 1. Standard Flutter clean (Root task)
+        Fastlane::UI.message("-> Running 'flutter clean'...")
+        Dir.chdir @root_folder do
+            Fastlane::Actions::sh("flutter", "clean")
+        end
+
+        if force
+          Fastlane::UI.message("-> Performing aggressive cleanup (deleting platform-specific build folders)...")
+          # 2. Aggressive cleanup of general Flutter build folder and platform-specific folders
+          dirs_to_delete = [
+            "build", # General Flutter build
+            "android/.gradle",
+            "android/build",
+            "ios/Pods",
+            "ios/Podfile.lock", # Crucial for forcing a fresh dependency graph on next install
+            "ios/build",
+            "web/build"
+          ]
+
+          # Change directory temporarily to simplify paths for deletion
+          Dir.chdir @root_folder do
+            dirs_to_delete.each do |dir|
+              full_path = File.join(dir)
+
+              # Only delete if the file/directory exists
+              if File.exist?(full_path)
+                Fastlane::UI.message("Deleting artifact: #{dir}")
+                FileUtils.rm_rf(full_path)
+                Fastlane::UI.success("Successfully deleted: #{dir}")
+              end
+            end
+          end
+          Fastlane::UI.success("Successfully performed aggressive cleanup.")
+        else
+            Fastlane::UI.important("Skipped aggressive deletion of build directories and native lock files. Pass 'force: true' to perform full cleanup.")
+        end
+
+        # Pass nil for platform since this is a cross-platform action
+        @status_manager.logSuccess nil, "cleanup", nil
+        return true
+      rescue => e
+        Fastlane::UI.error "❌ Error during cleanup of build artifacts: #{e}"
+        Fastlane::UI.error e
+        # Pass nil for platform since this is a cross-platform action
+        @status_manager.logError nil, "cleanup", nil, e
+        return false
+      end
+    end
+
+  end
+end

data/lib/fastlane/plugin/ann_flutter_flavor/helper/podspec_bridge.rb

@@ -0,0 +1,153 @@
+module FastlaneFlutterFlavor
+  class PodspecBridge
+
+    # Static entry point to initialize the bridge.
+    # @param config_name [String] optional specific Xcode configuration name (e.g., "Debug-ledger_in")
+    def self.current_config(config_name = nil)
+      # 1. FLAVOR DETECTION: Prioritize Flutter CLI, fallback to config name parsing
+      flavor = ENV['FLUTTER_APP_FLAVOR']
+      if flavor.nil? || flavor.empty?
+        active_config = config_name || ENV['CONFIGURATION'] || ""
+        flavor = active_config.split('-').last
+      end
+
+      # 2. SMART ROOT DETECTION
+      # Start from the current directory and walk up until we find annspec.yaml
+      search_dir = Dir.pwd
+      spec_file = 'annspec.yaml'
+      root = nil
+
+      # Walk up to 10 levels to find the project root
+      10.times do
+        if File.exist?(File.join(search_dir, spec_file))
+          root = search_dir
+          break
+        end
+        search_dir = File.expand_path('..', search_dir)
+      end
+
+      if root.nil?
+        raise "Could not find #{spec_file} in #{Dir.pwd} or any parent directories. " +
+                "Ensure you are running pod install from your Flutter project's /ios folder."
+      end
+
+      loader = YamlSpecLoader.new(root, spec_file)
+      self.new(loader, flavor, config_name)
+    end
+
+    # Injects YAML values into the Xcode Project Build Settings
+    def self.apply_build_settings(installer)
+      project = nil
+
+      installer.aggregate_targets.each do |target|
+        target.user_project.targets.each do |user_target|
+          # Only apply to the main app target (Runner)
+          next unless user_target.name == 'Runner'
+          project = target.user_project
+
+          user_target.build_configurations.each do |config|
+            # Initialize bridge per configuration iteration
+            bridge = self.current_config(config.name)
+            s = config.build_settings
+
+            # Injection Mapping: YAML -> Xcode Build Settings (User-Defined)
+            s['ASSET_PREFIX']              = bridge.asset_prefix
+            s['APP_DISPLAY_NAME']          = bridge.display_name
+            s['PRODUCT_BUNDLE_IDENTIFIER'] = bridge.bundle_id
+            s['MARKETING_VERSION']         = bridge.version_name
+            s['CURRENT_PROJECT_VERSION']   = bridge.version_code
+            s['GMS_ADS_ID']                = bridge.gms_ads_id
+            s['REVERSED_CLIENT_ID']        = bridge.auth_reversed_client_id
+            s['GOOGLE_APP_ID']             = bridge.google_app_id
+
+            # Optional: Auto-set development team from YAML if present
+            s['DEVELOPMENT_TEAM']          = bridge.team_id if bridge.team_id
+          end
+        end
+      end
+
+      installer.pods_project.targets.each do |pod_target|
+        pod_target.build_configurations.each do |config|
+          bridge = self.current_config(config.name)
+          s = config.build_settings
+
+          # We push the specific keys needed by the podscripts
+          s['GMS_ADS_ID']           = bridge.gms_ads_id
+          s['APP_DISPLAY_NAME']     = bridge.display_name
+          s['GOOGLE_APP_ID']        = bridge.google_app_id
+          s['REVERSED_CLIENT_ID']   = bridge.auth_reversed_client_id
+
+        end
+      end
+
+      # Save the project once after all configurations are updated
+      project.save if project
+
+      log_flavor = ENV['FLUTTER_APP_FLAVOR'] || "detected"
+      puts "[Annai] Successfully injected flavor '#{log_flavor}' settings into Xcode configurations."
+    end
+
+    def initialize(loader, flavor, config_name = nil)
+      @loader = loader
+      @flavor = flavor
+      @platform = :ios
+
+      # BUILD TYPE DETECTION: Prioritize Flutter CLI mode, fallback to config name regex
+      flutter_mode = ENV['FLUTTER_BUILD_MODE']&.downcase
+      active_config = config_name || ENV['CONFIGURATION'] || ""
+
+      if flutter_mode && !flutter_mode.empty?
+        # Profile mode maps to release for production-like behavior
+        @build_type = (flutter_mode == 'profile') ? 'release' : flutter_mode
+      elsif active_config.match?(/debug/i)
+        @build_type = 'debug'
+      else
+        @build_type = 'release'
+      end
+    end
+
+    # --- Interface Methods (Proxy to YamlSpecLoader) ---
+
+    def asset_prefix
+      @flavor
+    end
+
+    def display_name
+      @loader.get_display_name(@platform, @flavor)
+    end
+
+    def bundle_id
+      @loader.get_package_id(@platform, @flavor)
+    end
+
+    def version_name
+      @loader.get_version_name(@platform, @flavor)
+    end
+
+    def version_code
+      @loader.get_version_code(@platform, @flavor)
+    end
+
+    def gms_ads_id
+      @loader.get_gms_ads_id(@platform, @flavor)
+    end
+
+    def team_id
+      @loader.get_team_id(@platform, @flavor)
+    end
+
+    def auth_client_id
+      @loader.get_auth_client_id(@platform, @flavor, @build_type)
+    end
+
+    def auth_reversed_client_id
+      @loader.get_auth_reversed_client_id(@platform, @flavor, @build_type)
+    end
+
+    def google_app_id
+      # Manual lookup for nested Firebase IDs (using build_type for debug/release)
+      config = @loader.get_merged_flavor_config(@platform, @flavor)
+      config.dig('firebase', @build_type, 'firebase_app_id') || ''
+    end
+  end
+end

data/lib/fastlane/plugin/ann_flutter_flavor/helper/test_integration.rb

@@ -0,0 +1,346 @@
+require 'yaml'
+require 'fileutils'
+require 'fastlane/action'
+
+module FastlaneFlutterFlavor
+
+  # ------------------------------------
+  # IntegrationTest (Helper Class)
+  # ------------------------------------
+  class IntegrationTest
+
+    def initialize(lane: , isAndroid: , isIos: , test_spec_file: , statusManager:, root_folder:) # Added root_folder
+      @lane = lane
+      @isAndroid = isAndroid
+      @isIos = isIos
+      @test_spec_file = test_spec_file
+      @loaded = false
+      @statusManager = statusManager
+      @root_folder = root_folder # Store root folder
+    end
+
+    def cleanup
+    end
+
+    def openEmulators(options: )
+
+      load_file()
+
+      @emulators.each_pair { |emulator,port|
+        if emulator == options.fetch(:emulator, emulator)
+          wipe_data = options.fetch(:wipe_data, true)
+          if @isAndroid
+            openAndroidEmulator(emulatorName: emulator, port: port, wipe_data: wipe_data, dns_server: options.fetch(:dns_server, ""))
+          elsif @isIos
+            openIosEmulator(emulatorName: emulator, wipe_data: wipe_data)
+          end
+        end
+      }
+    end
+
+    def closeEmulators(options: )
+
+      load_file()
+
+      @emulators.each_pair { |emulator,port|
+        if emulator == options.fetch(:emulator, emulator)
+          if @isAndroid
+            closeAndroidEmulator(emulatorName: emulator, port: port)
+          elsif @isIos
+            closeIosEmulator(emulatorName: emulator)
+          end
+        end
+      }
+    end
+
+    def runTests(flavor: nil, emulator: nil, open_emulator: true, close_emulator: true, wipe_data: true, skip_screenshots: nil, skip_sound_null_safety: false)
+
+      load_file()
+
+      openedEmulator = {}
+
+      # Determine target emulators: nil => all; string (comma-separated) or array => only those entries
+      target_emulators = if emulator.nil?
+                           @emulators
+                         else
+                           emulators_list = emulator.is_a?(String) ? emulator.split(",").map(&:strip) : Array(emulator)
+                           found = emulators_list.select { |e| @emulators.key?(e) }
+                           missing = emulators_list - found
+
+                           if missing.any?
+                             Fastlane::UI.error("Emulator(s) not found in the test spec: #{missing.join(', ')}. Available: #{@emulators.keys.join(', ')}")
+                           end
+
+                           if found.empty?
+                             Fastlane::UI.error("None of the specified emulators were found. Aborting runTests.")
+                             return
+                           end
+
+                           @emulators.select { |k,_| found.include?(k) }
+                         end
+
+      target_emulators.each_pair { |emulator_name, port|
+        # already limited to chosen emulators; treat as valid
+        isValidEmulator = true
+        isEmulatorAlreadyOpen = openedEmulator.fetch(emulator_name, false)
+
+        if open_emulator && isValidEmulator && !isEmulatorAlreadyOpen
+          if @isAndroid
+            openAndroidEmulator(emulatorName: emulator_name, port: port, wipe_data: wipe_data, dns_server: "")
+          elsif @isIos
+            openIosEmulator(emulatorName: emulator_name, wipe_data: wipe_data)
+          end
+          openedEmulator[emulator_name] = true
+        end
+
+        @flavorDevices.each_pair { |key,value|
+          device = key[0]
+          flavor_name = key[1]
+          next unless emulator_name == device
+
+          # Determine which flavors to run: if a filter was provided use it, otherwise default to the flavor from the spec
+          flavors = if flavor.nil?
+                      [flavor_name]
+                    else
+                      flavor.split(",")
+                    end
+          isValidFlavor = flavors.include?(flavor_name)
+          next unless isValidFlavor
+
+          deviceName = device
+          if @isAndroid
+            deviceName = "emulator-#{port}"
+          end
+
+          test_cases = value['tests']
+          test_cases.each_pair { |testcaseName,parameters|
+            begin
+              resolved_skip_screenshots = skip_screenshots.nil? ? !@enable_screenshots : skip_screenshots
+
+              runTest(
+                driver_file: value['driver_file'],
+                test_file: value['test_file'],
+                device_id: deviceName,
+                flavor: flavor_name,
+                testcase_name: testcaseName,
+                parameters: parameters,
+                skip_screenshots: resolved_skip_screenshots,
+                skip_sound_null_safety: skip_sound_null_safety
+              )
+
+              @statusManager.logSuccess flavor_name, "runTests", emulator_name
+            rescue => e
+              Fastlane::UI.error "Error while running tests for flavor #{flavor_name}"
+
+              @statusManager.logError flavor_name, "runTests", emulator_name, e
+            end
+          }
+        }
+
+        if close_emulator && isValidEmulator
+          if @isAndroid
+            closeAndroidEmulator(emulatorName: emulator_name, port: port)
+          elsif @isIos
+            closeIosEmulator(emulatorName: emulator_name)
+          end
+          openedEmulator[emulator_name] = false
+        end
+      }
+    end
+
+    private
+
+    def load_file()
+      @emulators = {}
+      @flavors = []
+      @flavorDevices = {}
+      @enable_screenshots = false
+
+      if File.exist?(@test_spec_file) && !@loaded
+        @annaiTestSpecFile = YAML.load_file(@test_spec_file)
+      end
+
+      if !@loaded && @annaiTestSpecFile['annai_app_tests']['enable_screenshots'] != nil
+        @enable_screenshots = @annaiTestSpecFile['annai_app_tests']['enable_screenshots']
+      end
+
+      if !@loaded && @isAndroid
+        @androidTestSpec = @annaiTestSpecFile['annai_app_tests']['android']
+        port = 5554
+
+        @androidTestSpec['flavor'].each_pair { |flavor,devices|
+          @flavors.push(flavor)
+          devices['devices'].each_pair { |device,value|
+            driver_file = value.fetch('driver_file', @androidTestSpec['default']['driver_file'])
+            test_file = value.fetch('test_file', @androidTestSpec['default']['test_file'])
+            port_number = value['port_number']
+
+            @flavorDevices[[device, flavor]] = {
+              'test_file' => test_file,
+              'driver_file' => driver_file,
+              'tests' => value['tests']
+            }
+            unless @emulators.has_key?(device)
+              if(port_number != nil)
+                @emulators[device] = port_number
+              else
+                @emulators[device] = port
+                port += 2
+              end
+            end
+          }
+        }
+      elsif !@loaded && @isIos
+        @iosTestSpec = @annaiTestSpecFile['annai_app_tests']['ios']
+
+        @iosTestSpec['flavor'].each_pair { |flavor,devices|
+          @flavors.push(flavor)
+          devices['devices'].each_pair { |device,value|
+            driver_file = value.fetch('driver_file', @iosTestSpec['default']['driver_file'])
+            test_file = value.fetch('test_file', @iosTestSpec['default']['test_file'])
+
+            @flavorDevices[[device, flavor]] = {
+              'test_file' => test_file,
+              'driver_file' => driver_file,
+              'tests' => value['tests']
+            }
+            unless @emulators.has_key?(device)
+              @emulators[device] = 0
+            end
+          }
+        }
+      end
+      @loaded = true
+      #puts @emulators
+      #puts @flavors
+      #puts @flavorDevices
+    end
+
+    def openAndroidEmulator(emulatorName: , port: ,wipe_data: true, dns_server: "")
+
+      if wipe_data
+        if dns_server != ""
+          Fastlane::Actions::sh("screen", "-dmS", emulatorName, "emulator", "-port", "#{port}", "-avd", emulatorName, "-wipe-data", "-dns-server", dns_server)
+        else
+          Fastlane::Actions::sh("screen", "-dmS", emulatorName, "emulator", "-port", "#{port}", "-avd", emulatorName, "-wipe-data")
+        end
+      else
+        if dns_server != ""
+          Fastlane::Actions::sh("screen", "-dmS", emulatorName, "emulator", "-port", "#{port}", "-avd", emulatorName, "-dns-server", dns_server)
+        else
+          Fastlane::Actions::sh("screen", "-dmS", emulatorName, "emulator", "-port", "#{port}", "-avd", emulatorName)
+        end
+      end
+
+      sleep(40)
+    end
+
+    def closeAndroidEmulator(emulatorName: , port:)
+      Fastlane::Actions::sh("screen", "-dmS", emulatorName, "adb", "-s", "emulator-#{port}", "emu", "kill")
+      sleep(5)
+    end
+
+    def openIosEmulator(emulatorName: ,wipe_data: true)
+      res = Fastlane::Actions::sh("xcrun", "simctl", "list", "--json", "devices", "#{emulatorName}", "available", log: false)
+      udid = res.match(/"udid"\s+:\s+"(.*)"/)[1]
+      if wipe_data
+        Fastlane::Actions::sh("xcrun", "simctl", "erase", udid, log: false)
+        sleep(10)
+      end
+
+      Fastlane::Actions::sh("open", "-a", "Simulator", "--args", "-CurrentDeviceUDID", udid)
+      sleep(10)
+      res = Fastlane::Actions::sh("xcrun", "simctl", "list", "--json", "devices", "#{emulatorName}", "available", log: false)
+      state = res.match(/"state"\s+:\s+"(.*)"/)[1]
+      if state == "Shutdown"
+        Fastlane::Actions::sh("xcrun", "simctl", "boot", udid)
+        sleep(10)
+      end
+    end
+
+    def closeIosEmulator(emulatorName:)
+      res = Fastlane::Actions::sh("xcrun", "simctl", "list", "--json", "devices", "#{emulatorName}", "available", log: false)
+      udid = res.match(/"udid"\s+:\s+"(.*)"/)[1]
+      state = res.match(/"state"\s+:\s+"(.*)"/)[1]
+      unless state == "Shutdown"
+        Fastlane::Actions::sh("xcrun", "simctl", "shutdown", udid)
+        sleep(5)
+      end
+    end
+
+    def runTest(driver_file:, test_file:, device_id:, flavor: "", testcase_name: "", parameters:, skip_sound_null_safety: false, skip_screenshots: true)
+
+      dart_define_option = Array.new(10) {|i| '--dart-define=' }
+      index = 0
+      if testcase_name != ""
+        dart_define_option[index] = "--dart-define=testcase_name=#{testcase_name}"
+        index += 1
+      end
+
+      flavorOption = ""
+      if flavor != ""
+        flavorOption = "--flavor"
+        dart_define_option[index] = "--dart-define=flavor=#{flavor}"
+        index += 1
+      end
+
+      parameters.each_pair { |key,value|
+        dart_define_option[index] = "--dart-define=#{key}=#{value}"
+        index += 1
+      }
+
+      nullSafety = ""
+      if skip_sound_null_safety
+        nullSafety = "--no-sound-null-safety"
+      end
+
+      device_option = ""
+      if device_id != ""
+        device_option = "-d"
+      end
+
+      # Changed Dir.chdir ".." to use the dynamically found @root_folder
+      if skip_screenshots
+        Dir.chdir @root_folder do
+          Fastlane::Actions::sh(
+            "flutter", "test",
+            test_file,
+            flavorOption, flavor,
+            dart_define_option[0],
+            dart_define_option[1],
+            dart_define_option[2],
+            dart_define_option[3],
+            dart_define_option[4],
+            dart_define_option[5],
+            dart_define_option[6],
+            dart_define_option[7],
+            dart_define_option[8],
+            dart_define_option[9],
+            device_option, device_id
+          )
+        end
+      else
+        Dir.chdir @root_folder do
+          Fastlane::Actions::sh(
+            "flutter", "drive",
+            "--driver=#{driver_file}",
+            "--target=#{test_file}",
+            flavorOption, flavor,
+            nullSafety,
+            dart_define_option[0],
+            dart_define_option[1],
+            dart_define_option[2],
+            dart_define_option[3],
+            dart_define_option[4],
+            dart_define_option[5],
+            dart_define_option[6],
+            dart_define_option[7],
+            dart_define_option[8],
+            dart_define_option[9],
+            device_option, device_id
+          )
+        end
+      end
+    end
+  end
+end