ann-flutter-flavor 0.1.6

data/lib/fastlane/plugin/ann_flutter_flavor/actions/ann_emulators_action.rb

@@ -0,0 +1,180 @@
+require 'fastlane/action'
+# Assuming these helpers are available in the Fastlane plugin structure
+require 'fastlane/plugin/ann_flutter_flavor/helper/test_integration'
+require 'fastlane/plugin/ann_flutter_flavor/helper/utils_status'
+require 'fastlane/plugin/ann_flutter_flavor/helper/utils_project_config'
+
+
+module Fastlane
+  module Actions
+    # ----------------------------------------------------
+    # AnnaiOpenEmulatorsAction
+    # ----------------------------------------------------
+    class AnnaiOpenEmulatorsAction < Action
+
+      def self.run(params)
+        platform = params[:platform]
+        UI.header("Starting Annai Open Emulators for #{platform}")
+
+        # 1. Determine the necessary paths and managers
+        root_folder = FastlaneFlutterFlavor::ProjectUtil.find_flutter_root
+
+        # Resolve the test spec file path
+        test_spec_file_input = params[:test_spec_file]
+        resolved_test_spec_path = FastlaneFlutterFlavor::ProjectUtil.find_annai_test_spec_path(test_spec_file_input)
+
+        # Status Manager is required by IntegrationTest's constructor, though not strictly needed for open/close
+        status_manager = FastlaneFlutterFlavor::StatusManager.new(lane: self)
+
+        # 2. Instantiate IntegrationTest helper
+        integration_test = FastlaneFlutterFlavor::IntegrationTest.new(
+          lane: self,
+          isAndroid: platform == :android,
+          isIos: platform == :ios,
+          test_spec_file: resolved_test_spec_path,
+          statusManager: status_manager,
+          root_folder: root_folder
+        )
+
+        # 3. Call the openEmulators method
+        integration_test.openEmulators(
+          options: {
+            emulator: params[:emulator],
+            wipe_data: params[:wipe_data],
+            dns_server: params[:dns_server]
+          }
+        )
+
+        UI.success("✅ Emulator(s) started successfully for #{platform}.")
+      end
+
+      # ----------------------------------------------------
+      # Define Parameters
+      # ----------------------------------------------------
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :platform,
+                                       description: "The platform (:ios or :android)",
+                                       is_string: false,
+                                       verify_block: proc do |value|
+                                          UI.user_error!("Platform must be :ios or :android") unless [:ios, :android].include?(value)
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :test_spec_file,
+                                       description: "Path to the annai test spec configuration file (relative to flutter root). Defaults to standard discovery",
+                                       optional: true,
+                                       default_value: nil),
+
+          FastlaneCore::ConfigItem.new(key: :emulator,
+                                       description: "The specific emulator/device name (as defined in the test spec) to open. If nil, all defined emulators for the platform will be opened.",
+                                       optional: true,
+                                       type: String,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :wipe_data,
+                                       description: "If true, wipes the emulator data before opening.",
+                                       type: Boolean,
+                                       default_value: true),
+          FastlaneCore::ConfigItem.new(key: :dns_server,
+                                       description: "Optional DNS server address for Android emulators (e.g., 8.8.8.8). Ignored for iOS.",
+                                       optional: true,
+                                       type: String,
+                                       default_value: "")
+        ].compact
+      end
+
+      def self.description
+        "Opens the specified emulators or all emulators defined in the Annai test spec file."
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :android].include?(platform)
+      end
+
+      def self.example_code
+        'annai_open_emulators(
+          platform: :android,
+          emulator: "Pixel_5_API_30",
+          wipe_data: true,
+          dns_server: "8.8.8.8"
+        )'
+      end
+    end
+
+    # ----------------------------------------------------
+    # AnnaiCloseEmulatorsAction
+    # ----------------------------------------------------
+    class AnnaiCloseEmulatorsAction < Action
+
+      def self.run(params)
+        platform = params[:platform]
+        UI.header("Starting Annai Close Emulators for #{platform}")
+
+        # 1. Determine the necessary paths and managers
+        root_folder = FastlaneFlutterFlavor::ProjectUtil.find_flutter_root
+
+        # Resolve the test spec file path
+        test_spec_file_input = params[:test_spec_file]
+        resolved_test_spec_path = FastlaneFlutterFlavor::ProjectUtil.find_annai_test_spec_path(test_spec_file_input)
+
+        # Status Manager is required by IntegrationTest's constructor
+        status_manager = FastlaneFlutterFlavor::StatusManager.new(lane: self)
+
+        # 2. Instantiate IntegrationTest helper
+        integration_test = FastlaneFlutterFlavor::IntegrationTest.new(
+          lane: self,
+          isAndroid: platform == :android,
+          isIos: platform == :ios,
+          test_spec_file: resolved_test_spec_path,
+          statusManager: status_manager,
+          root_folder: root_folder
+        )
+
+        # 3. Call the closeEmulators method
+        integration_test.closeEmulators(
+          options: {
+            emulator: params[:emulator]
+          }
+        )
+
+        UI.success("✅ Emulator(s) shut down successfully for #{platform}.")
+      end
+
+      # ----------------------------------------------------
+      # Define Parameters
+      # ----------------------------------------------------
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :platform,
+                                       description: "The platform (:ios or :android)",
+                                       is_string: false,
+                                       verify_block: proc do |value|
+                                          UI.user_error!("Platform must be :ios or :android") unless [:ios, :android].include?(value)
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :test_spec_file,
+                                       description: "Path to the annai test spec configuration file (relative to flutter root). Defaults to standard discovery",
+                                       optional: true,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :emulator,
+                                       description: "The specific emulator/device name (as defined in the test spec) to close. If nil, all defined emulators for the platform will be closed.",
+                                       optional: true,
+                                       type: String,
+                                       default_value: nil)
+        ].compact
+      end
+
+      def self.description
+        "Closes the specified emulators or all emulators defined in the Annai test spec file."
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :android].include?(platform)
+      end
+
+      def self.example_code
+        'annai_close_emulators(
+          platform: :android,
+          emulator: "Pixel_5_API_30"
+        )'
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/ann_flutter_flavor/actions/ann_run_tests_action.rb

@@ -0,0 +1,128 @@
+require 'fastlane/action'
+
+require 'fastlane/plugin/ann_flutter_flavor/helper/test_integration'
+require 'fastlane/plugin/ann_flutter_flavor/helper/utils_status'
+require 'fastlane/plugin/ann_flutter_flavor/helper/utils_project_config'
+
+
+module Fastlane
+  module Actions
+    class AnnaiRunTestsAction < Action
+
+      def self.run(params)
+        platform = params[:platform]
+
+        # 1. Determine the necessary paths and managers
+        root_folder = FastlaneFlutterFlavor::ProjectUtil.find_flutter_root
+
+        # Resolve the test spec file path, respecting user input precedence:
+        # User Parameter > Environment Variable > Default Path
+        test_spec_file_input = params[:test_spec_file]
+        resolved_test_spec_path = FastlaneFlutterFlavor::ProjectUtil.find_annai_test_spec_path(test_spec_file_input)
+
+        # Status Manager is required by IntegrationTest's constructor, though not strictly needed for open/close
+        status_manager = FastlaneFlutterFlavor::StatusManager.new(lane: self)
+
+        # 2. Instantiate IntegrationTest directly
+        integration_test = FastlaneFlutterFlavor::IntegrationTest.new(
+          lane: self,
+          isAndroid: platform == :android,
+          isIos: platform == :ios,
+          test_spec_file: resolved_test_spec_path,
+          statusManager: status_manager,
+          root_folder: root_folder
+        )
+
+        UI.header("Running tests using IntegrationTest directly for #{platform}")
+
+        # 3. Call the runTests method
+        integration_test.runTests(
+          flavor: params[:flavor],
+          emulator: params[:emulator],
+          open_emulator: params[:open_emulator],
+          close_emulator: params[:close_emulator],
+          wipe_data: params[:wipe_data],
+          skip_screenshots: params[:skip_screenshots],
+          skip_sound_null_safety: params[:skip_sound_null_safety]
+        )
+
+        UI.success("✅ Test execution completed for #{platform}. Check logs for results.")
+
+        # 4. Finalize status reporting
+        status_manager.displayStatus
+      end
+
+      # ----------------------------------------------------
+      # Define Parameters
+      # ----------------------------------------------------
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :platform,
+                                       description: "The platform (:ios or :android)",
+                                       is_string: false,
+                                       verify_block: proc do |value|
+                                          UI.user_error!("Platform must be :ios or :android") unless [:ios, :android].include?(value)
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :test_spec_file,
+                                       description: "Path to the annai test spec configuration file (relative to flutter root). Defaults to standard discovery",
+                                       optional: true,
+                                       default_value: nil),
+
+          # --- Filtering Options (Matches IntegrationTest logic) ---
+          FastlaneCore::ConfigItem.new(key: :flavor,
+                                       description: "The flavor(s) to run tests against (comma-separated list, e.g., 'free,pro'). If nil, all flavors are tested",
+                                       optional: true,
+                                       type: String,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :emulator,
+                                       description: "The specific emulator/device name (as defined in the test spec) to run tests on. If nil, tests run on all defined emulators for the given flavor(s)",
+                                       optional: true,
+                                       type: String,
+                                       default_value: nil),
+
+          # --- Emulator Control ---
+          FastlaneCore::ConfigItem.new(key: :open_emulator,
+                                       description: "If true, opens the target emulator before running tests",
+                                       type: Boolean,
+                                       default_value: true),
+          FastlaneCore::ConfigItem.new(key: :close_emulator,
+                                       description: "If true, closes the target emulator after running tests",
+                                       type: Boolean,
+                                       default_value: true),
+          FastlaneCore::ConfigItem.new(key: :wipe_data,
+                                       description: "If true, wipes the emulator data before opening",
+                                       type: Boolean,
+                                       default_value: true),
+
+          # --- Test Execution Control ---
+          FastlaneCore::ConfigItem.new(key: :skip_screenshots,
+                                       description: "If true, uses 'flutter test' instead of 'flutter drive' (skips screenshots). Overrides the spec file setting",
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :skip_sound_null_safety,
+                                       description: "If true, adds --no-sound-null-safety flag to the flutter command",
+                                       type: Boolean,
+                                       default_value: false)
+        ].compact
+      end
+
+      def self.description
+        "Runs specified integration tests on target devices using configurations defined within the Annai test spec file"
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :android].include?(platform)
+      end
+
+      def self.example_code
+        'ann_run_tests(
+          platform: :android,
+          test_spec_file: "../config/my_custom_specs.yaml" # Custom path
+          emulator: "Pixel_5_API_30",
+          flavor: "development",
+          skip_screenshots: false
+        )'
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/ann_flutter_flavor/actions/ann_setup_action.rb

@@ -0,0 +1,137 @@
+require 'fastlane/action'
+
+require 'fastlane/plugin/ann_flutter_flavor/helper/utils_status'
+require 'fastlane/plugin/ann_flutter_flavor/helper/utils_project_config'
+require 'fastlane/plugin/ann_flutter_flavor/helper/lanes_setup'
+
+
+module Fastlane
+  module Actions
+    # =========================================================================
+    # AnnaiUpgradeSetupAction: Runs comprehensive setup and maintenance
+    # =========================================================================
+
+    class AnnaiUpgradeSetupAction < Action
+      def self.run(params)
+
+        # 1. Determine the necessary paths and managers
+        root_folder = FastlaneFlutterFlavor::ProjectUtil.find_flutter_root
+        status_manager = FastlaneFlutterFlavor::StatusManager.new(lane: self)
+
+        # 2. Instantiate SetupLanes directly
+        setup_lanes = FastlaneFlutterFlavor::SetupLanes.new(
+          root_folder: root_folder,
+          status_manager: status_manager,
+        )
+
+        Fastlane::UI.message("Starting comprehensive setup and maintenance (Force: #{params[:force]})...")
+
+        # 3. Execute the maintenance routine
+        setup_lanes.upgrade_setup(force: params[:force])
+
+        Fastlane::UI.success("✅ Upgrade setup completed successfully.")
+
+        # 4. Finalize status reporting
+        status_manager.displayStatus
+      rescue => e
+        # Log the error using the StatusManager instance
+        if status_manager
+          # Pass 'self' (the class) as the lane context for consistency
+          status_manager.logError(self, 'annai_upgrade_setup', nil, e)
+          status_manager.displayStatus
+        end
+
+        raise "AnnaiUpgradeSetupAction failed: #{e.message}"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :force,
+                                       description: "Force the execution even if conditions might advise skipping",
+                                       optional: true,
+                                       is_string: false,
+                                       default_value: false,
+                                       type: Boolean)
+        ]
+      end
+
+      def self.description
+        "Runs comprehensive Flutter and Fastlane maintenance (upgrade, doctor, bundle update, gem install)."
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.example_code
+        [
+          'annai_upgrade_setup',
+          'annai_upgrade_setup(force: true)'
+        ]
+      end
+    end
+
+    # =========================================================================
+    # AnnaiCleanupAction: Cleans up all local build artifacts
+    # =========================================================================
+
+    class AnnaiCleanupAction < Action
+      def self.run(params)
+
+        # 1. Determine the necessary paths and managers
+        root_folder = FastlaneFlutterFlavor::ProjectUtil.find_flutter_root
+        status_manager = FastlaneFlutterFlavor::StatusManager.new(lane: self)
+
+        # 2. Instantiate SetupLanes directly
+        setup_lanes = FastlaneFlutterFlavor::SetupLanes.new(
+          root_folder: root_folder,
+          status_manager: status_manager,
+        )
+
+        Fastlane::UI.message("Starting full build artifact cleanup (Force: #{params[:force]})...")
+
+        # 3. Execute the cleanup routine
+        setup_lanes.cleanup(force: params[:force])
+
+        Fastlane::UI.success("✅ Build artifact cleanup completed successfully.")
+
+        # 4. Finalize status reporting
+        status_manager.displayStatus
+      rescue => e
+        # Log the error using the StatusManager instance
+        if status_manager
+          # Pass 'self' (the class) as the lane context for consistency
+          status_manager.logError(self, 'annai_cleanup', nil, e)
+          status_manager.displayStatus
+        end
+        raise "AnnaiCleanupAction failed: #{e.message}"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :force,
+                                       description: "Force the execution even if conditions might advise skipping",
+                                       optional: true,
+                                       is_string: false,
+                                       default_value: false,
+                                       type: Boolean)
+        ]
+      end
+
+      def self.description
+        "Performs full build artifact cleanup (runs 'flutter clean' and deletes platform build folders)."
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.example_code
+        [
+          'annai_cleanup',
+          'annai_cleanup(force: true)',
+        ]
+      end
+    end
+  end
+end