ann-flutter-flavor 0.1.2

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

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

@@ -0,0 +1,280 @@
+require 'fastlane/action'
+require 'fastlane/plugin/ann_flutter_flavor/helper/lanes_annai'
+require 'fastlane/plugin/ann_flutter_flavor/helper/utils_spec_loader'
+
+module Fastlane
+  module Actions
+    # This class name dictates the action name 'ann_upload_to_app_store'
+    class AnnaiUploadToAppStoreAction < Action
+
+      def self.run(params)
+        platform = :ios # Hardcoded platform
+        action_name = "ann_upload_to_app_store"
+        requested_flavor = params[:flavor]
+        requested_clean_build = params[:clean]
+        spec_file = params[:spec_file]
+
+        # 1. Initialize AnnaiLanes
+        annai_lanes = FastlaneFlutterFlavor::AnnaiLanes.new(
+          lane: self,
+          platform: platform, # Pass platform symbol directly
+          spec_file: spec_file # Pass optional spec_file
+        )
+
+        status_manager = annai_lanes.instance_variable_get(:@statusManager)
+        spec_loader = annai_lanes.instance_variable_get(:@specLoader)
+        UI.user_error!("Internal Error: AnnaiLanes failed to initialize specLoader") unless spec_loader
+
+        any_upload_failed = false
+
+        # 2. Perform clean build if requested
+        if requested_clean_build
+            UI.header("🧹 Cleaning builds as requested...")
+            begin
+              annai_lanes.clean_build
+            rescue => e
+              UI.error("Failed to perform clean build: #{e.message}. Attempting to proceed with upload")
+              # Note: Using 'annai_clean_build' as the action name for the failure log
+              status_manager.logError("All", "annai_clean_build", platform, "Clean build failed: #{e.message}")
+            end
+        end
+
+        # 3. Get the list of all flavors defined for the platform
+        flavors_hash = spec_loader.get_platform_flavors(platform)
+
+        if flavors_hash.empty?
+          UI.important("No flavors found for iOS in the Annai spec. Nothing to upload")
+          annai_lanes.finalize
+          return
+        end
+
+        all_flavor_names = flavors_hash.keys
+
+        # 4. Determine which flavors to upload
+        if requested_flavor && !requested_flavor.to_s.empty?
+            requested_flavors = requested_flavor.to_s.split(',').map(&:strip).reject(&:empty?)
+
+            # Validate all requested flavors
+            invalid_flavors = requested_flavors.reject { |f| all_flavor_names.include?(f) }
+
+            if invalid_flavors.any?
+                UI.user_error!("The following requested flavor(s) are not found in the Annai spec for IOS: #{invalid_flavors.join(', ')}. Available flavors: #{all_flavor_names.join(', ')}")
+            end
+
+            flavors_to_upload = requested_flavors
+        else
+            flavors_to_upload = all_flavor_names
+        end
+
+        UI.header("Starting App Store upload. Flavors to process: #{flavors_to_upload.join(', ')}")
+
+        # 5. Loop through each flavor and upload
+        flavors_to_upload.each do |flavor_key|
+
+          flavor = flavor_key.to_s
+
+          # Get values, prioritizing spec over parameters
+          final_main_file = spec_loader.get_main_file(platform, flavor) || params[:main_file]
+          final_api_key_path = spec_loader.get_api_key_path(platform, flavor) || params[:api_key_path]
+          final_package_name = spec_loader.get_package_id(platform, flavor) || params[:bundle_identifier]
+          final_export_option_file = spec_loader.get_export_option_file(platform, flavor) || params[:export_option_file]
+          final_display_name = spec_loader.get_display_name(platform, flavor) || params[:display_name]
+          final_team_id = spec_loader.get_team_id(platform, flavor) || params[:team_id]
+          final_app_version = spec_loader.get_version_name(platform, flavor) || params[:app_version]
+          final_build_number = spec_loader.get_version_code(platform, flavor) || params[:build_number]
+
+          UI.message("🚀 Preparing **#{flavor}** flavor...")
+
+          # Use 'upload_to_store' as the consistent action name for flavor-specific failures
+          flavor_action_name = "upload_to_store"
+
+          begin
+            # iOS Upload Logic (upload_to_app_store)
+            success = annai_lanes.upload_to_app_store(
+              bundle_identifier: final_package_name, # Use package name from spec for bundle ID
+              api_key_path: final_api_key_path,
+              flavor: flavor,
+              main_file: final_main_file,
+              display_name: final_display_name,
+              export_option_file: final_export_option_file,
+              team_id: final_team_id,
+              signing_certificate: params[:signing_certificate],
+              app_version: final_app_version,
+              build_number: final_build_number,
+              skip_sound_null_safety: params[:skip_sound_null_safety],
+              skip_compile: params[:skip_compile],
+              skip_upload_binary: params[:skip_upload_binary],
+              skip_upload_prod: params[:skip_upload_prod],
+              skip_upload_metadata: params[:skip_upload_metadata],
+              skip_upload_screenshots: params[:skip_upload_screenshots],
+              export_compliance_uses_encryption: params[:export_compliance_uses_encryption],
+              add_id_info_uses_idfa: params[:add_id_info_uses_idfa],
+              platform: platform.to_s,
+              metadata_path: params[:metadata_path],
+              screenshots_path: params[:screenshots_path],
+              distribution_platform: params[:distribution_platform],
+            )
+
+            if success
+              UI.success("✅ Successfully uploaded flavor: #{flavor}")
+            else
+              # If upload_to_app_store returns false (meaning it caught an error and logged it), flag the overall failure.
+              # We only raise/log here if the inner action didn't handle it, to ensure logging consistency.
+              if !status_manager.instance_variable_get(:@status).key?([flavor, flavor_action_name, platform.to_s])
+                raise "Upload failed for flavor '#{flavor}'"
+              else
+                raise "Upload failed for flavor '#{flavor}' (error logged previously)"
+              end
+            end
+
+          rescue => e
+            # Failure handling: Log the error and continue
+            if !status_manager.instance_variable_get(:@status).key?([flavor, flavor_action_name, platform.to_s])
+              status_manager.logError(flavor, flavor_action_name, platform, e.message)
+            end
+
+            UI.error("❌ Failed to upload flavor: #{flavor}. Continuing to next flavor...")
+            any_upload_failed = true
+            # Continue to the next flavor
+          end
+        end
+
+        # 6. Final Reporting and Status Check
+        annai_lanes.finalize
+
+        if any_upload_failed
+            UI.user_error!("Upload failed for one or more flavors. See the Annai Fastlane summary above")
+        else
+            UI.success("🎉 Successfully uploaded all #{flavors_to_upload.count} requested flavor(s) to the App Store!")
+        end
+      end
+
+      # ----------------------------------------------------
+      # Define Parameters
+      # ----------------------------------------------------
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :flavor,
+                                       description: "The specific flavor(s) to upload (comma-separated). If nil, all flavors are uploaded",
+                                       optional: true,
+                                       default_value: nil),
+
+          FastlaneCore::ConfigItem.new(key: :spec_file,
+                                       description: "Path to the annai spec configuration file (relative to flutter root). Defaults to standard discovery",
+                                       optional: true,
+                                       default_value: nil),
+
+          FastlaneCore::ConfigItem.new(key: :clean,
+                                       description: "If true, runs annai_clean_build before uploading (and compiling if not skipped)",
+                                       type: Boolean,
+                                       default_value: false),
+
+          FastlaneCore::ConfigItem.new(key: :distribution_platform,
+                                       description: "The distribution platform (e.g., 'ios' or 'app_store_connect') for App Store uploads",
+                                       optional: true,
+                                       default_value: "ios"),
+
+          # --- Common & iOS Specific Parameters ---
+          FastlaneCore::ConfigItem.new(key: :api_key_path,
+                                       description: "Path to the App Store Connect API Key JSON file (iOS)",
+                                       optional: true,
+                                       type: String),
+          FastlaneCore::ConfigItem.new(key: :main_file,
+                                       description: "Path to the main dart file (used if compilation is required)",
+                                       default_value: "lib/main.dart"),
+          FastlaneCore::ConfigItem.new(key: :skip_compile,
+                                       description: "If true, skips the compilation step and assumes artifacts already exist",
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :skip_sound_null_safety,
+                                       description: "Skips sound null safety checks during compilation (if skip_compile is false)",
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :skip_upload_prod,
+                                       description: "If true, skips uploading to the production track/stage",
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :skip_upload_binary,
+                                       description: "If true, skips uploading the binary (.ipa)",
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :skip_upload_metadata,
+                                       description: "If true, skips uploading store metadata (description, title, etc.)",
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :skip_upload_screenshots,
+                                       description: "If true, skips uploading screenshots and app previews",
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :metadata_path,
+                                       description: "The path to the localized store metadata (e.g., fastlane/metadata/ios)",
+                                       optional: true,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :screenshots_path,
+                                       description: "The path to the screenshots and app previews",
+                                       optional: true,
+                                       default_value: nil),
+
+          FastlaneCore::ConfigItem.new(key: :bundle_identifier,
+                                       description: "The bundle identifier (iOS)",
+                                       optional: true,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :display_name,
+                                       description: "The display name of the app (used for IPA filename)",
+                                       optional: true,
+                                       default_value: "App"),
+          FastlaneCore::ConfigItem.new(key: :export_option_file,
+                                       description: "Path to export options plist",
+                                       optional: true,
+                                       default_value: ""),
+          FastlaneCore::ConfigItem.new(key: :team_id,
+                                       description: "Apple Developer Team ID",
+                                       optional: true,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :signing_certificate,
+                                       description: "Code signing certificate name",
+                                       optional: true,
+                                       default_value: "iPhone Distribution"),
+          FastlaneCore::ConfigItem.new(key: :app_version,
+                                       description: "The app version number",
+                                       optional: true,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :build_number,
+                                       description: "The build number",
+                                       optional: true,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :export_compliance_uses_encryption,
+                                       description: "Whether the app uses encryption",
+                                       optional: true,
+                                       type: Boolean,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :add_id_info_uses_idfa,
+                                       description: "Whether the app uses IDFA",
+                                       optional: true,
+                                       type: Boolean,
+                                       default_value: nil),
+        ].compact
+      end
+
+      def self.description
+        "Handles compilation (optional) and uploading of one or all flavors to the Apple App Store"
+      end
+
+      def self.is_supported?(platform)
+        platform == :ios
+      end
+
+      def self.example_code
+        'ann_upload_to_app_store(
+          flavor: "production",
+          spec_file: "config/annai_config.yaml", # Optional custom spec path
+          api_key_path: "./api_keys/asc.json",
+          bundle_identifier: "com.example.app",
+          team_id: "ABCDEFG",
+          clean: true,
+          skip_compile: false
+        )'
+      end
+    end
+  end
+end

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

@@ -0,0 +1,199 @@
+require 'fastlane/action'
+require 'fastlane/plugin/ann_flutter_flavor/helper/lanes_annai'
+require 'fastlane/plugin/ann_flutter_flavor/helper/utils_spec_loader'
+
+module Fastlane
+  module Actions
+    # This class name dictates the action name 'ann_upload_to_firebase'
+    class AnnaiUploadToFirebaseAction < Action
+
+      def self.run(params)
+        platform = :web # Hardcoded platform for web hosting
+        action_name = "ann_upload_to_firebase"
+        requested_flavor = params[:flavor]
+        requested_clean_build = params[:clean]
+        spec_file = params[:spec_file]
+
+        # 1. Initialize AnnaiLanes
+        annai_lanes = FastlaneFlutterFlavor::AnnaiLanes.new(
+          lane: self,
+          platform: platform, # Pass platform symbol directly
+          spec_file: spec_file # Pass optional spec_file
+        )
+
+        status_manager = annai_lanes.instance_variable_get(:@statusManager)
+        spec_loader = annai_lanes.instance_variable_get(:@specLoader)
+        UI.user_error!("Internal Error: AnnaiLanes failed to initialize specLoader") unless spec_loader
+
+        any_upload_failed = false
+
+        # 2. Perform clean build if requested
+        if requested_clean_build
+            UI.header("🧹 Cleaning builds as requested...")
+            begin
+              annai_lanes.clean_build
+            rescue => e
+              UI.error("Failed to perform clean build: #{e.message}. Attempting to proceed with upload")
+              # Note: Using 'annai_clean_build' as the action name for the failure log
+              status_manager.logError("All", "annai_clean_build", platform, "Clean build failed: #{e.message}")
+            end
+        end
+
+        # 3. Get the list of all flavors defined for the platform
+        flavors_hash = spec_loader.get_platform_flavors(platform)
+
+        if flavors_hash.empty?
+          UI.important("No flavors found for Web in the Annai spec. Nothing to upload")
+          annai_lanes.finalize
+          return
+        end
+
+        all_flavor_names = flavors_hash.keys
+
+        # 4. Determine which flavors to upload
+        if requested_flavor && !requested_flavor.to_s.empty?
+            requested_flavors = requested_flavor.to_s.split(',').map(&:strip).reject(&:empty?)
+
+            # Validate all requested flavors
+            invalid_flavors = requested_flavors.reject { |f| all_flavor_names.include?(f) }
+
+            if invalid_flavors.any?
+                UI.user_error!("The following requested flavor(s) are not found in the Annai spec for Web: #{invalid_flavors.join(', ')}. Available flavors: #{all_flavor_names.join(', ')}")
+            end
+
+            flavors_to_upload = requested_flavors
+        else
+            flavors_to_upload = all_flavor_names
+        end
+
+        UI.header("Starting Firebase Hosting upload. Flavors to process: #{flavors_to_upload.join(', ')}")
+
+
+        # 5. Loop through each flavor and upload
+        flavors_to_upload.each do |flavor_key|
+
+          flavor = flavor_key.to_s
+
+          # Get values from spec, falling back to parameters
+          # Note: firebase_project is intentionally NOT loaded from spec here,
+          # as it's passed directly to AnnaiLanes which handles the prioritization
+          # (CLI param > Spec file).
+          final_main_file = spec_loader.get_main_file(platform, flavor) || params[:main_file]
+
+          UI.message("🚀 Preparing **#{flavor}** flavor...")
+
+          # Use 'upload_to_firebase' as the consistent action name for flavor-specific failures
+          flavor_action_name = "upload_to_firebase"
+
+          begin
+            # Web Upload Logic (upload_to_firebase)
+            success = annai_lanes.upload_to_firebase(
+              flavor: flavor,
+              main_file: final_main_file,
+              build_config: params[:build_config],
+              skip_compile: params[:skip_compile],
+              skip_sound_null_safety: params[:skip_sound_null_safety],
+              firebase_project: params[:firebase_project],
+              firebase_token: params[:firebase_token] || ENV["FIREBASE_TOKEN"],
+            )
+
+            if success
+              UI.success("✅ Successfully deployed flavor: #{flavor}")
+            else
+              # If upload_to_firebase returns false, flag the overall failure.
+              if !status_manager.instance_variable_get(:@status).key?([flavor, flavor_action_name, platform.to_s])
+                raise "Deployment failed for flavor '#{flavor}'"
+              else
+                raise "Deployment failed for flavor '#{flavor}' (error logged previously)"
+              end
+            end
+
+          rescue => e
+            # Failure handling: Log the error and continue
+            if !status_manager.instance_variable_get(:@status).key?([flavor, flavor_action_name, platform.to_s])
+              status_manager.logError(flavor, flavor_action_name, platform, e.message)
+            end
+
+            UI.error("❌ Failed to deploy flavor: #{flavor}. Continuing to next flavor...")
+            any_upload_failed = true
+            # Continue to the next flavor
+          end
+        end
+
+        # 6. Final Reporting and Status Check
+        annai_lanes.finalize
+
+        if any_upload_failed
+            UI.user_error!("Deployment failed for one or more flavors. See the Annai Fastlane summary above")
+        else
+            UI.success("🎉 Successfully deployed all #{flavors_to_upload.count} requested flavor(s) to Firebase Hosting!")
+        end
+      end
+
+      # ----------------------------------------------------
+      # Define Parameters
+      # ----------------------------------------------------
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :flavor,
+                                       description: "The specific flavor(s) to deploy (comma-separated). If nil, all Web flavors are deployed",
+                                       optional: true,
+                                       default_value: nil),
+
+          FastlaneCore::ConfigItem.new(key: :spec_file,
+                                       description: "Path to the annai spec configuration file (relative to flutter root). Defaults to standard discovery",
+                                       optional: true,
+                                       default_value: nil),
+
+          FastlaneCore::ConfigItem.new(key: :clean,
+                                       description: "If true, runs annai_clean_build before deploying (and compiling if not skipped)",
+                                       type: Boolean,
+                                       default_value: false),
+
+          # --- Web / Firebase Specific Parameters ---
+          FastlaneCore::ConfigItem.new(key: :firebase_token,
+                                       description: "Firebase CLI CI token for authentication (generated via 'firebase login:ci')",
+                                       optional: true,
+                                       env_name: "FIREBASE_TOKEN",
+                                       type: String),
+          FastlaneCore::ConfigItem.new(key: :firebase_project,
+                                       description: "The Firebase Project ID to deploy to. This value overrides the 'project_id' in the annai spec file",
+                                       optional: true,
+                                       type: String),
+          FastlaneCore::ConfigItem.new(key: :main_file,
+                                       description: "Path to the main dart file (used if compilation is required)",
+                                       default_value: "lib/main.dart"),
+          FastlaneCore::ConfigItem.new(key: :build_config,
+                                       description: "The Flutter build configuration ('release', 'profile', or 'debug')",
+                                       optional: true,
+                                       default_value: "release"),
+          FastlaneCore::ConfigItem.new(key: :skip_compile,
+                                       description: "If true, skips the compilation step ('flutter build web') and assumes artifacts already exist",
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :skip_sound_null_safety,
+                                       description: "Skips sound null safety checks during compilation (if skip_compile is false)",
+                                       type: Boolean,
+                                       default_value: false),
+        ].compact
+      end
+
+      def self.description
+        "Handles compilation (optional) and deployment of one or all Web flavors to Firebase Hosting"
+      end
+
+      def self.is_supported?(platform)
+        platform == :web
+      end
+
+      def self.example_code
+        'ann_upload_to_firebase(
+          flavor: "staging,production",
+          firebase_project: "my-custom-staging-project", # Overrides spec file
+          build_config: "release",
+          skip_compile: false
+        )'
+      end
+    end
+  end
+end