class Fastlane::Actions::XcodeInstallAction

Public Class Methods

authors() click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 89
def self.authors
  ["Krausefx"]
end
available_options() click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 45
def self.available_options
  user = CredentialsManager::AppfileConfig.try_fetch_value(:apple_dev_portal_id)
  user ||= CredentialsManager::AppfileConfig.try_fetch_value(:apple_id)

  [
    FastlaneCore::ConfigItem.new(key: :version,
                                 env_name: "FL_XCODE_VERSION",
                                 description: "The version number of the version of Xcode to install"),
    FastlaneCore::ConfigItem.new(key: :username,
                                 short_option: "-u",
                                 env_name: "XCODE_INSTALL_USER",
                                 description: "Your Apple ID Username",
                                 default_value: user,
                                 default_value_dynamic: true),
    FastlaneCore::ConfigItem.new(key: :team_id,
                                 short_option: "-b",
                                 env_name: "XCODE_INSTALL_TEAM_ID",
                                 description: "The ID of your team if you're in multiple teams",
                                 optional: true,
                                 code_gen_sensitive: true,
                                 default_value: CredentialsManager::AppfileConfig.try_fetch_value(:team_id),
                                 default_value_dynamic: true),
    FastlaneCore::ConfigItem.new(key: :download_retry_attempts,
                                 env_name: "XCODE_INSTALL_DOWNLOAD_RETRY_ATTEMPTS",
                                 description: "Number of times the download will be retried in case of failure",
                                 type: Integer,
                                 default_value: 3)
  ]
end
category() click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 103
def self.category
  :building
end
description() click to toggle source

@!group Documentation

# File fastlane/lib/fastlane/actions/xcode_install.rb, line 37
def self.description
  "Make sure a certain version of Xcode is installed"
end
details() click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 41
def self.details
  "Makes sure a specific version of Xcode is installed. If that's not the case, it will automatically be downloaded by the [xcode_install](https://github.com/neonichu/xcode-install) gem. This will make sure to use the correct Xcode for later actions."
end
example_code() click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 97
def self.example_code
  [
    'xcode_install(version: "7.1")'
  ]
end
is_supported?(platform) click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 93
def self.is_supported?(platform)
  [:ios, :mac].include?(platform)
end
output() click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 75
def self.output
  [
    ['XCODE_INSTALL_XCODE_PATH', 'The path to the newly installed Xcode']
  ]
end
return_type() click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 85
def self.return_type
  :string
end
return_value() click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 81
def self.return_value
  "The path to the newly installed Xcode version"
end
run(params) click to toggle source
# File fastlane/lib/fastlane/actions/xcode_install.rb, line 8
def self.run(params)
  Actions.verify_gem!('xcode-install')

  ENV["XCODE_INSTALL_USER"] = params[:username]
  ENV["XCODE_INSTALL_TEAM_ID"] = params[:team_id]

  require 'xcode/install'
  installer = XcodeInstall::Installer.new

  if installer.installed?(params[:version])
    UI.success("Xcode #{params[:version]} is already installed ✨")
  else
    installer.install_version(params[:version], true, true, true, true, nil, true, nil, params[:download_retry_attempts])
  end

  xcode = installer.installed_versions.find { |x| x.version == params[:version] }
  UI.user_error!("Could not find Xcode with version '#{params[:version]}'") unless xcode
  UI.message("Using Xcode #{params[:version]} on path '#{xcode.path}'")
  xcode.approve_license

  ENV["DEVELOPER_DIR"] = File.join(xcode.path, "/Contents/Developer")
  Actions.lane_context[SharedValues::XCODE_INSTALL_XCODE_PATH] = xcode.path
  return xcode.path
end