fastlane 2.196.0 → 2.212.2

data/fastlane/lib/fastlane/actions/trainer.rb

@@ -0,0 +1,49 @@
+module Fastlane
+  module Actions
+    class TrainerAction < Action
+      def self.run(params)
+        require "trainer"
+
+        params[:path] = Actions.lane_context[Actions::SharedValues::SCAN_GENERATED_PLIST_FILE] if Actions.lane_context[Actions::SharedValues::SCAN_GENERATED_PLIST_FILE]
+        params[:path] ||= Actions.lane_context[Actions::SharedValues::SCAN_DERIVED_DATA_PATH] if Actions.lane_context[Actions::SharedValues::SCAN_DERIVED_DATA_PATH]
+
+        fail_build = params[:fail_build]
+        resulting_paths = Trainer::TestParser.auto_convert(params)
+        resulting_paths.each do |path, test_results|
+          UI.test_failure!("Unit tests failed") if fail_build && !test_results[:successful]
+        end
+
+        return resulting_paths
+      end
+
+      def self.description
+        "Convert the Xcode plist log to a JUnit report"
+      end
+
+      def self.detail
+        "Convert the Xcode plist log to a JUnit report. This will raise an exception if the tests failed"
+      end
+
+      def self.authors
+        ["KrauseFx"]
+      end
+
+      def self.return_value
+        "A hash with the key being the path of the generated file, the value being if the tests were successful"
+      end
+
+      def self.available_options
+        require 'trainer'
+        FastlaneCore::CommanderGenerator.new.generate(Trainer::Options.available_options)
+      end
+
+      def self.is_supported?(platform)
+        %i[ios mac].include?(platform)
+      end
+
+      def self.category
+        :testing
+      end
+    end
+  end
+end

data/fastlane/lib/fastlane/actions/update_code_signing_settings.rb

@@ -36,20 +36,28 @@ module Fastlane
             end
 
             style_value = params[:use_automatic_signing] ? 'Automatic' : 'Manual'
+            development_team_setting = params[:sdk] ? "DEVELOPMENT_TEAM[sdk=#{params[:sdk]}]" : "DEVELOPMENT_TEAM"
+            code_sign_identity_setting = params[:sdk] ? "CODE_SIGN_IDENTITY[sdk=#{params[:sdk]}]" : "CODE_SIGN_IDENTITY"
+            provisioning_profile_setting = params[:sdk] ? "PROVISIONING_PROFILE_SPECIFIER[sdk=#{params[:sdk]}]" : "PROVISIONING_PROFILE_SPECIFIER"
+
             set_build_setting(config, "CODE_SIGN_STYLE", style_value)
 
             if params[:team_id]
-              set_build_setting(config, "DEVELOPMENT_TEAM", params[:team_id])
+              set_build_setting(config, development_team_setting, params[:team_id])
               UI.important("Set Team id to: #{params[:team_id]} for target: #{target.name} for build configuration: #{config.name}")
             end
             if params[:code_sign_identity]
-              set_build_setting(config, "CODE_SIGN_IDENTITY", params[:code_sign_identity])
+              set_build_setting(config, code_sign_identity_setting, params[:code_sign_identity])
               UI.important("Set Code Sign identity to: #{params[:code_sign_identity]} for target: #{target.name} for build configuration: #{config.name}")
             end
             if params[:profile_name]
-              set_build_setting(config, "PROVISIONING_PROFILE_SPECIFIER", params[:profile_name])
+              set_build_setting(config, provisioning_profile_setting, params[:profile_name])
               UI.important("Set Provisioning Profile name to: #{params[:profile_name]} for target: #{target.name} for build configuration: #{config.name}")
             end
+            if params[:entitlements_file_path]
+              set_build_setting(config, "CODE_SIGN_ENTITLEMENTS", params[:entitlements_file_path])
+              UI.important("Set Entitlements file path to: #{params[:entitlements_file_path]} for target: #{target.name} for build configuration: #{config.name}")
+            end
             # Since Xcode 8, this is no longer needed, you simply use PROVISIONING_PROFILE_SPECIFIER
             if params[:profile_uuid]
               set_build_setting(config, "PROVISIONING_PROFILE", params[:profile_uuid])
@@ -125,6 +133,10 @@ module Fastlane
                                        description: "Defines if project should use automatic signing",
                                        type: Boolean,
                                        default_value: false),
+          FastlaneCore::ConfigItem.new(key: :sdk,
+                                       env_name: "FASTLANE_BUILD_SDK",
+                                       optional: true,
+                                       description: "Build target SDKs (iphoneos*, macosx*, iphonesimulator*)"),
           FastlaneCore::ConfigItem.new(key: :team_id,
                                        env_name: "FASTLANE_TEAM_ID",
                                        optional: true,
@@ -143,6 +155,10 @@ module Fastlane
                                        env_name: "FL_CODE_SIGN_IDENTITY",
                                        description: "Code signing identity type (iPhone Developer, iPhone Distribution)",
                                        optional: true),
+          FastlaneCore::ConfigItem.new(key: :entitlements_file_path,
+                                       env_name: "FL_CODE_SIGN_ENTITLEMENTS_FILE_PATH",
+                                       description: "Path to your entitlements file",
+                                       optional: true),
           FastlaneCore::ConfigItem.new(key: :profile_name,
                                        env_name: "FL_PROVISIONING_PROFILE_SPECIFIER",
                                        description: "Provisioning profile name to use for code signing",
@@ -172,6 +188,17 @@ module Fastlane
           update_code_signing_settings(
             use_automatic_signing: true,
             path: "demo-project/demo/demo.xcodeproj"
+          )',
+          ' # more advanced manual code signing
+          update_code_signing_settings(
+            use_automatic_signing: false,
+            path: "demo-project/demo/demo.xcodeproj",
+            team_id: "QABC123DEV",
+            bundle_identifier: "com.demoapp.QABC123DEV",
+            code_sign_identity: "iPhone Distribution",
+            sdk: "iphoneos*",
+            profile_name: "Demo App Deployment Profile",
+            entitlements_file_path: "Demo App/generated/New.entitlements"
           )'
         ]
       end
@@ -185,7 +212,7 @@ module Fastlane
       end
 
       def self.authors
-        ["mathiasAichinger", "hjanuschka", "p4checo", "portellaa", "aeons", "att55"]
+        ["mathiasAichinger", "hjanuschka", "p4checo", "portellaa", "aeons", "att55", "abcdev"]
       end
 
       def self.is_supported?(platform)

data/fastlane/lib/fastlane/actions/update_info_plist.rb

@@ -80,7 +80,7 @@ module Fastlane
                                        description: "Path to info plist",
                                        optional: true,
                                        verify_block: proc do |value|
-                                         UI.user_error!("Invalid plist file") unless value[-6..-1].casecmp(".plist").zero?
+                                         UI.user_error!("Invalid plist file") unless value.downcase.end_with?(".plist")
                                        end),
           FastlaneCore::ConfigItem.new(key: :scheme,
                                        env_name: "FL_UPDATE_PLIST_APP_SCHEME",

data/fastlane/lib/fastlane/actions/update_project_provisioning.rb

@@ -19,7 +19,7 @@ module Fastlane
         UI.user_error!("Could not find path to project config '#{project_file_path}'. Pass the path to your project (not workspace)!") unless File.exist?(project_file_path)
 
         # download certificate
-        unless File.exist?(params[:certificate])
+        unless File.exist?(params[:certificate]) && File.size(params[:certificate]) > 0
           UI.message("Downloading root certificate from (#{ROOT_CERTIFICATE_URL}) to path '#{params[:certificate]}'")
           File.open(params[:certificate], "w:ASCII-8BIT") do |file|
             file.write(FastlaneCore::Helper.open_uri(ROOT_CERTIFICATE_URL, "rb").read)
@@ -34,7 +34,9 @@ module Fastlane
         UI.user_error!("Could not find valid certificate at '#{params[:certificate]}'") unless File.size(params[:certificate]) > 0
         cert = OpenSSL::X509::Certificate.new(File.read(params[:certificate]))
         store.add_cert(cert)
+
         p7.verify([cert], store)
+        check_verify!(p7)
         data = Plist.parse_xml(p7.data)
 
         target_filter = params[:target_filter] || params[:build_configuration_filter]
@@ -81,6 +83,13 @@ module Fastlane
         UI.success("Successfully updated project settings in '#{folder}'")
       end
 
+      def self.check_verify!(p7)
+        failed_to_verify = (p7.data.nil? || p7.data == "") && !(p7.error_string || "").empty?
+        if failed_to_verify
+          UI.crash!("Profile could not be verified with error: '#{p7.error_string}'. Try regenerating provisioning profile.")
+        end
+      end
+
       def self.description
         "Update projects code signing settings from your provisioning profile"
       end

data/fastlane/lib/fastlane/actions/upload_symbols_to_sentry.rb

@@ -48,7 +48,7 @@ module Fastlane
           upload_dsym(resource, dsym)
         end
 
-        # Return uplaoded dSYM paths
+        # Return uploaded dSYM paths
         uploaded_paths
       end
 

data/fastlane/lib/fastlane/actions/verify_build.rb

@@ -101,7 +101,7 @@ module Fastlane
           UI.user_error!("Mismatched team_identifier. Required: '#{params[:team_identifier]}'; Found: '#{values['team_identifier']}'") unless params[:team_identifier] == values['team_identifier']
         end
         if params[:team_name]
-          UI.user_error!("Mismatched team_name. Required: '#{params[:team_name]}'; Found: 'values['team_name']'") unless params[:team_name] == values['team_name']
+          UI.user_error!("Mismatched team_name. Required: '#{params[:team_name]}'; Found: '#{values['team_name']}'") unless params[:team_name] == values['team_name']
         end
         if params[:app_name]
           UI.user_error!("Mismatched app_name. Required: '#{params[:app_name]}'; Found: '#{values['app_name']}'") unless params[:app_name] == values['app_name']

data/fastlane/lib/fastlane/actions/xcode_install.rb

@@ -101,7 +101,11 @@ module Fastlane
       end
 
       def self.category
-        :building
+        :deprecated
+      end
+
+      def self.deprecated_notes
+        "The xcode-install gem, which this action depends on, has been sunset. Please migrate to [xcodes](https://docs.fastlane.tools/actions/xcodes). You can find a migration guide here: [xcpretty/xcode-install/MIGRATION.md](https://github.com/xcpretty/xcode-install/blob/master/MIGRATION.md)"
       end
     end
   end

data/fastlane/lib/fastlane/actions/xcode_select.rb

@@ -40,7 +40,7 @@ module Fastlane
       def self.details
         [
           "Select and build with the Xcode installed at the provided path.",
-          "Use the `xcversion` action if you want to select an Xcode:",
+          "Use the `xcodes` action if you want to select an Xcode:",
           "- Based on a version specifier or",
           "- You don't have known, stable paths, as may happen in a CI environment."
         ].join("\n")

data/fastlane/lib/fastlane/actions/xcodebuild.rb

@@ -267,10 +267,11 @@ module Fastlane
 
         output_result = ""
 
+        override_architecture_prefix = params[:xcodebuild_architecture] ? "arch -#{params[:xcodebuild_architecture]} " : ""
         # In some cases the simulator is not booting up in time
         # One way to solve it is to try to rerun it for one more time
         begin
-          output_result = Actions.sh "set -o pipefail && xcodebuild #{xcodebuild_args} #{pipe_command}"
+          output_result = Actions.sh "set -o pipefail && #{override_architecture_prefix}xcodebuild #{xcodebuild_args} #{pipe_command}"
         rescue => ex
           exit_status = $?.exitstatus
 
@@ -383,8 +384,9 @@ module Fastlane
           ['scheme', 'The scheme to build'],
           ['build_settings', 'Hash of additional build information'],
           ['xcargs', 'Pass additional xcodebuild options'],
-          ['output_style', 'Set the output format to one of: :standard (Colored UTF8 output, default), :basic (black & white ASCII output)'],
           ['buildlog_path', 'The path where the xcodebuild.log will be created, by default it is created in ~/Library/Logs/fastlane/xcbuild'],
+          ['output_style', 'Set the output format to one of: :standard (Colored UTF8 output, default), :basic (black & white ASCII output)'],
+          ['xcodebuild_architecture', 'Allows to set the architecture that `xcodebuild` is run with, for example to force it to run under Rosetta on an Apple Silicon mac'],
           ['raw_buildlog', 'Set to true to see xcodebuild raw output. Default value is false'],
           ['xcpretty_output', 'specifies the output type for xcpretty. eg. \'test\', or \'simple\''],
           ['xcpretty_utf', 'Specifies xcpretty should use utf8 when reporting builds. This has no effect when raw_buildlog is specified.']
@@ -437,6 +439,7 @@ module Fastlane
           ['build_settings', 'Hash of additional build information'],
           ['xcargs', 'Pass additional xcodebuild options'],
           ['output_style', 'Set the output format to one of: :standard (Colored UTF8 output, default), :basic (black & white ASCII output)'],
+          ['xcodebuild_architecture', 'Allows to set the architecture that `xcodebuild` is run with, for example to force it to run under Rosetta on an Apple Silicon mac'],
           ['buildlog_path', 'The path where the xcodebuild.log will be created, by default it is created in ~/Library/Logs/fastlane/xcbuild'],
           ['raw_buildlog', 'Set to true to see xcodebuild raw output. Default value is false'],
           ['xcpretty_output', 'specifies the output type for xcpretty. eg. \'test\', or \'simple\''],
@@ -529,6 +532,7 @@ module Fastlane
           ['build_settings', 'Hash of additional build information'],
           ['xcargs', 'Pass additional xcodebuild options'],
           ['output_style', 'Set the output format to one of: :standard (Colored UTF8 output, default), :basic (black & white ASCII output)'],
+          ['xcodebuild_architecture', 'Allows to set the architecture that `xcodebuild` is run with, for example to force it to run under Rosetta on an Apple Silicon mac'],
           ['buildlog_path', 'The path where the xcodebuild.log will be created, by default it is created in ~/Library/Logs/fastlane/xcbuild'],
           ['raw_buildlog', 'Set to true to see xcodebuild raw output. Default value is false'],
           ['xcpretty_output', 'specifies the output type for xcpretty. eg. \'test\', or \'simple\''],
@@ -571,6 +575,7 @@ module Fastlane
           ['build_settings', 'Hash of additional build information'],
           ['xcargs', 'Pass additional xcodebuild options'],
           ['output_style', 'Set the output format to one of: :standard (Colored UTF8 output, default), :basic (black & white ASCII output)'],
+          ['xcodebuild_architecture', 'Allows to set the architecture that `xcodebuild` is run with, for example to force it to run under Rosetta on an Apple Silicon mac'],
           ['buildlog_path', 'The path where the xcodebuild.log will be created, by default it is created in ~/Library/Logs/fastlane/xcbuild'],
           ['raw_buildlog', 'Set to true to see xcodebuild raw output. Default value is false'],
           ['xcpretty_output', 'specifies the output type for xcpretty. eg. \'test\', or \'simple\''],
@@ -621,6 +626,7 @@ module Fastlane
           ['destination_timeout', 'The timeout for connecting to the simulator, in seconds'],
           ['enable_code_coverage', 'Turn code coverage on or off when testing. eg. true|false. Requires Xcode 7+'],
           ['output_style', 'Set the output format to one of: :standard (Colored UTF8 output, default), :basic (black & white ASCII output)'],
+          ['xcodebuild_architecture', 'Allows to set the architecture that `xcodebuild` is run with, for example to force it to run under Rosetta on an Apple Silicon mac'],
           ['buildlog_path', 'The path where the xcodebuild.log will be created, by default it is created in ~/Library/Logs/fastlane/xcbuild'],
           ['raw_buildlog', 'Set to true to see xcodebuild raw output. Default value is false'],
           ['xcpretty_output', 'specifies the output type for xcpretty. eg. \'test\', or \'simple\''],

data/fastlane/lib/fastlane/actions/xcodes.rb

@@ -0,0 +1,152 @@
+module Fastlane
+  module Actions
+    module SharedValues
+      XCODES_XCODE_PATH = :XCODES_XCODE_PATH
+    end
+
+    class XcodesAction < Action
+      def self.run(params)
+        binary = params[:binary_path]
+        xcodes_raw_version = Actions.sh("#{binary} version", log: false)
+        xcodes_version = Gem::Version.new(xcodes_raw_version)
+        UI.message("Running xcodes version #{xcodes_version}")
+        if xcodes_version < Gem::Version.new("1.1.0")
+          UI.user_error!([
+            "xcodes action requires the minimum version of xcodes binary to be v1.1.0.",
+            "Please update xcodes. If you installed it via Homebrew, this can be done via 'brew upgrade xcodes'"
+          ].join(" "))
+        end
+
+        version = params[:version]
+        command = []
+        command << binary
+
+        if (xcodes_args = params[:xcodes_args])
+          command << xcodes_args
+          Actions.sh(command.join(" "))
+        elsif !params[:select_for_current_build_only]
+          command << "install"
+          command << "'#{version}'"
+          command << "--update" if params[:update_list]
+          command << "--select"
+          Actions.sh(command.join(" "))
+        end
+
+        command = []
+        command << binary
+        command << "installed"
+        command << "'#{version}'"
+
+        # `installed <version>` will either return the path to the given
+        # version or fail because the version can't be found.
+        #
+        # Store the path if we get one, fail the action otherwise.
+        xcode_path = Actions.sh(command.join(" ")) do |status, result, sh_command|
+          formatted_result = result.chomp
+
+          unless status.success?
+            UI.user_error!("Command `#{sh_command}` failed with status #{status.exitstatus} and message: #{formatted_result}")
+          end
+
+          formatted_result
+        end
+
+        # If the command succeeded, `xcode_path` will be something like:
+        # /Applications/Xcode-14.app
+        xcode_developer_path = File.join(xcode_path, "/Contents/Developer")
+
+        UI.message("Setting Xcode version '#{version}' at '#{xcode_path}' for all build steps")
+        ENV["DEVELOPER_DIR"] = xcode_developer_path
+        Actions.lane_context[SharedValues::XCODES_XCODE_PATH] = xcode_developer_path
+        return xcode_path
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.description
+        "Make sure a certain version of Xcode is installed, installing it only if needed"
+      end
+
+      def self.details
+        [
+          "Makes sure a specific version of Xcode is installed. If that's not the case, it will automatically be downloaded by [xcodes](https://github.com/RobotsAndPencils/xcodes).",
+          "This will make sure to use the correct Xcode version for later actions.",
+          "Note that this action depends on [xcodes](https://github.com/RobotsAndPencils/xcodes) CLI, so make sure you have it installed in your environment. For the installation guide, see: https://github.com/RobotsAndPencils/xcodes#installation"
+        ].join("\n")
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :version,
+                                       env_name: "FL_XCODE_VERSION",
+                                       description: "The version number of the version of Xcode to install. Defaults to the value specified in the .xcode-version file",
+                                       default_value: Helper::XcodesHelper.read_xcode_version_file,
+                                       default_value_dynamic: true,
+                                       verify_block: Helper::XcodesHelper::Verify.method(:requirement)),
+          FastlaneCore::ConfigItem.new(key: :update_list,
+                                       env_name: "FL_XCODES_UPDATE_LIST",
+                                       description: "Whether the list of available Xcode versions should be updated before running the install command",
+                                       type: Boolean,
+                                       default_value: true),
+          FastlaneCore::ConfigItem.new(key: :select_for_current_build_only,
+                                       env_name: "FL_XCODES_SELECT_FOR_CURRENT_BUILD_ONLY",
+                                       description: [
+                                         "When true, it won't attempt to install an Xcode version, just find the installed Xcode version that best matches the passed version argument, and select it for the current build steps.",
+                                         "It doesn't change the global Xcode version (e.g. via 'xcrun xcode-select'), which would require sudo permissions — when this option is true, this action doesn't require sudo permissions"
+                                       ].join(" "),
+                                       type: Boolean,
+                                       default_value: false),
+          FastlaneCore::ConfigItem.new(key: :binary_path,
+                                       env_name: "FL_XCODES_BINARY_PATH",
+                                       description: "Where the xcodes binary lives on your system (full path)",
+                                       default_value: Helper::XcodesHelper.find_xcodes_binary_path,
+                                       default_value_dynamic: true,
+                                       verify_block: proc do |value|
+                                         UI.user_error!("'xcodes' doesn't seem to be installed. Please follow the installation guide at https://github.com/RobotsAndPencils/xcodes#installation before proceeding") if value.empty?
+                                         UI.user_error!("Couldn't find xcodes binary at path '#{value}'") unless File.exist?(value)
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :xcodes_args,
+                                       env_name: "FL_XCODES_ARGS",
+                                       description: "Pass in xcodes command line arguments directly. When present, other parameters are ignored and only this parameter is used to build the command to be executed",
+                                       type: :shell_string,
+                                       optional: true)
+        ]
+      end
+
+      def self.output
+        [
+          ['XCODES_XCODE_PATH', 'The path to the newly installed Xcode version']
+        ]
+      end
+
+      def self.return_value
+        "The path to the newly installed Xcode version"
+      end
+
+      def self.return_type
+        :string
+      end
+
+      def self.authors
+        ["rogerluan"]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.example_code
+        [
+          'xcodes(version: "14.1")',
+          'xcodes # When missing, the version value defaults to the value specified in the .xcode-version file'
+        ]
+      end
+
+      def self.category
+        :building
+      end
+    end
+  end
+end

data/fastlane/lib/fastlane/actions/xcov.rb

@@ -5,6 +5,11 @@ module Fastlane
         Actions.verify_gem!('xcov')
         require 'xcov'
 
+        if values[:xccov_file_direct_path].nil? && (path = Actions.lane_context[SharedValues::SCAN_GENERATED_XCRESULT_PATH])
+          UI.verbose("Pulling xcov 'xccov_file_direct_path' from SharedValues::SCAN_GENERATED_XCRESULT_PATH")
+          values[:xccov_file_direct_path] = path
+        end
+
         Xcov::Manager.new(values).run
       end
 

data/fastlane/lib/fastlane/actions/xcversion.rb

@@ -5,6 +5,7 @@ module Fastlane
         Actions.verify_gem!('xcode-install')
 
         version = params[:version]
+
         xcode = Helper::XcversionHelper.find_xcode(version)
         UI.user_error!("Cannot find an installed Xcode satisfying '#{version}'") if xcode.nil?
 
@@ -19,20 +20,24 @@ module Fastlane
       end
 
       def self.details
-        "Finds and selects a version of an installed Xcode that best matches the provided [`Gem::Version` requirement specifier](http://www.rubydoc.info/github/rubygems/rubygems/Gem/Version)"
+        [
+          "Finds and selects a version of an installed Xcode that best matches the provided [`Gem::Version` requirement specifier](http://www.rubydoc.info/github/rubygems/rubygems/Gem/Version)",
+          "You can either manually provide a specific version using `version:` or you make use of the `.xcode-version` file."
+        ].join("\n")
       end
 
       def self.authors
-        ["oysta"]
+        ["oysta", "rogerluan"]
       end
 
       def self.available_options
         [
           FastlaneCore::ConfigItem.new(key: :version,
                                        env_name: "FL_XCODE_VERSION",
-                                       description: "The version of Xcode to select specified as a Gem::Version requirement string (e.g. '~> 7.1.0')",
-                                       optional: false,
-                                       verify_block: Helper::XcversionHelper::Verify.method(:requirement))
+                                       description: "The version of Xcode to select specified as a Gem::Version requirement string (e.g. '~> 7.1.0'). Defaults to the value specified in the .xcode-version file ",
+                                       default_value: Helper::XcodesHelper.read_xcode_version_file,
+                                       default_value_dynamic: true,
+                                       verify_block: Helper::XcodesHelper::Verify.method(:requirement))
         ]
       end
 
@@ -43,12 +48,17 @@ module Fastlane
       def self.example_code
         [
           'xcversion(version: "8.1") # Selects Xcode 8.1.0',
-          'xcversion(version: "~> 8.1.0") # Selects the latest installed version from the 8.1.x set'
+          'xcversion(version: "~> 8.1.0") # Selects the latest installed version from the 8.1.x set',
+          'xcversion # When missing, the version value defaults to the value specified in the .xcode-version file'
         ]
       end
 
       def self.category
-        :building
+        :deprecated
+      end
+
+      def self.deprecated_notes
+        "The xcode-install gem, which this action depends on, has been sunset. Please migrate to [xcodes](https://docs.fastlane.tools/actions/xcodes). You can find a migration guide here: [xcpretty/xcode-install/MIGRATION.md](https://github.com/xcpretty/xcode-install/blob/master/MIGRATION.md)"
       end
     end
   end

data/fastlane/lib/fastlane/cli_tools_distributor.rb

@@ -78,6 +78,7 @@ module Fastlane
         tool_name = ARGV.first ? ARGV.first.downcase : nil
 
         tool_name = process_emojis(tool_name)
+        tool_name = map_aliased_tools(tool_name)
 
         if tool_name && Fastlane::TOOLS.include?(tool_name.to_sym) && !available_lanes.include?(tool_name.to_sym)
           # Triggering a specific tool
@@ -125,6 +126,10 @@ module Fastlane
         FastlaneCore::UpdateChecker.show_update_status('fastlane', Fastlane::VERSION)
       end
 
+      def map_aliased_tools(tool_name)
+        Fastlane::TOOL_ALIASES[tool_name&.to_sym] || tool_name
+      end
+
       # Since loading dotenv should respect additional environments passed using
       # --env, we must extract the arguments out of ARGV and process them before
       # calling into commander. This is required since the ENV must be configured

data/fastlane/lib/fastlane/commands_generator.rb

@@ -36,7 +36,8 @@ module Fastlane
       # do not use "include" as it may be some where in the commandline where "env" is required, therefore explicit index->0
       unless ARGV[0] == "env" || CLIToolsDistributor.running_version_command? || CLIToolsDistributor.running_help_command?
         # *after* loading the plugins
-        Fastlane.plugin_manager.load_plugins
+        hide_plugins_table = FastlaneCore::Env.truthy?("FASTLANE_HIDE_PLUGINS_TABLE")
+        Fastlane.plugin_manager.load_plugins(print_table: !hide_plugins_table)
         Fastlane::PluginUpdateManager.start_looking_for_updates
       end
       self.new.run

data/fastlane/lib/fastlane/documentation/docs_generator.rb

@@ -4,21 +4,18 @@ module Fastlane
       output_path ||= File.join(FastlaneCore::FastlaneFolder.path || '.', 'README.md')
 
       output = ["fastlane documentation"]
-      output << "================"
+      output << "----"
+      output << ""
 
       output << "# Installation"
       output << ""
       output << "Make sure you have the latest version of the Xcode command line tools installed:"
       output << ""
-      output << "```"
+      output << "```sh"
       output << "xcode-select --install"
       output << "```"
       output << ""
-      output << "Install _fastlane_ using"
-      output << "```"
-      output << "[sudo] gem install fastlane -NV"
-      output << "```"
-      output << "or alternatively using `brew install fastlane`"
+      output << "For _fastlane_ installation instructions, see [Installing _fastlane_](https://docs.fastlane.tools/#installing-fastlane)"
       output << ""
       output << "# Available Actions"
 
@@ -32,7 +29,10 @@ module Fastlane
           next
         end
 
-        output << "## #{formatted_platform(platform)}" if platform
+        if platform
+          output << ""
+          output << "## #{formatted_platform(platform)}"
+        end
 
         lanes.each do |lane_name, lane|
           next if lane.is_private
@@ -45,8 +45,10 @@ module Fastlane
       end
 
       output << "This README.md is auto-generated and will be re-generated every time [_fastlane_](https://fastlane.tools) is run."
-      output << "More information about fastlane can be found on [fastlane.tools](https://fastlane.tools)."
-      output << "The documentation of fastlane can be found on [docs.fastlane.tools](https://docs.fastlane.tools)."
+      output << ""
+      output << "More information about _fastlane_ can be found on [fastlane.tools](https://fastlane.tools)."
+      output << ""
+      output << "The documentation of _fastlane_ can be found on [docs.fastlane.tools](https://docs.fastlane.tools)."
       output << ""
 
       begin
@@ -78,10 +80,13 @@ module Fastlane
       full_name = [platform, lane].reject(&:nil?).join(' ')
 
       output = []
+      output << ""
       output << "### #{full_name}"
+      output << ""
+      output << "```sh"
+      output << "[bundle exec] fastlane #{full_name}"
       output << "```"
-      output << "fastlane #{full_name}"
-      output << "```"
+      output << ""
       output << description
       output
     end

data/fastlane/lib/fastlane/fast_file.rb

@@ -338,11 +338,24 @@ module Fastlane
             UI.user_error!("No tag found matching #{version.inspect}") if checkout_param.nil?
           end
 
-          if is_eligible_for_caching && version.nil?
-            # Update the repo if it's eligible for caching but the version isn't specified
-            UI.message("Fetching remote git branches and updating git repo...")
-            Helper.with_env_values('GIT_TERMINAL_PROMPT' => '0') do
-              Actions.sh("cd #{clone_folder.shellescape} && git fetch --all --quiet && git checkout #{checkout_param.shellescape} #{checkout_path} && git reset --hard && git rebase")
+          if is_eligible_for_caching
+            if version.nil?
+              # Update the repo if it's eligible for caching but the version isn't specified
+              UI.message("Fetching remote git branches and updating git repo...")
+              Helper.with_env_values('GIT_TERMINAL_PROMPT' => '0') do
+                Actions.sh("cd #{clone_folder.shellescape} && git fetch --all --quiet && git checkout #{checkout_param.shellescape} #{checkout_path} && git reset --hard && git rebase")
+              end
+            else
+              begin
+                # https://stackoverflow.com/a/1593574/865175
+                current_tag = Actions.sh("cd #{clone_folder.shellescape} && git describe --exact-match --tags HEAD").strip
+              rescue
+                current_tag = nil
+              end
+
+              if current_tag != version
+                Actions.sh("cd #{clone_folder.shellescape} && git checkout #{checkout_param.shellescape} #{checkout_path}")
+              end
             end
           else
             Actions.sh("cd #{clone_folder.shellescape} && git checkout #{checkout_param.shellescape} #{checkout_path}")

data/fastlane/lib/fastlane/features.rb

@@ -5,3 +5,6 @@
 
 FastlaneCore::Feature.register(env_var: 'FASTLANE_ENABLE_BETA_DELIVER_SYNC_SCREENSHOTS',
                                description: 'Use a newly implemented screenshots synchronization logic')
+
+FastlaneCore::Feature.register(env_var: 'FASTLANE_WWDR_USE_HTTP1_AND_RETRIES',
+                               description: 'Adds --http1.1 and --retry 3 --retry-all-errors to the curl command to download WWDR certificates')

data/fastlane/lib/fastlane/helper/xcodebuild_formatter_helper.rb

@@ -0,0 +1,9 @@
+module Fastlane
+  module Helper
+    class XcodebuildFormatterHelper
+      def self.xcbeautify_installed?
+        return `which xcbeautify`.include?("xcbeautify")
+      end
+    end
+  end
+end