ann-flutter-flavor 0.1.6

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

@@ -0,0 +1,219 @@
+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
+    class AnnaiCompileBuildAction < Action
+
+      def self.run(params)
+        platform = params[:platform]
+        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
+        )
+
+        # Get the StatusManager instance for logging errors explicitly
+        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
+
+        # Flag to track if any flavor compilation failed
+        any_build_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 compilation.")
+              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 platform '#{platform}' in the Annai spec. Nothing to build.")
+          annai_lanes.finalize
+          return
+        end
+
+        all_flavor_names = flavors_hash.keys
+
+        # 4. Determine which flavors to build
+        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 platform '#{platform}': #{invalid_flavors.join(', ')}. Available flavors: #{all_flavor_names.join(', ')}")
+            end
+
+            flavors_to_build = requested_flavors
+
+        else
+            # No specific flavor requested, build all of them
+            flavors_to_build = all_flavor_names
+        end
+
+        UI.header("Starting build for #{platform}. Flavors to compile: #{flavors_to_build.join(', ')}")
+
+
+        # 5. Loop through each flavor and directly call compile_build on AnnaiLanes
+        flavors_to_build.each do |flavor_key|
+
+          flavor = flavor_key.to_s
+
+          # Use the new getter, which uses the internal spec data
+          flavor_main_file = spec_loader.get_main_file(platform, flavor)
+
+          # Use the main_file provided by the user as a fallback if the spec doesn't define one
+          final_main_file = flavor_main_file || params[:main_file]
+
+          if final_main_file.nil? || final_main_file.empty?
+            error_msg = "Could not determine 'main_file' for flavor '#{flavor}' on platform '#{platform}'. Check your Annai spec or provide a default 'main_file'."
+            UI.error("❌ #{error_msg}")
+            status_manager.logError(flavor, "ann_compile_build_all", platform, error_msg)
+            any_build_failed = true
+            next
+          end
+
+          UI.message("⚙️ Compiling **#{flavor}** flavor using main file: #{final_main_file}...")
+
+          begin
+            # CRITICAL: Direct call to the AnnaiLanes helper method
+            success = annai_lanes.compile_build(
+              flavor: flavor,
+              sub_command: params[:sub_command],
+              build_config: params[:build_config],
+              main_file: final_main_file,
+              skip_sound_null_safety: params[:skip_sound_null_safety],
+              skip_code_sign: params[:skip_code_sign],
+              export_options_plist: params[:export_options_plist],
+              additional_parameter: params[:additional_parameter],
+              platform: platform.to_s # Ensure platform is passed as a string/symbol as expected by the helper
+            )
+
+            if success
+              UI.success("🎉 Successfully compiled flavor: #{flavor}")
+            else
+              # If compile_build returns false (meaning it caught an error and logged it), flag the overall failure.
+              raise "Compilation failed for flavor '#{flavor}' (error logged previously)."
+            end
+          rescue => e
+            # Failure handling: Log the error using StatusManager (if not already logged by compile_build) and continue
+            if !status_manager.instance_variable_get(:@status).key?([flavor, "compile_build", platform.to_s])
+              status_manager.logError(flavor, "ann_compile_build_all", platform, e.message)
+            end
+
+            UI.error("❌ Failed to compile flavor: #{flavor}. Continuing to next flavor...")
+            any_build_failed = true
+            # Continue to the next flavor
+          end
+        end
+
+        # 6. Final Reporting and Status Check
+        # Finalize calls statusManager.displayStatus to show the comprehensive report
+        annai_lanes.finalize
+
+        if any_build_failed
+            # If any build failed, we stop the lane with an error after the summary is displayed.
+            UI.user_error!("Compilation failed for one or more flavors. See the Annai Fastlane summary above.")
+        else
+            UI.success("✅ Successfully compiled all #{flavors_to_build.count} requested flavor(s) for #{platform}!")
+        end
+      end
+
+      # ----------------------------------------------------
+      # Define Parameters
+      # ----------------------------------------------------
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :platform,
+                                       description: "The platform (:ios, :android, or :web)",
+                                       is_string: false,
+                                       verify_block: proc do |value|
+                                          UI.user_error!("Platform must be :ios, :android, or :web") unless [:ios, :android, :web].include?(value)
+                                       end),
+
+          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 compiling all flavors",
+                                       type: Boolean,
+                                       default_value: false),
+
+          FastlaneCore::ConfigItem.new(key: :flavor,
+                                       description: "The specific flavor(s) to build (comma-separated). If nil, all flavors are built",
+                                       optional: true,
+                                       default_value: nil),
+
+          # All following options are passed directly to the single build action
+          FastlaneCore::ConfigItem.new(key: :sub_command,
+                                       description: "Flutter build subcommand (e.g., appbundle, ipa, web) to use for all flavors",
+                                       # Note: If platform is :web, this should typically be 'web' or similar.
+                                       default_value: "appbundle"),
+          FastlaneCore::ConfigItem.new(key: :build_config,
+                                       description: "Build configuration (e.g., debug, profile, release) to use for all flavors",
+                                       default_value: "release"),
+          FastlaneCore::ConfigItem.new(key: :main_file,
+                                       description: "Path to the main dart file (used as default for all flavors unless overridden in the Annai spec)",
+                                       default_value: "lib/main.dart"),
+          FastlaneCore::ConfigItem.new(key: :skip_sound_null_safety,
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :skip_code_sign,
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :export_options_plist,
+                                       description: "Path to export options plist (iOS only)",
+                                       optional: true,
+                                       default_value: ""),
+          FastlaneCore::ConfigItem.new(key: :additional_parameter,
+                                       description: "Additional flutter build parameters",
+                                       optional: true,
+                                       default_value: ""),
+        ]
+      end
+
+      def self.description
+        "Compiles all defined Flutter flavors for a single platform (:ios, :android, or :web) using the Annai spec configuration"
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :android, :web].include?(platform)
+      end
+
+      def self.example_code
+        'ann_compile_build_all(
+          platform: :android,
+          spec_file: "config/my_annai.yaml", # Optional custom spec path
+          build_config: "release",
+          clean: true,
+          flavor: "staging,production" # Optional comma-separated list
+        )
+        ann_compile_build_all(
+          platform: :web,
+          sub_command: "web", # Specify the web subcommand
+          build_config: "release",
+          flavor: "test_web"
+        )'
+      end
+    end
+  end
+end

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

@@ -0,0 +1,183 @@
+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_download_from_app_store'
+    class AnnaiDownloadFromAppStoreAction < Action
+
+      def self.run(params)
+        # Platform is hardcoded to :ios
+        platform = :ios
+        action_name = "ann_download_from_app_store"
+        requested_flavor = params[:flavor]
+        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
+        )
+
+        # Get the StatusManager and SpecLoader instances
+        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
+
+        # Flag to track if any flavor download failed
+        any_download_failed = false
+
+        # 2. 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 download")
+          annai_lanes.finalize
+          return
+        end
+
+        all_flavor_names = flavors_hash.keys
+
+        # 3. Determine which flavors to download
+        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_download = requested_flavors
+        else
+            # No specific flavor requested, download all of them
+            flavors_to_download = all_flavor_names
+        end
+
+        UI.header("Starting App Store download. Flavors to process: #{flavors_to_download.join(', ')}")
+
+        # 4. Loop through each flavor and download
+        flavors_to_download.each do |flavor_key|
+
+          flavor = flavor_key
+
+          # spec_loader.get_package_id handles the bundle_identifier
+          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[:package_name]
+
+          UI.message("⬇️ Downloading store content for **#{flavor}** flavor...")
+
+          begin
+            success = annai_lanes.download_from_store(
+              package_name: final_package_name,
+              api_key_path: final_api_key_path,
+              flavor: flavor,
+              platform: platform.to_s,
+              use_live_version: params[:use_live_version],
+              metadata_path: params[:metadata_path],
+              screenshots_path: params[:screenshots_path],
+              distribution_platform: params[:distribution_platform],
+            )
+
+            if success
+              UI.success("✅ Successfully downloaded app store content for flavor: #{flavor}")
+            else
+              # If download_from_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, "download_from_store", platform.to_s])
+                raise "Download failed for flavor '#{flavor}'"
+              else
+                raise "Download failed for flavor '#{flavor}' (error logged previously)"
+              end
+            end
+
+          rescue => e
+            # Failure handling: Log the error and continue
+            status_manager.logError(flavor, action_name, platform, e.message) unless status_manager.instance_variable_get(:@status).key?([flavor, "download_from_store", platform.to_s])
+
+            UI.error("❌ Failed to download content for flavor: #{flavor}. Continuing to next flavor...")
+            any_download_failed = true
+            # Continue to the next flavor
+          end
+        end
+
+        # 5. Final Reporting and Status Check
+        annai_lanes.finalize
+
+        if any_download_failed
+            UI.user_error!("Download failed for one or more flavors. See the Annai Fastlane summary above")
+        else
+            UI.success("🎉 Successfully downloaded App Store content for all #{flavors_to_download.count} requested flavor(s)!")
+        end
+      end
+
+      # ----------------------------------------------------
+      # Define Parameters
+      # ----------------------------------------------------
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :flavor,
+                                       description: "The specific flavor(s) to download (comma-separated). If nil, all flavors are processed",
+                                       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: :api_key_path,
+                                       description: "Path to the App Store Connect API Key JSON file (iOS). Optional if defined in the Annai spec",
+                                       optional: true,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :package_name,
+                                       description: "The bundle identifier (iOS). Optional if defined in the Annai spec",
+                                       optional: true,
+                                       default_value: nil),
+
+          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"),
+
+          FastlaneCore::ConfigItem.new(key: :metadata_path,
+                                       description: "The path where localization metadata (e.g., descriptions, titles) should be downloaded",
+                                       optional: true,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :screenshots_path,
+                                       description: "The path where screenshots should be downloaded (iOS only)",
+                                       optional: true,
+                                       default_value: nil),
+
+          FastlaneCore::ConfigItem.new(key: :use_live_version,
+                                       description: "If true, downloads the currently published live version. If false (default), downloads the editable version (iOS only)",
+                                       optional: true,
+                                       type: Boolean,
+                                       default_value: false),
+        ].compact
+      end
+
+      def self.description
+        "Downloads store metadata, screenshots, and other assets for one or all flavors from the Apple App Store"
+      end
+
+      def self.is_supported?(platform)
+        platform == :ios
+      end
+
+      def self.example_code
+        'ann_download_from_app_store(
+          flavor: "production",
+          spec_file: "config/annai_config.yaml", # Optional custom spec path
+          api_key_path: "./api_keys/asc.json",
+          package_name: "com.example.app",
+          use_live_version: true
+        )'
+      end
+    end
+  end
+end

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

@@ -0,0 +1,168 @@
+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_download_from_play_store'
+    class AnnaiDownloadFromPlayStoreAction < Action
+
+      def self.run(params)
+        # Platform is hardcoded to :android
+        platform = :android
+        action_name = "ann_download_from_play_store"
+        requested_flavor = params[:flavor]
+        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
+        )
+
+        # Get the StatusManager and SpecLoader instances
+        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
+
+        # Flag to track if any flavor download failed
+        any_download_failed = false
+
+        # 2. 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 Android in the Annai spec. Nothing to download")
+          annai_lanes.finalize
+          return
+        end
+
+        all_flavor_names = flavors_hash.keys
+
+        # 3. Determine which flavors to download
+        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 Android: #{invalid_flavors.join(', ')}. Available flavors: #{all_flavor_names.join(', ')}")
+            end
+
+            flavors_to_download = requested_flavors
+        else
+            # No specific flavor requested, download all of them
+            flavors_to_download = all_flavor_names
+        end
+
+        UI.header("Starting Google Play download. Flavors to process: #{flavors_to_download.join(', ')}")
+
+        # 4. Loop through each flavor and download
+        flavors_to_download.each do |flavor_key|
+
+          flavor = flavor_key
+
+          # spec_loader.get_package_id handles the package_name
+          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[:package_name]
+
+          UI.message("⬇️ Downloading store content for **#{flavor}** flavor...")
+
+          begin
+            success = annai_lanes.download_from_store(
+              package_name: final_package_name,
+              api_key_path: final_api_key_path,
+              flavor: flavor,
+              platform: platform.to_s,
+              # Android only needs metadata path
+              metadata_path: params[:metadata_path],
+              screenshots_path: nil, # Omitted for Android download action
+              use_live_version: nil, # Omitted for Android download action
+              distribution_platform: nil # Omitted for Android download action
+            )
+
+            if success
+              UI.success("✅ Successfully downloaded store content for flavor: #{flavor}")
+            else
+              # If download_from_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, "download_from_store", platform.to_s])
+                raise "Download failed for flavor '#{flavor}'"
+              else
+                raise "Download failed for flavor '#{flavor}' (error logged previously)"
+              end
+            end
+
+          rescue => e
+            # Failure handling: Log the error and continue
+            status_manager.logError(flavor, action_name, platform, e.message) unless status_manager.instance_variable_get(:@status).key?([flavor, "download_from_store", platform.to_s])
+
+            UI.error("❌ Failed to download content for flavor: #{flavor}. Continuing to next flavor...")
+            any_download_failed = true
+            # Continue to the next flavor
+          end
+        end
+
+        # 5. Final Reporting and Status Check
+        annai_lanes.finalize
+
+        if any_download_failed
+            UI.user_error!("Download failed for one or more flavors. See the Annai Fastlane summary above")
+        else
+            UI.success("🎉 Successfully downloaded Google Play content for all #{flavors_to_download.count} requested flavor(s)!")
+        end
+      end
+
+      # ----------------------------------------------------
+      # Define Parameters
+      # ----------------------------------------------------
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :flavor,
+                                       description: "The specific flavor(s) to download (comma-separated). If nil, all flavors are processed",
+                                       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: :api_key_path,
+                                       description: "Path to the Google Service Account JSON file (Android). Optional if defined in the Annai spec",
+                                       optional: true,
+                                       default_value: nil),
+          FastlaneCore::ConfigItem.new(key: :package_name,
+                                       description: "The package name (Android). Optional if defined in the Annai spec",
+                                       optional: true,
+                                       default_value: nil),
+
+          FastlaneCore::ConfigItem.new(key: :metadata_path,
+                                       description: "The path where localization metadata (e.g., descriptions, titles) should be downloaded",
+                                       optional: true,
+                                       default_value: nil),
+        ].compact
+      end
+
+      def self.description
+        "Downloads store metadata for one or all flavors from the Google Play Store"
+      end
+
+      def self.is_supported?(platform)
+        platform == :android
+      end
+
+      def self.example_code
+        'ann_download_from_play_store(
+          flavor: "production",
+          spec_file: "config/annai_config.yaml", # Optional custom spec path
+          api_key_path: "./api_keys/google_play_key.json",
+          package_name: "com.example.app",
+        )'
+      end
+    end
+  end
+end