fastlane-plugin-create_simulator_devices 0.0.17 → 0.0.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8bf78a070d8cc87783033a6d6dfb1c778a2cacc388cf0e5f691308955e94f848
-  data.tar.gz: 1a4fae00d92ff2e0c1f2a15a3f0804cb519fc9e2cedafa98e183ab0da6d39b74
+  metadata.gz: e17a57f2e1b0ff1083d58d23717995d26796843c633231ba41430b877116fb02
+  data.tar.gz: '017846203dca650cb4d1d70f6da80c81f2aef1369b08e3b9443d6f4479ea1a79'
 SHA512:
-  metadata.gz: b47dc812e54c36acd0a95131838b5f45b0ab2fc9422965c961b4002acfdaf275ac9e1a870336a778043908cb62da3e6656ae3feb29c657bee6b80200dc320a24
-  data.tar.gz: e21033bc755e645677f98e54ddb553cafbaf674ac01e6d34bd07dce967b17a2f1c5459c0928d0edf06de002abae337940e122bff507c63850a85101d749d2771
+  metadata.gz: 6566a4d2f8837546c119bdb90e4f2013bd4d8b1f499342a6330c4e032b9a9c8099af321ce97c5b601a5ef2b35aa52f33dd74f2475df8ace7290cf66781c5481d
+  data.tar.gz: b9966803a099e1678eb635a4c0f6bca4b211b5147e3e268443a022124d6c673c9423e6e27d81f93fefda79f3986111cd8f1dc9de10521e615356ffda4a346d1a

data/lib/fastlane/plugin/create_simulator_devices/actions/create_simulator_devices_action.rb

@@ -22,7 +22,7 @@ module Fastlane
         required_devices = params[:devices]
         UI.user_error!('No devices specified') if required_devices.nil? || required_devices.empty?
 
-        shell_helper = CreateSimulatorDevices::ShellHelper.new(print_command: params[:print_command], print_command_output: params[:print_command_output], action_context: self)
+        shell_helper = CreateSimulatorDevices::ShellHelper.new(verbose: verbose, print_command: params[:print_command], print_command_output: params[:print_command_output], action_context: self)
         runtime_helper = CreateSimulatorDevices::RuntimeHelper.new(cache_dir: params[:cache_dir], shell_helper: shell_helper, verbose: verbose)
 
         runner = CreateSimulatorDevices::Runner.new(
@@ -32,7 +32,9 @@ module Fastlane
           can_rename_devices: params[:rename_devices],
           can_delete_duplicate_devices: params[:delete_duplicate_devices],
           device_naming_style: params[:device_naming_style].to_sym,
-          remove_cached_runtimes: params[:remove_cached_runtimes]
+          remove_cached_runtimes: params[:remove_cached_runtimes],
+          update_dyld_shared_cache: params[:update_dyld_shared_cache],
+          delete_unused_runtimes: params[:delete_unused_runtimes]
         )
 
         runner.run(required_devices)
@@ -113,7 +115,19 @@ module Fastlane
                                          description: 'Remove cached runtimes after successful installation',
                                          type: Boolean,
                                          optional: true,
-                                         default_value: true)
+                                         default_value: true),
+          ::FastlaneCore::ConfigItem.new(key: :update_dyld_shared_cache,
+                                         env_name: 'CREATE_SIMULATOR_DEVICES_UPDATE_DYLD_SHARED_CACHE',
+                                         description: 'Update dyld shared cache',
+                                         type: Boolean,
+                                         optional: true,
+                                         default_value: false),
+          ::FastlaneCore::ConfigItem.new(key: :delete_unused_runtimes,
+                                         env_name: 'CREATE_SIMULATOR_DEVICES_DELETE_UNUSED_RUNTIMES',
+                                         description: 'Delete unused runtimes',
+                                         type: Boolean,
+                                         optional: true,
+                                         default_value: false)
         ]
       end
 

data/lib/fastlane/plugin/create_simulator_devices/actions/gather_simctl_diagnose_action.rb

@@ -10,7 +10,6 @@ require_relative '../helpers/gather_simctl_diagnose/runner'
 module Fastlane
   module Actions
     GatherSimctlDiagnose = ::Fastlane::GatherSimctlDiagnose
-    CreateSimulatorDevices = ::Fastlane::CreateSimulatorDevices
 
     # Gather simctl diagnose data.
     class GatherSimctlDiagnoseAction < Fastlane::Action
@@ -24,7 +23,7 @@ module Fastlane
         required_devices = params[:devices]
         UI.user_error!('No devices specified') if required_devices.nil? || required_devices.empty?
 
-        shell_helper = CreateSimulatorDevices::ShellHelper.new(print_command: params[:print_command], print_command_output: params[:print_command_output], action_context: self)
+        shell_helper = CreateSimulatorDevices::ShellHelper.new(verbose: verbose, print_command: params[:print_command], print_command_output: params[:print_command_output], action_context: self)
         runtime_helper = CreateSimulatorDevices::RuntimeHelper.new(cache_dir: nil, shell_helper: shell_helper, verbose: verbose)
 
         create_simulator_devices_runner = ::Fastlane::CreateSimulatorDevices::Runner.new(
@@ -34,7 +33,9 @@ module Fastlane
           can_rename_devices: false,
           can_delete_duplicate_devices: false,
           device_naming_style: params[:device_naming_style].to_sym,
-          remove_cached_runtimes: false
+          remove_cached_runtimes: false,
+          update_dyld_shared_cache: false,
+          delete_unused_runtimes: false
         )
 
         runner = GatherSimctlDiagnose::Runner.new(

data/lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/apple_build_version.rb

@@ -62,15 +62,15 @@ module Fastlane
       end
 
       def major
-        @build_version.match(/^([0-9]+)([A-Z][0-9]{2,3})([0-9]+)/)[1]
+        @build_version.match(/^([0-9]+)([A-Z])([0-9]+)/)[1]
       end
 
       def minor
-        @build_version.match(/^([0-9]+)([A-Z][0-9]{2,3})([0-9]+)/)[2]
+        @build_version.match(/^([0-9]+)([A-Z])([0-9]+)/)[2]
       end
 
       def patch
-        @build_version.match(/^([0-9]+)([A-Z][0-9]{2,3})([0-9]+)/)[3]
+        @build_version.match(/^([0-9]+)([A-Z])([0-9]+)/)[3]
       end
 
       def <(other)

data/lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/simctl/matched_runtime.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require_relative 'runtime_supported_device_type'
+require_relative '../apple_build_version'
+
+module Fastlane
+  module CreateSimulatorDevices
+    module SimCTL
+      # Represents a matched runtime from `xcrun simctl runtime match list --json` output.
+      class MatchedRuntime
+        attr_accessor :identifier, :default_build, :chosen_runtime_build, :sdk_build, :sdk_version, :platform
+
+        def initialize(identifier:, default_build:, chosen_runtime_build:, sdk_build:, sdk_version:, platform:) # rubocop:disable Metrics/ParameterLists
+          self.identifier = identifier
+          self.default_build = default_build
+          self.chosen_runtime_build = chosen_runtime_build
+          self.sdk_build = sdk_build
+          self.sdk_version = sdk_version
+          self.platform = platform
+        end
+
+        def self.from_hash(hash, identifier:)
+          new(
+            identifier: identifier.to_s,
+            default_build: AppleBuildVersion.new(hash[:defaultBuild]),
+            chosen_runtime_build: AppleBuildVersion.new(hash[:chosenRuntimeBuild]),
+            sdk_build: AppleBuildVersion.new(hash[:sdkBuild]),
+            sdk_version: Gem::Version.new(hash[:sdkVersion]),
+            platform: hash[:platform].to_s
+          )
+        end
+      end
+    end
+  end
+end
+
+# Example of a Runtime object from `xcrun simctl list runtimes --json` output:
+#
+# {"iphoneos26.1" : {
+#   "chosenRuntimeBuild" : "23B80",
+#   "defaultBuild" : "23B77",
+#   "platform" : "com.apple.platform.iphoneos",
+#   "sdkBuild" : "23B77",
+#   "sdkDirectory" : "\/Applications\/Xcode-26.1.1.app\/Contents\/Developer\/Platforms\/iPhoneOS.platform\/Developer\/SDKs\/iPhoneOS26.1.sdk",
+#   "sdkVersion" : "26.1"
+# }

data/lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/simctl/runtime.rb

@@ -8,14 +8,15 @@ module Fastlane
     module SimCTL
       # Represents a runtime from `xcrun simctl runtime list --json` output.
       class RuntimeWithState
-        attr_accessor :identifier, :version, :build, :state, :deletable
+        attr_accessor :identifier, :version, :build, :state, :deletable, :runtime_identifier
 
-        def initialize(identifier:, version:, build:, state:, deletable:)
+        def initialize(identifier:, version:, build:, state:, deletable:, runtime_identifier:) # rubocop:disable Metrics/ParameterLists
           self.identifier = identifier
           self.version = version
           self.build = build
           self.state = state
           self.deletable = deletable
+          self.runtime_identifier = runtime_identifier
         end
 
         def ready?
@@ -32,11 +33,12 @@ module Fastlane
 
         def self.from_hash(hash)
           new(
-            identifier: hash[:identifier],
+            identifier: hash[:identifier].to_s,
             version: Gem::Version.new(hash[:version]),
             build: AppleBuildVersion.new(hash[:build]),
-            state: hash[:state],
-            deletable: hash[:deletable]
+            state: hash[:state].to_s,
+            deletable: hash[:deletable],
+            runtime_identifier: hash[:runtimeIdentifier].to_s
           )
         end
       end

data/lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models.rb

@@ -9,6 +9,7 @@ require_relative 'models/required_device'
 require_relative 'models/required_runtime'
 require_relative 'models/apple_build_version'
 require_relative 'models/device_naming_style'
+require_relative 'models/simctl/matched_runtime'
 require 'fastlane'
 
 module Fastlane

data/lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/runner.rb

@@ -9,12 +9,12 @@ module Fastlane
   # Create simulator devices.
   module CreateSimulatorDevices
     # Does all the work to create simulator devices.
-    class Runner # rubocop:disable Metrics/ClassLength
+    class Runner
       UI = ::Fastlane::UI unless defined?(UI)
 
-      attr_accessor :shell_helper, :verbose, :runtime_helper, :can_rename_devices, :can_delete_duplicate_devices, :device_naming_style, :remove_cached_runtimes
+      attr_accessor :shell_helper, :verbose, :runtime_helper, :can_rename_devices, :can_delete_duplicate_devices, :device_naming_style, :remove_cached_runtimes, :update_dyld_shared_cache, :delete_unused_runtimes
 
-      def initialize(runtime_helper:, shell_helper:, verbose:, can_rename_devices:, can_delete_duplicate_devices:, device_naming_style:, remove_cached_runtimes:) # rubocop:disable Metrics/ParameterLists
+      def initialize(runtime_helper:, shell_helper:, verbose:, can_rename_devices:, can_delete_duplicate_devices:, device_naming_style:, remove_cached_runtimes:, update_dyld_shared_cache:, delete_unused_runtimes:) # rubocop:disable Metrics/ParameterLists
         self.shell_helper = shell_helper
         self.verbose = verbose
         self.runtime_helper = runtime_helper
@@ -22,6 +22,8 @@ module Fastlane
         self.can_delete_duplicate_devices = can_delete_duplicate_devices
         self.device_naming_style = device_naming_style
         self.remove_cached_runtimes = remove_cached_runtimes
+        self.update_dyld_shared_cache = update_dyld_shared_cache
+        self.delete_unused_runtimes = delete_unused_runtimes
       end
 
       def run(devices)
@@ -44,7 +46,7 @@ module Fastlane
         end
 
         # Install missing runtimes if needed.
-        runtime_helper.install_missing_runtimes(required_devices, remove_cached_runtimes: remove_cached_runtimes)
+        runtime_helper.install_missing_runtimes(required_devices, remove_cached_runtimes: remove_cached_runtimes, remove_unused_runtimes: delete_unused_runtimes)
 
         # Create missing devices for required devices.
         create_missing_devices(required_devices)
@@ -55,6 +57,11 @@ module Fastlane
 
         log_matched_devices(matched_devices: matched_devices)
 
+        if update_dyld_shared_cache
+          UI.message('Updating dyld shared cache...')
+          shell_helper.update_dyld_shared_cache
+        end
+
         matched_devices_names = matched_devices.map { |matched_device| returning_device_name_for_required_device(matched_device) }
         UI.message("Available simulator devices: #{matched_devices_names.join(', ')}")
 
@@ -190,6 +197,8 @@ module Fastlane
 
         UI.message('Creating missing devices')
         missing_devices.each do |missing_device|
+          next if missing_device.simctl_runtime.nil?
+
           shell_helper.create_device(
             device_name_for_required_device(missing_device),
             missing_device.device_type.identifier,

data/lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/runtime_helper.rb

@@ -7,7 +7,7 @@ require_relative 'shell_helper'
 module Fastlane
   module CreateSimulatorDevices
     # Helper class for managing simulator runtimes.
-    class RuntimeHelper
+    class RuntimeHelper # rubocop:disable Metrics/ClassLength
       UI = ::Fastlane::UI unless defined?(UI)
 
       attr_accessor :cache_dir, :shell_helper, :verbose
@@ -25,6 +25,13 @@ module Fastlane
         'xrsimulator' => 'xrOS'
       }.freeze
 
+      OS_NAME_TO_MATCHED_RUNTIME_IDENTIFIER = {
+        'iOS' => 'iphoneos',
+        'tvOS' => 'appletvos',
+        'watchOS' => 'watchos',
+        'xrOS' => 'xros'
+      }.freeze
+
       def delete_unusable_runtimes
         deletable_runtimes = shell_helper.installed_runtimes_with_state
           .select { |runtime| runtime.unusable? && runtime.deletable? }
@@ -39,13 +46,14 @@ module Fastlane
         shell_helper.simctl_devices_for_runtimes(force: true)
       end
 
-      def install_missing_runtimes(required_devices, remove_cached_runtimes:)
+      def install_missing_runtimes(required_devices, remove_cached_runtimes:, remove_unused_runtimes:)
         needed_runtimes = required_devices.filter_map(&:required_runtime).uniq
 
         missing_runtimes = missing_runtimes(needed_runtimes)
 
         if missing_runtimes.empty?
           UI.message('All required runtimes are present. Skipping runtime installation...') if verbose
+          delete_unused_runtimes(needed_runtimes) if remove_unused_runtimes
           return
         end
 
@@ -66,6 +74,41 @@ module Fastlane
           .each do |missing_runtime|
             UI.important("Failed to find/download/install runtime #{missing_runtime.runtime_name}")
           end
+
+        delete_unused_runtimes(needed_runtimes) if remove_unused_runtimes
+      end
+
+      def delete_unused_runtimes(needed_runtimes)
+        UI.message('Deleting unused runtimes...')
+        available_simctl_runtimes = shell_helper.simctl_runtimes
+
+        needed_simctl_runtimes = needed_runtimes.map do |needed_runtime|
+          # Check if available runtimes contain the needed runtime.
+          simctl_runtime_matching_needed_runtime?(needed_runtime)
+        end
+
+        unused_simctl_runtimes = available_simctl_runtimes.reject do |available_simctl_runtime|
+          needed_simctl_runtimes.any? do |needed_simctl_runtime|
+            needed_simctl_runtime.identifier == available_simctl_runtime.identifier
+          end
+        end
+
+        unused_simctl_runtimes = unused_simctl_runtimes.filter_map do |unused_simctl_runtime|
+          shell_helper.installed_runtimes_with_state.detect do |installed_simctl_runtime|
+            installed_simctl_runtime.runtime_identifier == unused_simctl_runtime.identifier
+          end
+        end
+
+        return if unused_simctl_runtimes.empty?
+
+        unused_simctl_runtimes.each do |unused_simctl_runtime|
+          puts "Deleting unused runtime #{unused_simctl_runtime.runtime_identifier} (#{unused_simctl_runtime.identifier})..."
+          shell_helper.simctl_delete_runtime(identifier: unused_simctl_runtime.identifier)
+        end
+
+        shell_helper.installed_runtimes_with_state
+        shell_helper.simctl_runtimes(force: true)
+        shell_helper.simctl_devices_for_runtimes(force: true)
       end
 
       def missing_runtimes(needed_runtimes)
@@ -153,6 +196,16 @@ module Fastlane
         AppleBuildVersion.new(build_version)
       end
 
+      def matched_runtime_for_missing_runtime(missing_runtime)
+        matched_runtimes = shell_helper.simctl_matched_runtimes(force: true)
+
+        matched_runtime_identifier = "#{OS_NAME_TO_MATCHED_RUNTIME_IDENTIFIER[missing_runtime.os_name]}#{missing_runtime.product_version}"
+
+        matched_runtimes = matched_runtimes.select { |matched_runtime| matched_runtime.identifier == matched_runtime_identifier && matched_runtime.sdk_build == missing_runtime.product_build_version }
+
+        matched_runtimes.max_by(&:chosen_runtime_build)
+      end
+
       def cached_runtime_file(missing_runtime)
         FileUtils.mkdir_p(cache_dir)
 
@@ -164,10 +217,10 @@ module Fastlane
         # E.g. Xcode 26.0 Beta 3 has iOS 26.0 (23A5287e) SDK, but
         # xcodebuild downloads iphonesimulator_26.0_23A5287g.dmg as latest.
         product_build_version = missing_runtime.product_build_version
+
         if product_build_version
           runtime_dmg_search_pattern += product_build_version.major.to_s
           runtime_dmg_search_pattern += product_build_version.minor.to_s
-          runtime_dmg_search_pattern += product_build_version.patch.to_s
         end
         runtime_dmg_search_pattern += '*.dmg'
 
@@ -177,9 +230,17 @@ module Fastlane
           UI.message("Available files with pattern: #{Dir.glob(runtime_dmg_search_pattern)}")
         end
 
-        runtime_file = Dir
+        runtime_file = nil
+        runtime_files = Dir
           .glob(runtime_dmg_search_pattern)
-          .max_by { |filename| runtime_build_version_for_filename(filename) }
+
+        return nil if runtime_files.empty?
+
+        matched_runtime = matched_runtime_for_missing_runtime(missing_runtime)
+
+        runtime_file = runtime_files.detect { |filename| filename.end_with?("_#{matched_runtime.chosen_runtime_build}.dmg") } unless matched_runtime.nil?
+
+        runtime_file ||= runtime_files.max_by { |filename| runtime_build_version_for_filename(filename) }
 
         return nil if runtime_file.nil?
 

data/lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/shell_helper.rb

@@ -11,9 +11,10 @@ module Fastlane
       UI = ::Fastlane::UI unless defined?(UI)
 
       # Proprty verbose
-      attr_accessor :print_command, :print_command_output, :action_context
+      attr_accessor :verbose, :print_command, :print_command_output, :action_context
 
-      def initialize(print_command: false, print_command_output: false, action_context: nil)
+      def initialize(verbose: false, print_command: false, print_command_output: false, action_context: nil)
+        self.verbose = verbose
         self.print_command = print_command
         self.print_command_output = print_command_output
         self.action_context = action_context
@@ -103,6 +104,22 @@ module Fastlane
         @simctl_runtimes
       end
 
+      def simctl_delete_runtime(identifier:)
+        UI.message("Deleting runtime #{identifier}...")
+        sh(command: "xcrun simctl runtime delete #{identifier.shellescape}")
+      end
+
+      def simctl_matched_runtimes(force: false)
+        return @simctl_matched_runtimes unless force || @simctl_matched_runtimes.nil?
+
+        UI.message('Fetching matched runtimes...')
+        json = sh(command: 'xcrun simctl runtime match list --json')
+
+        @simctl_matched_runtimes = JSON
+          .parse(json, symbolize_names: true)
+          .map { |identifier, runtime| SimCTL::MatchedRuntime.from_hash(runtime, identifier: identifier) }
+      end
+
       def installed_runtimes_with_state
         UI.message('Fetching runtimes with state...')
         json = sh(command: 'xcrun simctl runtime list --json')
@@ -141,8 +158,6 @@ module Fastlane
       end
 
       def download_runtime(missing_runtime, cache_dir)
-        UI.message("Downloading #{missing_runtime.runtime_name} to #{cache_dir}. This may take a while...")
-
         command = [
           'xcrun',
           'xcodebuild',
@@ -162,6 +177,30 @@ module Fastlane
           command << missing_runtime.product_version.to_s.shellescape
         end
 
+        simulator_architecture_variant = 'universal'
+
+        if Fastlane::Helper.xcode_at_least?('26') && missing_runtime.product_version >= '26'
+          xcode_binary_path = File.join(Fastlane::Helper.xcode_path, '..', 'MacOS', 'Xcode')
+          xcode_binary_path = File.expand_path(xcode_binary_path)
+
+          UI.message('Getting Xcode architecture variants with lipo...') if verbose
+
+          xcode_architecture_variants = sh(command: "lipo -archs #{xcode_binary_path.shellescape}", print_command: print_command, print_command_output: print_command_output).split
+
+          UI.message("Xcode architecture variants: #{xcode_architecture_variants}") if verbose
+
+          simulator_architecture_variant = if xcode_architecture_variants.include?('x86_64')
+                                             'universal'
+                                           else
+                                             'arm64'
+                                           end
+
+          command << '-architectureVariant'
+          command << simulator_architecture_variant.shellescape
+        end
+
+        UI.message("Downloading #{missing_runtime.runtime_name} (arch: #{simulator_architecture_variant}) to #{cache_dir}. This may take a while...")
+
         sh(command: command.join(' '), print_command: true, print_command_output: true)
       end
 
@@ -175,6 +214,12 @@ module Fastlane
         end
       end
 
+      def update_dyld_shared_cache
+        sh(
+          command: 'xcrun simctl runtime dyld_shared_cache update --all'
+        )
+      end
+
       def device_info_by_udid(udid)
         sh(
           command: "xcrun simctl list devices --json | jq '.devices | to_entries[].value[] | select(.udid==\"#{udid.shellescape}\")'",

data/lib/fastlane/plugin/create_simulator_devices/version.rb

@@ -2,6 +2,6 @@
 
 module Fastlane
   module CreateSimulatorDevices
-    VERSION = '0.0.17'
+    VERSION = '0.0.19'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fastlane-plugin-create_simulator_devices
 version: !ruby/object:Gem::Version
-  version: 0.0.17
+  version: 0.0.19
 platform: ruby
 authors:
 - Vitalii Budnik
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-04 00:00:00.000000000 Z
+date: 2025-12-09 00:00:00.000000000 Z
 dependencies: []
 description:
 email: developers@setapp.com
@@ -28,6 +28,7 @@ files:
 - lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/required_runtime.rb
 - lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/simctl/device.rb
 - lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/simctl/device_type.rb
+- lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/simctl/matched_runtime.rb
 - lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/simctl/runtime.rb
 - lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/simctl/runtime_supported_device_type.rb
 - lib/fastlane/plugin/create_simulator_devices/helpers/create_simulator_devices/models/xcodebuild/sdk.rb