xcodeproj 1.19.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72f6eb6645b557dea09ae4be0fd400e48b0d4f1e42c31b7b61af87fd3c31a9cd
-  data.tar.gz: 0c0bcfa7abc28721f61f48e295198da53576e90d62161c50a6cc7333c1e94455
+  metadata.gz: 156c030adda9cf98bf0f8b3616a1959e95f9bc1fa07227895c719aafd4d13734
+  data.tar.gz: 45a532a148d764028d5a58c0859ca1c5b13838cc68497b44611e79d6a65a6ccf
 SHA512:
-  metadata.gz: 4f856d8cbee5b9b7b6bcbe7acce4034e8277fd05ac7caf0d2c317f75d622bb5c518dd2ddee67dac1c6a7fb2773aebb5a5de2cf2232af3fffc2353323fd08623d
-  data.tar.gz: 9cf088a34dea380b56716f005c35fc601d9b193a0a4908556d4f8ccc80408ee328755ccb767dc0ed50adc0bc3e822cc9bcdcdeac405c97fc514f6dd429f746ac
+  metadata.gz: b7a4da4a5adb9eaa2b129758b0f432b4b6317ef8036df36275edd02d43ff80c9d0d126b012992633acab0721c91c7b7da601dcf76175e459fb07e59a772e7393
+  data.tar.gz: fd8d1a9c5f246264266a02b8d68a507ebf74e2b82881b4a52da754f77c5450ce322e6def0484f289c04690b449fcf09a8e3f46ce74c8e525cabe6796e868a2b1

data/README.md

@@ -10,7 +10,7 @@ support for Xcode workspaces (`.xcworkspace`), configuration files (`.xcconfig`)
 Xcode Scheme files (`.xcscheme`).
 
 It is used in [CocoaPods](https://github.com/CocoaPods/CocoaPods) to create a
-a collection of supplemental libraries or frameworks, for all platforms Xcode supports.
+collection of supplemental libraries or frameworks, for all platforms Xcode supports.
 
 The API reference can be found [here](http://www.rubydoc.info/gems/xcodeproj).
 

data/lib/xcodeproj/command/sort.rb

@@ -9,22 +9,33 @@ module Xcodeproj
 
       self.summary = 'Sorts the given project.'
 
+      def self.options
+        [
+          ['--group-option=[above|below]', 'The position of the groups when sorting. If no option is specified, sorting will interleave groups and files.'],
+        ].concat(super)
+      end
+
       self.arguments = [
         CLAide::Argument.new('PROJECT', false),
       ]
 
       def initialize(argv)
         self.xcodeproj_path = argv.shift_argument
+        @group_option = argv.option('group-option')
+        @group_option &&= @group_option.to_sym
         super
       end
 
       def validate!
         super
+        unless [nil, :above, :below].include?(@group_option)
+          help! "Unknown format `#{@group_option}`"
+        end
         open_project!
       end
 
       def run
-        xcodeproj.sort
+        xcodeproj.sort(:groups_position => @group_option)
         xcodeproj.save
         puts "The `#{File.basename(xcodeproj_path)}` project was sorted"
       end

data/lib/xcodeproj/config.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'shellwords'
 require 'xcodeproj/config/other_linker_flags_parser'
 
@@ -58,7 +59,7 @@ module Xcodeproj
       @attributes = {}
       @includes = []
       @other_linker_flags = {}
-      [:simple, :frameworks, :weak_frameworks, :libraries, :force_load].each do |key|
+      [:simple, :frameworks, :weak_frameworks, :libraries, :arg_files, :force_load].each do |key|
         @other_linker_flags[key] = Set.new
       end
       merge!(extract_hash(xcconfig_hash_or_file))
@@ -125,9 +126,10 @@ module Xcodeproj
         :frameworks => '-framework ',
         :weak_frameworks => '-weak_framework ',
         :libraries => '-l',
+        :arg_files => '@',
         :force_load => '-force_load',
       }
-      [:libraries, :frameworks, :weak_frameworks, :force_load].each do |key|
+      [:libraries, :frameworks, :weak_frameworks, :arg_files, :force_load].each do |key|
         modifier = modifiers[key]
         sorted = other_linker_flags[key].to_a.sort
         if key == :force_load
@@ -180,6 +182,13 @@ module Xcodeproj
       other_linker_flags[:libraries]
     end
 
+    # @return [Set<String>] The list of the arg files required by this
+    #         settings file.
+    #
+    def arg_files
+      other_linker_flags[:arg_files]
+    end
+
     public
 
     # @!group Merging
@@ -254,6 +263,7 @@ module Xcodeproj
     # @return [Hash]
     #
     def extract_hash(argument)
+      return argument if argument.is_a?(Hash)
       if argument.respond_to? :read
         @filepath = Pathname.new(argument.to_path)
         hash_from_file_content(argument.read)

data/lib/xcodeproj/config/other_linker_flags_parser.rb

@@ -16,6 +16,7 @@ module Xcodeproj
           :frameworks => [],
           :weak_frameworks => [],
           :libraries => [],
+          :arg_files => [],
           :simple => [],
           :force_load => [],
         }
@@ -32,6 +33,8 @@ module Xcodeproj
             key = :weak_frameworks
           when '-l'
             key = :libraries
+          when '@'
+            key = :arg_files
           when '-force_load'
             key = :force_load
           else
@@ -58,6 +61,8 @@ module Xcodeproj
         flags.strip.shellsplit.flat_map do |string|
           if string =~ /\A-l.+/
             ['-l', string[2..-1]]
+          elsif string =~ /\A@.+/
+            ['@', string[1..-1]]
           else
             string
           end

data/lib/xcodeproj/constants.rb

@@ -32,15 +32,15 @@ module Xcodeproj
 
     # @return [String] The last known object version to Xcodeproj.
     #
-    LAST_KNOWN_OBJECT_VERSION = 54
+    LAST_KNOWN_OBJECT_VERSION = 55
 
-    # @return [String] The last known object version to Xcodeproj.
+    # @return [String] The last known Xcode version to Xcodeproj.
     #
-    LAST_UPGRADE_CHECK = '1100'
+    LAST_UPGRADE_CHECK = '1240'
 
-    # @return [String] The last known object version to Xcodeproj.
+    # @return [String] The last known Xcode version to Xcodeproj.
     #
-    LAST_SWIFT_UPGRADE_CHECK = '1100'
+    LAST_SWIFT_UPGRADE_CHECK = '1240'
 
     # @return [String] The version of `.xcscheme` files supported by Xcodeproj
     #
@@ -128,6 +128,7 @@ module Xcodeproj
     # @return [Hash] The compatibility version string for different object versions.
     #
     COMPATIBILITY_VERSION_BY_OBJECT_VERSION = {
+      55 => 'Xcode 13.0',
       54 => 'Xcode 12.0',
       53 => 'Xcode 11.4',
       52 => 'Xcode 11.0',
@@ -453,5 +454,12 @@ module Xcodeproj
       $(inherited)
       ${inherited}
     ).freeze
+
+    # @return [Hash] Possible types for a scheme's 'ExecutionAction' node
+    #
+    EXECUTION_ACTION_TYPE = {
+      :shell_script  => 'Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.ShellScriptAction',
+      :send_email    => 'Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.SendEmailAction',
+    }.freeze
   end
 end

data/lib/xcodeproj/gem_version.rb

@@ -1,5 +1,5 @@
 module Xcodeproj
   # The version of the xcodeproj gem.
   #
-  VERSION = '1.19.0'.freeze unless defined? Xcodeproj::VERSION
+  VERSION = '1.20.0'.freeze unless defined? Xcodeproj::VERSION
 end

data/lib/xcodeproj/project.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'atomos'
 require 'fileutils'
 require 'securerandom'
@@ -220,11 +221,11 @@ module Xcodeproj
       end
 
       if archive_version.to_i > Constants::LAST_KNOWN_ARCHIVE_VERSION
-        raise '[Xcodeproj] Unknown archive version.'
+        raise "[Xcodeproj] Unknown archive version (#{archive_version.to_i})."
       end
 
       if object_version.to_i > Constants::LAST_KNOWN_OBJECT_VERSION
-        raise '[Xcodeproj] Unknown object version.'
+        raise "[Xcodeproj] Unknown object version (#{object_version.to_i})."
       end
 
       # Projects can have product_ref_groups that are not listed in the main_groups["Products"]
@@ -711,9 +712,10 @@ module Xcodeproj
     #
     # @return [PBXNativeTarget] the target.
     #
-    def new_target(type, name, platform, deployment_target = nil, product_group = nil, language = nil)
+    def new_target(type, name, platform, deployment_target = nil, product_group = nil, language = nil, product_basename = nil)
       product_group ||= products_group
-      ProjectHelper.new_target(self, type, name, platform, deployment_target, product_group, language)
+      product_basename ||= name
+      ProjectHelper.new_target(self, type, name, platform, deployment_target, product_group, language, product_basename)
     end
 
     # Creates a new resource bundles target and adds it to the project.
@@ -731,9 +733,10 @@ module Xcodeproj
     #
     # @return [PBXNativeTarget] the target.
     #
-    def new_resources_bundle(name, platform, product_group = nil)
+    def new_resources_bundle(name, platform, product_group = nil, product_basename = nil)
       product_group ||= products_group
-      ProjectHelper.new_resources_bundle(self, name, platform, product_group)
+      product_basename ||= name
+      ProjectHelper.new_resources_bundle(self, name, platform, product_group, product_basename)
     end
 
     # Creates a new target and adds it to the project.

data/lib/xcodeproj/project/object/build_file.rb

@@ -49,7 +49,9 @@ module Xcodeproj
         #         user.
         #
         def display_name
-          if file_ref
+          if product_ref
+            product_ref.display_name
+          elsif file_ref
             file_ref.display_name
           else
             super

data/lib/xcodeproj/project/object/group.rb

@@ -226,24 +226,24 @@ module Xcodeproj
         # Creates a file reference to a static library and adds it to the
         # group.
         #
-        # @param  [#to_s] product_name
+        # @param  [#to_s] product_basename
         #         The name of the static library.
         #
         # @return [PBXFileReference] The new file reference.
         #
-        def new_product_ref_for_target(target_name, product_type)
-          FileReferencesFactory.new_product_ref_for_target(self, target_name, product_type)
+        def new_product_ref_for_target(product_basename, product_type)
+          FileReferencesFactory.new_product_ref_for_target(self, product_basename, product_type)
         end
 
         # Creates a file reference to a new bundle.
         #
-        # @param  [#to_s] product_name
+        # @param  [#to_s] product_basename
         #         The name of the bundle.
         #
         # @return [PBXFileReference] The new file reference.
         #
-        def new_bundle(product_name)
-          FileReferencesFactory.new_bundle(self, product_name)
+        def new_bundle(product_basename)
+          FileReferencesFactory.new_bundle(self, product_basename)
         end
 
         # Creates a file reference to a new bundle and adds it to the group.

data/lib/xcodeproj/project/object/helpers/file_references_factory.rb

@@ -42,17 +42,17 @@ module Xcodeproj
           # @param  [PBXGroup] group
           #         The group to which to add the reference.
           #
-          # @param  [#to_s] product_name
+          # @param  [#to_s] product_basename
           #         The name of the static library.
           #
           # @return [PBXFileReference] The new file reference.
           #
-          def new_product_ref_for_target(group, target_name, product_type)
+          def new_product_ref_for_target(group, product_basename, product_type)
             if product_type == :static_library
               prefix = 'lib'
             end
             extension = Constants::PRODUCT_UTI_EXTENSIONS[product_type]
-            path = "#{prefix}#{target_name}"
+            path = "#{prefix}#{product_basename}"
             path += ".#{extension}" if extension
             ref = new_reference(group, path, :built_products)
             ref.include_in_index = '0'
@@ -66,13 +66,13 @@ module Xcodeproj
           # @param  [PBXGroup] group
           #         The group to which to add the reference.
           #
-          # @param  [#to_s] product_name
+          # @param  [#to_s] product_basename
           #         The name of the bundle.
           #
           # @return [PBXFileReference] The new file reference.
           #
-          def new_bundle(group, product_name)
-            ref = new_reference(group, "#{product_name}.bundle", :built_products)
+          def new_bundle(group, product_basename)
+            ref = new_reference(group, "#{product_basename}.bundle", :built_products)
             ref.include_in_index = '0'
             ref.set_explicit_file_type('wrapper.cfbundle')
             ref

data/lib/xcodeproj/project/object/helpers/groupable_helper.rb

@@ -205,7 +205,7 @@ module Xcodeproj
           # @return [void]
           #
           def set_path_with_source_tree(object, path, source_tree)
-            path = Pathname.new(path)
+            path = Pathname(path)
             source_tree = normalize_source_tree(source_tree)
             object.source_tree = source_tree
 

data/lib/xcodeproj/project/object/swift_package_product_dependency.rb

@@ -13,6 +13,16 @@ module Xcodeproj
         # @return [String] the product name of this Swift package.
         #
         attribute :product_name, String
+
+        # @!group AbstractObject Hooks
+        #--------------------------------------#
+
+        # @return [String] the name of the Swift package.
+        #
+        def display_name
+          return product_name if product_name
+          super
+        end
       end
     end
   end

data/lib/xcodeproj/project/object/swift_package_remote_reference.rb

@@ -13,6 +13,20 @@ module Xcodeproj
         # @return [Hash] the version requirements for this Swift package.
         #
         attribute :requirement, Hash
+
+        # @!group AbstractObject Hooks
+        #--------------------------------------#
+
+        def ascii_plist_annotation
+          " #{isa} \"#{File.basename(display_name)}\" "
+        end
+
+        # @return [String] the name of the Swift package repository.
+        #
+        def display_name
+          return repositoryURL if repositoryURL
+          super
+        end
       end
     end
   end

data/lib/xcodeproj/project/project_helper.rb

@@ -41,17 +41,17 @@ module Xcodeproj
       #
       # @return [PBXNativeTarget] the target.
       #
-      def self.new_target(project, type, name, platform, deployment_target, product_group, language)
+      def self.new_target(project, type, name, platform, deployment_target, product_group, language, product_basename)
         # Target
         target = project.new(PBXNativeTarget)
         project.targets << target
         target.name = name
-        target.product_name = name
+        target.product_name = product_basename
         target.product_type = Constants::PRODUCT_TYPE_UTI[type]
         target.build_configuration_list = configuration_list(project, platform, deployment_target, type, language)
 
         # Product
-        product = product_group.new_product_ref_for_target(name, type)
+        product = product_group.new_product_ref_for_target(target.product_name, type)
         target.product_reference = product
 
         # Build phases
@@ -88,12 +88,12 @@ module Xcodeproj
       #
       # @return [PBXNativeTarget] the target.
       #
-      def self.new_resources_bundle(project, name, platform, product_group)
+      def self.new_resources_bundle(project, name, platform, product_group, product_basename)
         # Target
         target = project.new(PBXNativeTarget)
         project.targets << target
         target.name = name
-        target.product_name = name
+        target.product_name = product_basename
         target.product_type = Constants::PRODUCT_TYPE_UTI[:bundle]
 
         # Configuration List
@@ -111,7 +111,7 @@ module Xcodeproj
         target.build_configuration_list = cl
 
         # Product
-        product = product_group.new_bundle(name)
+        product = product_group.new_bundle(target.product_name)
         target.product_reference = product
 
         # Build phases

data/lib/xcodeproj/scheme.rb

@@ -9,8 +9,12 @@ require 'xcodeproj/scheme/archive_action'
 
 require 'xcodeproj/scheme/buildable_product_runnable'
 require 'xcodeproj/scheme/buildable_reference'
+require 'xcodeproj/scheme/location_scenario_reference'
+require 'xcodeproj/scheme/execution_action'
 require 'xcodeproj/scheme/macro_expansion'
 require 'xcodeproj/scheme/remote_runnable'
+require 'xcodeproj/scheme/send_email_action_content'
+require 'xcodeproj/scheme/shell_script_action_content'
 
 module Xcodeproj
   # This class represents a Scheme document represented by a ".xcscheme" file
@@ -221,7 +225,7 @@ module Xcodeproj
       launch_runnable = BuildableProductRunnable.new(build_target, 0)
       launch_action.buildable_product_runnable = launch_runnable
 
-      profile_runnable = BuildableProductRunnable.new(build_target)
+      profile_runnable = BuildableProductRunnable.new(build_target, 0)
       profile_action.buildable_product_runnable = profile_runnable
 
       macro_exp = MacroExpansion.new(build_target)

data/lib/xcodeproj/scheme/abstract_scheme_action.rb

@@ -23,6 +23,78 @@ module Xcodeproj
       def build_configuration=(config_name)
         @xml_element.attributes['buildConfiguration'] = config_name
       end
+
+      # @return [Array<ExecutionAction>]
+      #         The list of actions to run before this scheme action.
+      #         Each entry can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def pre_actions
+        pre_actions = @xml_element.elements['PreActions']
+        return nil unless pre_actions
+        pre_actions.get_elements('ExecutionAction').map do |entry_node|
+          ExecutionAction.new(entry_node)
+        end
+      end
+
+      # @param [Array<ExecutionAction>] pre_actions
+      #         Set the list of actions to run before this scheme action.
+      #         Each entry can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def pre_actions=(pre_actions)
+        @xml_element.delete_element('PreActions')
+        unless pre_actions.empty?
+          pre_actions_element = @xml_element.add_element('PreActions')
+          pre_actions.each do |entry_node|
+            pre_actions_element.add_element(entry_node.xml_element)
+          end
+        end
+        pre_actions
+      end
+
+      # @param [ExecutionAction] pre_action
+      #        Add an action to the list of actions to run before this scheme action.
+      #        It can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def add_pre_action(pre_action)
+        pre_actions = @xml_element.elements['PreActions'] || @xml_element.add_element('PreActions')
+        pre_actions.add_element(pre_action.xml_element)
+      end
+
+      # @return [Array<ExecutionAction>]
+      #         The list of actions to run after this scheme action.
+      #         Each entry can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def post_actions
+        post_actions = @xml_element.elements['PostActions']
+        return nil unless post_actions
+        post_actions.get_elements('ExecutionAction').map do |entry_node|
+          ExecutionAction.new(entry_node)
+        end
+      end
+
+      # @param [Array<ExecutionAction>] post_actions
+      #        Set the list of actions to run after this scheme action.
+      #        Each entry can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def post_actions=(post_actions)
+        @xml_element.delete_element('PostActions')
+        unless post_actions.empty?
+          post_actions_element = @xml_element.add_element('PostActions')
+          post_actions.each do |entry_node|
+            post_actions_element.add_element(entry_node.xml_element)
+          end
+        end
+        post_actions
+      end
+
+      # @param [ExecutionAction] post_action
+      #        Add an action to the list of actions to run after this scheme action.
+      #        It can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def add_post_action(post_action)
+        post_actions = @xml_element.elements['PostActions'] || @xml_element.add_element('PostActions')
+        post_actions.add_element(post_action.xml_element)
+      end
     end
   end
 end

data/lib/xcodeproj/scheme/build_action.rb

@@ -19,6 +19,20 @@ module Xcodeproj
         end
       end
 
+      # @return [Bool]
+      #         Whether or not to run post actions on build failure
+      #
+      def run_post_actions_on_failure?
+        string_to_bool(@xml_element.attributes['runPostActionsOnFailure'])
+      end
+
+      # @param [Bool] flag
+      #        Set whether or not to run post actions on build failure
+      #
+      def run_post_actions_on_failure=(flag)
+        @xml_element.attributes['runPostActionsOnFailure'] = bool_to_string(flag)
+      end
+
       # @return [Bool]
       #         Whether or not to build the various targets in parallel
       #
@@ -47,6 +61,78 @@ module Xcodeproj
         @xml_element.attributes['buildImplicitDependencies'] = bool_to_string(flag)
       end
 
+      # @return [Array<ExecutionAction>]
+      #         The list of actions to run before this scheme action.
+      #         Each entry can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def pre_actions
+        pre_actions = @xml_element.elements['PreActions']
+        return nil unless pre_actions
+        pre_actions.get_elements('ExecutionAction').map do |entry_node|
+          ExecutionAction.new(entry_node)
+        end
+      end
+
+      # @param [Array<ExecutionAction>] pre_actions
+      #        Set the list of actions to run before this scheme action.
+      #        Each entry can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def pre_actions=(pre_actions)
+        @xml_element.delete_element('PreActions')
+        unless pre_actions.empty?
+          pre_actions_element = @xml_element.add_element('PreActions')
+          pre_actions.each do |entry_node|
+            pre_actions_element.add_element(entry_node.xml_element)
+          end
+        end
+        pre_actions
+      end
+
+      # @param [ExecutionAction] pre_action
+      #        Add an action to the list of actions to run before this scheme action.
+      #        It can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def add_pre_action(pre_action)
+        pre_actions = @xml_element.elements['PreActions'] || @xml_element.add_element('PreActions')
+        pre_actions.add_element(pre_action.xml_element)
+      end
+
+      # @return [Array<ExecutionAction>]
+      #         The list of actions to run after this scheme action.
+      #         Each entry can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def post_actions
+        post_actions = @xml_element.elements['PostActions']
+        return nil unless post_actions
+        post_actions.get_elements('ExecutionAction').map do |entry_node|
+          ExecutionAction.new(entry_node)
+        end
+      end
+
+      # @param [Array<ExecutionAction>] post_actions
+      #        Set the list of actions to run after this scheme action.
+      #        Each entry can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def post_actions=(post_actions)
+        @xml_element.delete_element('PostActions')
+        unless post_actions.empty?
+          post_actions_element = @xml_element.add_element('PostActions')
+          post_actions.each do |entry_node|
+            post_actions_element.add_element(entry_node.xml_element)
+          end
+        end
+        post_actions
+      end
+
+      # @param [ExecutionAction] post_action
+      #        Add an action to the list of actions to run after this scheme action.
+      #        It can be either a 'Run Script' or a 'Send Email' action.
+      #
+      def add_post_action(post_action)
+        post_actions = @xml_element.elements['PostActions'] || @xml_element.add_element('PostActions')
+        post_actions.add_element(post_action.xml_element)
+      end
+
       # @return [Array<BuildAction::Entry>]
       #         The list of BuildActionEntry nodes associated with this Build Action.
       #         Each entry represent a target to build and tells for which action it's needed to be built.
@@ -103,11 +189,11 @@ module Xcodeproj
               is_app_target = app_types.include?(target_or_node.product_type)
             end
 
-            self.build_for_analyzing = true
             self.build_for_testing   = is_test_target
             self.build_for_running   = is_app_target
             self.build_for_profiling = is_app_target
             self.build_for_archiving = is_app_target
+            self.build_for_analyzing = true
 
             add_buildable_reference BuildableReference.new(target_or_node) if target_or_node
           end

data/lib/xcodeproj/scheme/execution_action.rb

@@ -0,0 +1,86 @@
+module Xcodeproj
+  class XCScheme
+    # This class wraps the ExecutionAction node of a .xcscheme XML file
+    #
+    class ExecutionAction < XMLElementWrapper
+      # @param [REXML::Element] node
+      #        The 'ExecutionAction' XML node that this object will wrap.
+      #        If nil, will create an empty one
+      #
+      # @param [Symbol] action_type
+      #        One of `EXECUTION_ACTION_TYPE.keys`
+      #
+      def initialize(node = nil, action_type = nil)
+        create_xml_element_with_fallback(node, 'ExecutionAction') do
+          type = action_type || node.action_type
+          raise "[Xcodeproj] Invalid ActionType `#{type}`" unless Constants::EXECUTION_ACTION_TYPE.keys.include?(type)
+          @xml_element.attributes['ActionType'] = Constants::EXECUTION_ACTION_TYPE[type]
+        end
+      end
+
+      # @return [String]
+      #         The ActionType of this ExecutionAction. One of two values:
+      #
+      #         Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.ShellScriptAction,
+      #         Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.SendEmailAction
+      #
+      def action_type
+        @xml_element.attributes['ActionType']
+      end
+
+      # @return [ShellScriptActionContent]
+      #         If action_type is 'Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.ShellScriptAction'
+      #         returns the contents of the shell script to run pre/post action.
+      #
+      # @return [SendEmailActionContent]
+      #         If action_type is 'Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.SendEmailAction'
+      #         returns the contents of the email to send pre/post action.
+      #
+      def action_content
+        case action_type
+        when Constants::EXECUTION_ACTION_TYPE[:shell_script]
+          ShellScriptActionContent.new(@xml_element.elements['ActionContent'])
+        when Constants::EXECUTION_ACTION_TYPE[:send_email]
+          SendEmailActionContent.new(@xml_element.elements['ActionContent'])
+        else
+          raise "[Xcodeproj] Invalid ActionType `#{action_type}`"
+        end
+      end
+
+      # @param [ShellScriptActionContent, SendEmailActionContent] value
+      #        Set either the contents of the shell script to run pre/post action
+      #        or the contents of the email to send pre/post action.
+      #
+      def action_content=(value)
+        raise "[Xcodeproj] Invalid ActionContent `#{value.class}` for " \
+          "ActionType `#{action_type}`" unless valid_action_content?(value)
+
+        @xml_element.delete_element('ActionContent')
+        @xml_element.add_element(value.xml_element)
+      end
+
+      #-------------------------------------------------------------------------#
+
+      private
+
+      # @!group Private helpers
+
+      # @return [Bool]
+      #         True if value (ActionContent) is valid for current action_type
+      #
+      # @param [ShellScriptActionContent, SendEmailActionContent] value
+      #        Checks if value matches the expected action_type if present.
+      #
+      def valid_action_content?(value)
+        case action_type
+        when Constants::EXECUTION_ACTION_TYPE[:shell_script]
+          value.is_a?(ShellScriptActionContent)
+        when Constants::EXECUTION_ACTION_TYPE[:send_email]
+          value.is_a?(SendEmailActionContent)
+        else
+          false
+        end
+      end
+    end
+  end
+end

data/lib/xcodeproj/scheme/launch_action.rb

@@ -11,6 +11,8 @@ module Xcodeproj
       #
       def initialize(node = nil)
         create_xml_element_with_fallback(node, 'LaunchAction') do
+          self.build_configuration = 'Debug'
+
           # Add some attributes (that are not handled by this wrapper class yet but expected in the XML)
           @xml_element.attributes['selectedDebuggerIdentifier'] = 'Xcode.DebuggerFoundation.Debugger.LLDB'
           @xml_element.attributes['selectedLauncherIdentifier'] = 'Xcode.DebuggerFoundation.Launcher.LLDB'
@@ -19,10 +21,8 @@ module Xcodeproj
           @xml_element.attributes['ignoresPersistentStateOnLaunch'] = bool_to_string(false)
           @xml_element.attributes['debugDocumentVersioning'] = bool_to_string(true)
           @xml_element.attributes['debugServiceExtension'] = 'internal'
-          @xml_element.add_element('AdditionalOptions')
 
           # Setup default values for other (handled) attributes
-          self.build_configuration = 'Debug'
           self.allow_location_simulation = true
         end
       end
@@ -47,6 +47,21 @@ module Xcodeproj
         @xml_element.attributes['allowLocationSimulation'] = bool_to_string(flag)
       end
 
+      # @return [LocationScenarioReference]
+      #         The LocationScenarioReference to simulate a GPS location when executing the Launch Action
+      #
+      def location_scenario_reference?
+        LocationScenarioReference.new(@xml_element.elements['LocationScenarioReference'])
+      end
+
+      # @return [LocationScenarioReference]
+      #         Set the LocationScenarioReference which simulates a GPS location when executing the Launch Action
+      #
+      def location_scenario_reference=(reference)
+        @xml_element.delete_element('LocationScenarioReference')
+        @xml_element.add_element(reference.xml_element) if reference
+      end
+
       # @return [Bool]
       #         Whether this Build Action should disable detection of UI API misuse
       #         from background threads

data/lib/xcodeproj/scheme/location_scenario_reference.rb

@@ -0,0 +1,49 @@
+module Xcodeproj
+  class XCScheme
+    # This class wraps the LocationScenarioReference node of a .xcscheme XML file
+    #
+    # A LocationScenarioReference is a reference to a simulated GPS location associated
+    # with a scheme's launch action
+    #
+    class LocationScenarioReference < XMLElementWrapper
+      # @param [Xcodeproj::Project::Object::AbstractTarget, REXML::Element] target_or_node
+      #        Either the Xcode target to reference,
+      #        or an existing XML 'LocationScenarioReference' node element to reference
+      #
+      def initialize(target_or_node)
+        create_xml_element_with_fallback(target_or_node, 'LocationScenarioReference') do
+          self.identifier = ''
+          self.reference_type = '0'
+        end
+      end
+
+      # @return [String]
+      #         The identifier of a built-in location scenario reference, or a path to a GPX file
+      #
+      def identifier
+        @xml_element.attributes['identifier']
+      end
+
+      # @param [String] value
+      #        Set the identifier for the location scenario reference
+      #
+      def identifier=(value)
+        @xml_element.attributes['identifier'] = value
+      end
+
+      # @return [String]
+      #         The reference type is 0 when using a custom GPX file, or 1 when using a built-in location reference
+      #
+      def reference_type
+        @xml_element.attributes['referenceType']
+      end
+
+      # @param [String] value
+      #        Set the reference type for the location scenario reference
+      #
+      def reference_type=(value)
+        @xml_element.attributes['referenceType'] = value
+      end
+    end
+  end
+end

data/lib/xcodeproj/scheme/profile_action.rb

@@ -11,14 +11,14 @@ module Xcodeproj
       #
       def initialize(node = nil)
         create_xml_element_with_fallback(node, 'ProfileAction') do
+          # Setup default values for other (handled) attributes
+          self.build_configuration = 'Release'
+          self.should_use_launch_scheme_args_env = true
+
           # Add some attributes (that are not handled by this wrapper class yet but expected in the XML)
           @xml_element.attributes['savedToolIdentifier'] = ''
           @xml_element.attributes['useCustomWorkingDirectory'] = bool_to_string(false)
           @xml_element.attributes['debugDocumentVersioning'] = bool_to_string(true)
-
-          # Setup default values for other (handled) attributes
-          self.build_configuration = 'Release'
-          self.should_use_launch_scheme_args_env = true
         end
       end
 
@@ -42,7 +42,7 @@ module Xcodeproj
       #         The BuildableProductRunnable to launch when launching the Profile action
       #
       def buildable_product_runnable
-        BuildableProductRunnable.new @xml_element.elements['BuildableProductRunnable']
+        BuildableProductRunnable.new @xml_element.elements['BuildableProductRunnable'], 0
       end
 
       # @param [BuildableProductRunnable] runnable

data/lib/xcodeproj/scheme/send_email_action_content.rb

@@ -0,0 +1,84 @@
+module Xcodeproj
+  class XCScheme
+    # This class wraps a 'ActionContent' node of type
+    # 'Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.SendEmailAction' of a .xcscheme XML file
+    #
+    class SendEmailActionContent < XMLElementWrapper
+      # @param [REXML::Element] node
+      #        The 'ActionContent' XML node that this object will wrap.
+      #        If nil, will create a default XML node to use.
+      #
+      def initialize(node = nil)
+        create_xml_element_with_fallback(node, 'ActionContent') do
+          self.title = 'Send Email'
+          # For some reason this is not visible in Xcode's UI and it's always set to 'NO'
+          # couldn't find much documentation on it so it might be safer to keep it read only
+          @xml_element.attributes['attachLogToEmail'] = 'NO'
+        end
+      end
+
+      # @return [Bool]
+      #         Whether or not this action should attach log to email
+      #
+      def attach_log_to_email?
+        string_to_bool(@xml_element.attributes['attachLogToEmail'])
+      end
+
+      # @return [String]
+      #         The title of this ActionContent
+      #
+      def title
+        @xml_element.attributes['title']
+      end
+
+      # @param [String] value
+      #        Set the title of this ActionContent
+      #
+      def title=(value)
+        @xml_element.attributes['title'] = value
+      end
+
+      # @return [String]
+      #         The email recipient of this ActionContent
+      #
+      def email_recipient
+        @xml_element.attributes['emailRecipient']
+      end
+
+      # @param [String] value
+      #        Set the email recipient of this ActionContent
+      #
+      def email_recipient=(value)
+        @xml_element.attributes['emailRecipient'] = value
+      end
+
+      # @return [String]
+      #         The email subject of this ActionContent
+      #
+      def email_subject
+        @xml_element.attributes['emailSubject']
+      end
+
+      # @param [String] value
+      #        Set the email subject of this ActionContent
+      #
+      def email_subject=(value)
+        @xml_element.attributes['emailSubject'] = value
+      end
+
+      # @return [String]
+      #         The email body of this ActionContent
+      #
+      def email_body
+        @xml_element.attributes['emailBody']
+      end
+
+      # @param [String] value
+      #        Set the email body of this ActionContent
+      #
+      def email_body=(value)
+        @xml_element.attributes['emailBody'] = value
+      end
+    end
+  end
+end

data/lib/xcodeproj/scheme/shell_script_action_content.rb

@@ -0,0 +1,77 @@
+module Xcodeproj
+  class XCScheme
+    # This class wraps a 'ActionContent' node of type
+    # 'Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.ShellScriptAction' of a .xcscheme XML file
+    #
+    class ShellScriptActionContent < XMLElementWrapper
+      # @param [REXML::Element] node
+      #        The 'ActionContent' XML node that this object will wrap.
+      #        If nil, will create a default XML node to use.
+      #
+      def initialize(node = nil)
+        create_xml_element_with_fallback(node, 'ActionContent') do
+          self.title = 'Run Script'
+        end
+      end
+
+      # @return [String]
+      #         The title of this ActionContent
+      #
+      def title
+        @xml_element.attributes['title']
+      end
+
+      # @param [String] value
+      #        Set the title of this ActionContent
+      #
+      def title=(value)
+        @xml_element.attributes['title'] = value
+      end
+
+      # @return [String]
+      #         The contents of the shell script represented by this ActionContent
+      #
+      def script_text
+        @xml_element.attributes['scriptText']
+      end
+
+      # @param [String] value
+      #         Set the contents of the shell script represented by this ActionContent
+      #
+      def script_text=(value)
+        @xml_element.attributes['scriptText'] = value
+      end
+
+      # @return [String]
+      #         The preferred shell to invoke with this ActionContent
+      #
+      def shell_to_invoke
+        @xml_element.attributes['shellToInvoke']
+      end
+
+      # @param [String] value
+      #        Set the preferred shell to invoke with this ActionContent
+      #
+      def shell_to_invoke=(value)
+        @xml_element.attributes['shellToInvoke'] = value
+      end
+
+      # @return [BuildableReference]
+      #         The BuildableReference (Xcode target) associated with this ActionContent
+      #
+      def buildable_reference
+        BuildableReference.new(@xml_element.elements['EnvironmentBuildable'].elements['BuildableReference'])
+      end
+
+      # @param [BuildableReference] ref
+      #        Set the BuildableReference (Xcode target) associated with this ActionContent
+      #
+      def buildable_reference=(ref)
+        @xml_element.delete_element('EnvironmentBuildable')
+
+        env_buildable = @xml_element.add_element('EnvironmentBuildable')
+        env_buildable.add_element(ref.xml_element)
+      end
+    end
+  end
+end

data/lib/xcodeproj/scheme/test_action.rb

@@ -11,11 +11,11 @@ module Xcodeproj
       #
       def initialize(node = nil)
         create_xml_element_with_fallback(node, 'TestAction') do
+          self.build_configuration = 'Debug'
           @xml_element.attributes['selectedDebuggerIdentifier'] = 'Xcode.DebuggerFoundation.Debugger.LLDB'
           @xml_element.attributes['selectedLauncherIdentifier'] = 'Xcode.DebuggerFoundation.Launcher.LLDB'
-          @xml_element.add_element('AdditionalOptions')
           self.should_use_launch_scheme_args_env = true
-          self.build_configuration = 'Debug'
+          @xml_element.add_element('Testables')
         end
       end
 
@@ -109,7 +109,11 @@ module Xcodeproj
       #        Add a MacroExpansion to this TestAction
       #
       def add_macro_expansion(macro_expansion)
-        @xml_element.add_element(macro_expansion.xml_element)
+        if testables = @xml_element.elements['Testables']
+          @xml_element.insert_before(testables, macro_expansion.xml_element)
+        else
+          @xml_element.add_element(macro_expansion.xml_element)
+        end
       end
 
       # @return [EnvironmentVariables]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: xcodeproj
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Eloy Duran
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-10-09 00:00:00.000000000 Z
+date: 2021-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: atomos
@@ -92,6 +92,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.3.0
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.4
 description: Xcodeproj lets you create and modify Xcode projects from Ruby. Script
   boring management tasks or build Xcode-friendly libraries. Also includes support
   for Xcode workspaces (.xcworkspace) and configuration files (.xcconfig).
@@ -152,10 +166,14 @@ files:
 - lib/xcodeproj/scheme/buildable_reference.rb
 - lib/xcodeproj/scheme/command_line_arguments.rb
 - lib/xcodeproj/scheme/environment_variables.rb
+- lib/xcodeproj/scheme/execution_action.rb
 - lib/xcodeproj/scheme/launch_action.rb
+- lib/xcodeproj/scheme/location_scenario_reference.rb
 - lib/xcodeproj/scheme/macro_expansion.rb
 - lib/xcodeproj/scheme/profile_action.rb
 - lib/xcodeproj/scheme/remote_runnable.rb
+- lib/xcodeproj/scheme/send_email_action_content.rb
+- lib/xcodeproj/scheme/shell_script_action_content.rb
 - lib/xcodeproj/scheme/test_action.rb
 - lib/xcodeproj/scheme/xml_element_wrapper.rb
 - lib/xcodeproj/user_interface.rb
@@ -183,7 +201,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.0.3
 signing_key:
 specification_version: 3
 summary: Create and modify Xcode projects from Ruby.