Module: OS::Mac::Xcode Private
- Extended by:
- T::Sig
- Defined in:
- brew/Library/Homebrew/os/mac/xcode.rb,
brew/Library/Homebrew/os/linux.rb
Overview
This module is part of a private API. You should avoid using this module if possible, as it may be removed or be changed in the future.
Helper module for querying Xcode information.
Constant Summary collapse
- DEFAULT_BUNDLE_PATH =
This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.
Pathname("/Applications/Xcode.app").freeze
- BUNDLE_ID =
This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.
"com.apple.dt.Xcode"
- OLD_BUNDLE_ID =
This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.
"com.apple.Xcode"
Class Method Summary collapse
-
.below_minimum_version? ⇒ Boolean
private
-
.bundle_path ⇒ Object
private
-
.default_prefix? ⇒ Boolean
private
-
.detect_version ⇒ Object
private
-
.detect_version_from_clang_version ⇒ String
private
-
.installed? ⇒ Boolean
private
-
.latest_sdk_version? ⇒ Boolean
private
-
.latest_version ⇒ String
private
Bump these when a new version is available from the App Store and our CI systems have been updated.
-
.minimum_version ⇒ String
private
Bump these if things are badly broken (e.g. no SDK for this macOS) without this.
-
.needs_clt_installed? ⇒ Boolean
private
-
.outdated? ⇒ Boolean
private
-
.prefix ⇒ Object
private
Returns a Pathname object corresponding to Xcode.app’s Developer directory or nil if Xcode.app is not installed.
-
.sdk(v = nil) ⇒ Object
private
-
.sdk_locator ⇒ Object
private
-
.sdk_path(v = nil) ⇒ Object
private
-
.toolchain_path ⇒ Pathname
private
-
.update_instructions ⇒ String
private
-
.version ⇒ Object
private
-
.without_clt? ⇒ Boolean
private
Class Method Details
.below_minimum_version? ⇒ Boolean
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
58 59 60 61 62 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 58 def below_minimum_version? return false unless installed? version < minimum_version end |
.bundle_path ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
110 111 112 113 114 115 116 117 118 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 110 def bundle_path # Use the default location if it exists. return DEFAULT_BUNDLE_PATH if DEFAULT_BUNDLE_PATH.exist? # Ask Spotlight where Xcode is. If the user didn't install the # helper tools and installed Xcode in a non-conventional place, this # is our only option. See: https://superuser.com/questions/390757 MacOS.app_with_bundle_id(BUNDLE_ID, OLD_BUNDLE_ID) end |
.default_prefix? ⇒ Boolean
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
213 214 215 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 213 def default_prefix? prefix.to_s == "/Applications/Xcode.app/Contents/Developer" end |
.detect_version ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 162 def detect_version # This is a separate function as you can't cache the value out of a block # if return is used in the middle, which we do many times in here. return if !MacOS::Xcode.installed? && !MacOS::CLT.installed? %W[ #{prefix}/usr/bin/xcodebuild #{which("xcodebuild")} ].uniq.each do |xcodebuild_path| next unless File.executable? xcodebuild_path xcodebuild_output = Utils.popen_read(xcodebuild_path, "-version") next unless $CHILD_STATUS.success? xcode_version = xcodebuild_output[/Xcode (\d+(\.\d+)*)/, 1] return xcode_version if xcode_version # Xcode 2.x's xcodebuild has a different version string case xcodebuild_output[/DevToolsCore-(\d+\.\d)/, 1] when "798.0" then return "2.5" when "515.0" then return "2.0" end end detect_version_from_clang_version end |
.detect_version_from_clang_version ⇒ String
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 190 def detect_version_from_clang_version return "dunno" if DevelopmentTools.clang_version.null? # This logic provides a fake Xcode version based on the # installed CLT version. This is useful as they are packaged # simultaneously so workarounds need to apply to both based on their # comparable version. case (DevelopmentTools.clang_version.to_f * 10).to_i when 0 then "dunno" when 60 then "6.0" when 61 then "6.1" when 70 then "7.0" when 73 then "7.3" when 80 then "8.0" when 81 then "8.3" when 90 then "9.2" when 91 then "9.4" when 100 then "10.3" when 110 then "11.5" else "12.0" end end |
.installed? ⇒ Boolean
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
121 122 123 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 121 def installed? false end |
.latest_sdk_version? ⇒ Boolean
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
65 66 67 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 65 def latest_sdk_version? OS::Mac.full_version >= OS::Mac.latest_sdk_version end |
.latest_version ⇒ String
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Bump these when a new version is available from the App Store and our CI systems have been updated. This may be a beta version for a beta macOS.
22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 22 def latest_version latest_stable = "12.3" case MacOS.version when "11" then latest_stable when "10.15" then "12.3" when "10.14" then "11.3.1" when "10.13" then "10.1" when "10.12" then "9.2" when "10.11" then "8.2.1" when "10.10" then "7.2.1" when "10.9" then "6.2" else raise "macOS '#{MacOS.version}' is invalid" unless OS::Mac.prerelease? # Default to newest known version of Xcode for unreleased macOS versions. latest_stable end end |
.minimum_version ⇒ String
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Bump these if things are badly broken (e.g. no SDK for this macOS) without this. Generally this will be the first Xcode release on that macOS version (which may initially be a beta if that version of macOS is also in beta).
46 47 48 49 50 51 52 53 54 55 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 46 def minimum_version case MacOS.version when "11" then "12.2" when "10.15" then "11.0" when "10.14" then "10.2" when "10.13" then "9.0" when "10.12" then "8.0" else "2.0" end end |
.needs_clt_installed? ⇒ Boolean
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
70 71 72 73 74 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 70 def needs_clt_installed? return false if latest_sdk_version? without_clt? end |
.outdated? ⇒ Boolean
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
77 78 79 80 81 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 77 def outdated? return false unless installed? version < latest_version end |
.prefix ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Returns a Pathname object corresponding to Xcode.app’s Developer directory or nil if Xcode.app is not installed.
90 91 92 93 94 95 96 97 98 99 100 101 102 103 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 90 def prefix @prefix ||= begin dir = MacOS.active_developer_dir if dir.empty? || dir == CLT::PKG_PATH || !File.directory?(dir) path = bundle_path path/"Contents/Developer" if path else # Use cleanpath to avoid pathological trailing slash Pathname.new(dir).cleanpath end end end |
.sdk(v = nil) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
129 130 131 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 129 def sdk(v = nil) sdk_locator.sdk_if_applicable(v) end |
.sdk_locator ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
125 126 127 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 125 def sdk_locator @sdk_locator ||= XcodeSDKLocator.new end |
.sdk_path(v = nil) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
133 134 135 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 133 def sdk_path(v = nil) sdk(v)&.path end |
.toolchain_path ⇒ Pathname
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
106 107 108 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 106 def toolchain_path Pathname("#{prefix}/Toolchains/XcodeDefault.xctoolchain") end |
.update_instructions ⇒ String
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
138 139 140 141 142 143 144 145 146 147 148 149 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 138 def update_instructions if OS::Mac.prerelease? <<~EOS Xcode can be updated from: #{Formatter.url("https://developer.apple.com/download/more/")} EOS else <<~EOS Xcode can be updated from the App Store. EOS end end |
.version ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
73 74 75 |
# File 'brew/Library/Homebrew/os/linux.rb', line 73 def version Version::NULL end |
.without_clt? ⇒ Boolean
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
84 85 86 |
# File 'brew/Library/Homebrew/os/mac/xcode.rb', line 84 def without_clt? !MacOS::CLT.installed? end |