ann-flutter-flavor 0.1.2

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

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