module FastlaneCore::Helper
Public Class Methods
Runs a given command using backticks (`) and prints them out using the UI.command method
# File fastlane_core/lib/fastlane_core/helper.rb, line 275 def self.backticks(command, print: true) UI.command(command) if print result = `#{command}` UI.command_output(result) if print return result end
Logs base directory
# File fastlane_core/lib/fastlane_core/helper.rb, line 113 def self.buildlog_path return ENV["FL_BUILDLOG_PATH"] || "~/Library/Logs" end
@return [boolean] true if executing with bundler (like 'bundle exec fastlane [action]')
# File fastlane_core/lib/fastlane_core/helper.rb, line 29 def self.bundler? # Bundler environment variable ['BUNDLE_BIN_PATH', 'BUNDLE_GEMFILE'].each do |current| return true if ENV.key?(current) end return false end
@return [boolean] true if building in a known CI environment
# File fastlane_core/lib/fastlane_core/helper.rb, line 73 def self.ci? # Check for Jenkins, Travis CI, ... environment variables ['JENKINS_HOME', 'JENKINS_URL', 'TRAVIS', 'CIRCLECI', 'CI', 'APPCENTER_BUILD_ID', 'TEAMCITY_VERSION', 'GO_PIPELINE_NAME', 'bamboo_buildKey', 'GITLAB_CI', 'XCS', 'TF_BUILD'].each do |current| return true if ENV.key?(current) end return false end
Do we want to disable the colored output?
# File fastlane_core/lib/fastlane_core/helper.rb, line 103 def self.colors_disabled? FastlaneCore::Env.truthy?("FASTLANE_DISABLE_COLORS") end
Do we run from a bundled fastlane, which contains Ruby and OpenSSL
? Usually this means the fastlane directory is ~/.fastlane/bin/ We set this value via the environment variable `FASTLANE_SELF_CONTAINED`
# File fastlane_core/lib/fastlane_core/helper.rb, line 40 def self.contained_fastlane? ENV["FASTLANE_SELF_CONTAINED"].to_s == "true" && !self.homebrew? end
checks if a given path is an executable file
# File fastlane_core/lib/fastlane_core/helper.rb, line 356 def self.executable?(cmd_path) # no executable files on Windows, so existing is enough there cmd_path && !File.directory?(cmd_path) && (File.executable?(cmd_path) || (self.windows? && File.exist?(cmd_path))) end
fastlane
# File fastlane_core/lib/fastlane_core/helper.rb, line 15 def self.fastlane_enabled? # This is called from the root context on the first start @enabled ||= !FastlaneCore::FastlaneFolder.path.nil? end
Checks if fastlane is enabled for this project and returns the folder where the configuration lives
# File fastlane_core/lib/fastlane_core/helper.rb, line 21 def self.fastlane_enabled_folder_path fastlane_enabled? ? FastlaneCore::FastlaneFolder.path : '.' end
DEPRECATED: Use the `ROOT` constant from the appropriate tool module instead e.g. File.join(Sigh::ROOT, 'lib', 'assets', 'resign.sh')
Path to the installed gem to load resources (e.g. resign.sh)
# File fastlane_core/lib/fastlane_core/helper.rb, line 397 def self.gem_path(gem_name) UI.deprecated('`Helper.gem_path` is deprecated. Use the `ROOT` constant from the appropriate tool module instead.') if !Helper.test? && Gem::Specification.find_all_by_name(gem_name).any? return Gem::Specification.find_by_name(gem_name).gem_dir else return './' end end
# File fastlane_core/lib/fastlane_core/helper.rb, line 346 def self.hide_loading_indicator if self.should_show_loading_indicator? && @require_fastlane_spinner @require_fastlane_spinner.success end end
returns true if fastlane was installed via Homebrew
# File fastlane_core/lib/fastlane_core/helper.rb, line 50 def self.homebrew? ENV["FASTLANE_INSTALLED_VIA_HOMEBREW"].to_s == "true" end
# File fastlane_core/lib/fastlane_core/helper.rb, line 381 def self.is_ci? ci? end
# File fastlane_core/lib/fastlane_core/helper.rb, line 385 def self.is_mac? self.mac? end
Use Helper.test?
, Helper.ci?
, Helper.mac?
or Helper.windows?
instead (legacy calls)
# File fastlane_core/lib/fastlane_core/helper.rb, line 377 def self.is_test? self.test? end
# File fastlane_core/lib/fastlane_core/helper.rb, line 389 def self.is_windows? self.windows? end
@return the full path to the iTMSTransporter executable
# File fastlane_core/lib/fastlane_core/helper.rb, line 201 def self.itms_path return ENV["FASTLANE_ITUNES_TRANSPORTER_PATH"] if FastlaneCore::Env.truthy?("FASTLANE_ITUNES_TRANSPORTER_PATH") if self.mac? # First check for manually install iTMSTransporter user_local_itms_path = "/usr/local/itms" return user_local_itms_path if File.exist?(user_local_itms_path) # Then check for iTMSTransporter in the Xcode path [ "../Applications/Application Loader.app/Contents/MacOS/itms", "../Applications/Application Loader.app/Contents/itms", "../SharedFrameworks/ContentDeliveryServices.framework/Versions/A/itms" # For Xcode 11 ].each do |path| result = File.expand_path(File.join(self.xcode_path, path)) return result if File.exist?(result) end UI.user_error!("Could not find transporter at #{self.xcode_path}. Please make sure you set the correct path to your Xcode installation.") elsif self.windows? [ "C:/Program Files (x86)/itms" ].each do |path| return path if File.exist?(path) end UI.user_error!("Could not find transporter at usual locations. Please use environment variable `FASTLANE_ITUNES_TRANSPORTER_PATH` to specify your installation path.") else # not Mac or Windows return '' end end
checks if given file is a valid json file base taken from: stackoverflow.com/a/26235831/1945875
# File fastlane_core/lib/fastlane_core/helper.rb, line 363 def self.json_file?(filename) return false unless File.exist?(filename) begin JSON.parse(File.read(filename)) return true rescue JSON::ParserError return false end end
keychain
# File fastlane_core/lib/fastlane_core/helper.rb, line 235 def self.keychain_path(keychain_name) # Existing code expects that a keychain name will be expanded into a default path to Library/Keychains # in the user's home directory. However, this will not allow the user to pass an absolute path # for the keychain value # # So, if the passed value can't be resolved as a file in Library/Keychains, just use it as-is # as the keychain path. # # We need to expand each path because File.exist? won't handle directories including ~ properly # # We also try to append `-db` at the end of the file path, as with Sierra the default Keychain name # has changed for some users: https://github.com/fastlane/fastlane/issues/5649 # Remove the ".keychain" at the end of the keychain name name = keychain_name.sub(/\.keychain$/, "") possible_locations = [ File.join(Dir.home, 'Library', 'Keychains', name), name ].map { |path| File.expand_path(path) } # Transforms ["thing"] to ["thing-db", "thing.keychain-db", "thing", "thing.keychain"] keychain_paths = [] possible_locations.each do |location| keychain_paths << "#{location}-db" keychain_paths << "#{location}.keychain-db" keychain_paths << location keychain_paths << "#{location}.keychain" end keychain_path = keychain_paths.find { |path| File.file?(path) } UI.user_error!("Could not locate the provided keychain. Tried:\n\t#{keychain_paths.join("\n\t")}") unless keychain_path keychain_path end
# File fastlane_core/lib/fastlane_core/helper.rb, line 93 def self.linux? (/linux/ =~ RUBY_PLATFORM) != nil end
This method is deprecated, use the `UI` class docs.fastlane.tools/advanced/#user-input-and-output
# File fastlane_core/lib/fastlane_core/helper.rb, line 409 def self.log UI.deprecated("Helper.log is deprecated. Use `UI` class instead") UI.current.log end
Is the currently running computer a Mac?
# File fastlane_core/lib/fastlane_core/helper.rb, line 98 def self.mac? (/darwin/ =~ RUBY_PLATFORM) != nil end
returns true if fastlane was installed from the Fabric Mac app
# File fastlane_core/lib/fastlane_core/helper.rb, line 45 def self.mac_app? ENV["FASTLANE_SELF_CONTAINED"].to_s == "false" end
Does the user use the Mac stock terminal
# File fastlane_core/lib/fastlane_core/helper.rb, line 108 def self.mac_stock_terminal? FastlaneCore::Env.truthy?("TERM_PROGRAM_VERSION") end
# File fastlane_core/lib/fastlane_core/helper.rb, line 81 def self.operating_system return "macOS" if RUBY_PLATFORM.downcase.include?("darwin") return "Windows" if RUBY_PLATFORM.downcase.include?("mswin") return "Linux" if RUBY_PLATFORM.downcase.include?("linux") return "Unknown" end
returns true if fastlane was installed via RubyGems
# File fastlane_core/lib/fastlane_core/helper.rb, line 55 def self.rubygems? !self.bundler? && !self.contained_fastlane? && !self.homebrew? && !self.mac_app? end
@return true if it is enabled to execute external commands
# File fastlane_core/lib/fastlane_core/helper.rb, line 68 def self.sh_enabled? !self.test? end
loading indicator
# File fastlane_core/lib/fastlane_core/helper.rb, line 327 def self.should_show_loading_indicator? return false if FastlaneCore::Env.truthy?("FASTLANE_DISABLE_ANIMATION") return false if Helper.ci? return true end
Show/Hide loading indicator
# File fastlane_core/lib/fastlane_core/helper.rb, line 334 def self.show_loading_indicator(text = nil) if self.should_show_loading_indicator? # we set the default here, instead of at the parameters # as we don't want to `UI.message` a rocket that's just there for the loading indicator text ||= "🚀" @require_fastlane_spinner = TTY::Spinner.new("[:spinner] #{text} ", format: :dots) @require_fastlane_spinner.auto_spin else UI.message(text) if text end end
removes ANSI colors from string
# File fastlane_core/lib/fastlane_core/helper.rb, line 283 def self.strip_ansi_colors(str) str.gsub(/\e\[([;\d]+)?m/, '') end
@return true if the currently running program is a unit test
# File fastlane_core/lib/fastlane_core/helper.rb, line 63 def self.test? Object.const_defined?("SpecHelper") end
iTMSTransporter
# File fastlane_core/lib/fastlane_core/helper.rb, line 174 def self.transporter_java_executable_path return File.join(self.transporter_java_path, 'bin', 'java') end
# File fastlane_core/lib/fastlane_core/helper.rb, line 178 def self.transporter_java_ext_dir return File.join(self.transporter_java_path, 'lib', 'ext') end
# File fastlane_core/lib/fastlane_core/helper.rb, line 182 def self.transporter_java_jar_path return File.join(self.itms_path, 'lib', 'itmstransporter-launcher.jar') end
# File fastlane_core/lib/fastlane_core/helper.rb, line 190 def self.transporter_java_path return File.join(self.itms_path, 'java') end
@return the full path to the iTMSTransporter executable
# File fastlane_core/lib/fastlane_core/helper.rb, line 195 def self.transporter_path return File.join(self.itms_path, 'bin', 'iTMSTransporter') unless Helper.windows? return File.join(self.itms_path, 'iTMSTransporter') end
# File fastlane_core/lib/fastlane_core/helper.rb, line 186 def self.transporter_user_dir return File.join(self.itms_path, 'bin') end
# File fastlane_core/lib/fastlane_core/helper.rb, line 88 def self.windows? # taken from: https://stackoverflow.com/a/171011/1945875 (/cygwin|mswin|mingw|bccwin|wince|emx/ =~ RUBY_PLATFORM) != nil end
Executes the provided block after adjusting the ENV to have the provided keys and values set as defined in hash. After the block completes, restores the ENV to its previous state.
# File fastlane_core/lib/fastlane_core/helper.rb, line 311 def self.with_env_values(hash, &block) old_vals = ENV.select { |k, v| hash.include?(k) } hash.each do |k, v| ENV[k] = hash[k] end yield ensure hash.each do |k, v| ENV.delete(k) unless old_vals.include?(k) ENV[k] = old_vals[k] end end
@return true if Xcode version is higher than 8.3
# File fastlane_core/lib/fastlane_core/helper.rb, line 165 def self.xcode_at_least?(version) FastlaneCore::UI.user_error!("Unable to locate Xcode. Please make sure to have Xcode installed on your machine") if xcode_version.nil? v = xcode_version Gem::Version.new(v) >= Gem::Version.new(version) end
@return the full path to the Xcode developer tools of the currently
running system
# File fastlane_core/lib/fastlane_core/helper.rb, line 122 def self.xcode_path return "" unless self.mac? if self.xcode_server? # Xcode server always creates a link here xcode_server_xcode_path = "/Library/Developer/XcodeServer/CurrentXcodeSymlink/Contents/Developer" UI.verbose("We're running as XcodeServer, setting path to #{xcode_server_xcode_path}") return xcode_server_xcode_path end return `xcode-select -p`.delete("\n") + "/" end
# File fastlane_core/lib/fastlane_core/helper.rb, line 135 def self.xcode_server? # XCS is set by Xcode Server return ENV["XCS"].to_i == 1 end
@return The version of the currently used Xcode installation (e.g. “7.0”)
# File fastlane_core/lib/fastlane_core/helper.rb, line 141 def self.xcode_version return nil unless self.mac? return @xcode_version if @xcode_version && @developer_dir == ENV['DEVELOPER_DIR'] xcodebuild_path = "#{xcode_path}/usr/bin/xcodebuild" xcode_build_installed = File.exist?(xcodebuild_path) unless xcode_build_installed UI.verbose("Couldn't find xcodebuild at #{xcodebuild_path}, check that it exists") return nil end begin output = `DEVELOPER_DIR='' "#{xcodebuild_path}" -version` @xcode_version = output.split("\n").first.split(' ')[1] @developer_dir = ENV['DEVELOPER_DIR'] rescue => ex UI.error(ex) UI.user_error!("Error detecting currently used Xcode installation, please ensure that you have Xcode installed and set it using `sudo xcode-select -s [path]`") end @xcode_version end
Zips directory
# File fastlane_core/lib/fastlane_core/helper.rb, line 288 def self.zip_directory(path, output_path, contents_only: false, overwrite: false, print: true) if overwrite overwrite_command = " && rm -f '#{output_path}'" else overwrite_command = "" end if contents_only command = "cd '#{path}'#{overwrite_command} && zip -r '#{output_path}' *" else containing_path = File.expand_path("..", path) contents_path = File.basename(path) command = "cd '#{containing_path}'#{overwrite_command} && zip -r '#{output_path}' '#{contents_path}'" end UI.command(command) unless print Helper.backticks(command, print: print) end