Module: OS::Mac::Xcode Private

Defined in:
os/mac/xcode.rb,
os/linux.rb

Overview

This module is part of a private API. This module may only be used in the Homebrew/brew repository. Third parties should avoid using this module if possible, as it may be removed or changed without warning.

Helper module for querying Xcode information.

Constant Summary collapse

DEFAULT_BUNDLE_PATH =

This constant is part of a private API. This constant may only be used in the Homebrew/brew repository. Third parties should avoid using this constant if possible, as it may be removed or changed without warning.

Pathname("/Applications/Xcode.app").freeze
BUNDLE_ID =

This constant is part of a private API. This constant may only be used in the Homebrew/brew repository. Third parties should avoid using this constant if possible, as it may be removed or changed without warning.

"com.apple.dt.Xcode"
OLD_BUNDLE_ID =

This constant is part of a private API. This constant may only be used in the Homebrew/brew repository. Third parties should avoid using this constant if possible, as it may be removed or changed without warning.

"com.apple.Xcode"
APPLE_DEVELOPER_DOWNLOAD_URL =

This constant is part of a private API. This constant may only be used in the Homebrew/brew repository. Third parties should avoid using this constant if possible, as it may be removed or changed without warning.

"https://developer.apple.com/download/all/"

Class Method Summary collapse

Class Method Details

.below_minimum_version?Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Boolean)


61
62
63
64
65
# File 'os/mac/xcode.rb', line 61

def below_minimum_version?
  return false unless installed?

  version < minimum_version
end

.bundle_pathPathname?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



123
124
125
126
127
128
129
130
131
# File 'os/mac/xcode.rb', line 123

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. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Boolean)


254
255
256
# File 'os/mac/xcode.rb', line 254

def default_prefix?
  prefix.to_s == "/Applications/Xcode.app/Contents/Developer"
end

.detect_versionString?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
# File 'os/mac/xcode.rb', line 194

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_versionString

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
# File 'os/mac/xcode.rb', line 222

def detect_version_from_clang_version
  version = DevelopmentTools.clang_version

  return "dunno" if 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 version
  when "6.0.0"  then "6.2"
  when "6.1.0"  then "6.4"
  when "7.0.0"  then "7.1"
  when "7.0.2"  then "7.2.1"
  when "7.3.0"  then "7.3.1"
  when "8.0.0"  then "8.2.1"
  when "8.1.0"  then "8.3.3"
  when "9.0.0"  then "9.2"
  when "9.1.0"  then "9.4.1"
  when "10.0.0" then "10.1"
  when "10.0.1" then "10.3"
  when "11.0.0" then "11.3.1"
  when "11.0.3" then "11.7"
  when "12.0.0" then "12.4"
  when "12.0.5" then "12.5.1"
  when "13.0.0" then "13.2.1"
  when "14.0.0" then "14.0"
  else               "13.4"
  end
end

.installation_instructionsString

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



154
155
156
157
158
159
160
161
162
163
164
165
# File 'os/mac/xcode.rb', line 154

def installation_instructions
  if OS::Mac.version.prerelease?
    <<~EOS
      Xcode can be installed from:
        #{Formatter.url(APPLE_DEVELOPER_DOWNLOAD_URL)}
    EOS
  else
    <<~EOS
      Xcode can be installed from the App Store.
    EOS
  end
end

.installed?Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Boolean)


134
135
136
# File 'os/mac/xcode.rb', line 134

def installed?
  false
end

.latest_sdk_version?Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Boolean)


68
69
70
# File 'os/mac/xcode.rb', line 68

def latest_sdk_version?
  OS::Mac.full_version >= OS::Mac.latest_sdk_version
end

.latest_version(macos: MacOS.version) ⇒ String

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

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.

Parameters:

  • macos (MacOS::Version) (defaults to: MacOS.version)

Returns:



23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
# File 'os/mac/xcode.rb', line 23

def latest_version(macos: MacOS.version)
  latest_stable = "13.4"
  case macos
  when "13" then "14.0"
  when "12" then latest_stable
  when "11" then "13.2.1"
  when "10.15" then "12.4"
  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"
  else
    raise "macOS '#{MacOS.version}' is invalid" unless OS::Mac.version.prerelease?

    # Default to newest known version of Xcode for unreleased macOS versions.
    latest_stable
  end
end

.minimum_versionString

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

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).

Returns:



47
48
49
50
51
52
53
54
55
56
57
58
# File 'os/mac/xcode.rb', line 47

def minimum_version
  case MacOS.version
  when "13" then "14.0"
  when "12" then "13.1"
  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. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Boolean)


73
74
75
76
77
78
79
80
81
82
# File 'os/mac/xcode.rb', line 73

def needs_clt_installed?
  return false if latest_sdk_version?

  # With fake El Capitan for Portable Ruby, we want the full 10.11 SDK so that we can link
  # against the correct set of libraries in the SDK sysroot rather than the system's copies.
  # We therefore do not use the CLT under this setup, which installs to /usr/include.
  return false if ENV["HOMEBREW_FAKE_EL_CAPITAN"]

  without_clt?
end

.outdated?Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Boolean)


85
86
87
88
89
# File 'os/mac/xcode.rb', line 85

def outdated?
  return false unless installed?

  version < latest_version
end

.prefixPathname?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns a Pathname object corresponding to Xcode.app’s Developer directory or nil if Xcode.app is not installed.

Returns:



99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
# File 'os/mac/xcode.rb', line 99

def prefix
  return @prefix if defined?(@prefix)

  @prefix = T.let(@prefix, T.nilable(Pathname))
  @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) ⇒ SDK?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

  • v (MacOS::Version, nil) (defaults to: nil)

Returns:



144
145
146
# File 'os/mac/xcode.rb', line 144

def sdk(v = nil)
  sdk_locator.sdk_if_applicable(v)
end

.sdk_locatorXcodeSDKLocator

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



139
140
141
# File 'os/mac/xcode.rb', line 139

def sdk_locator
  @sdk_locator ||= XcodeSDKLocator.new
end

.sdk_path(v = nil) ⇒ Pathname?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

  • v (MacOS::Version, nil) (defaults to: nil)

Returns:



149
150
151
# File 'os/mac/xcode.rb', line 149

def sdk_path(v = nil)
  sdk(v)&.path
end

.toolchain_pathPathname

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



118
119
120
# File 'os/mac/xcode.rb', line 118

def toolchain_path
  Pathname("#{prefix}/Toolchains/XcodeDefault.xctoolchain")
end

.update_instructionsString

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



168
169
170
171
172
173
174
175
176
177
178
179
# File 'os/mac/xcode.rb', line 168

def update_instructions
  if OS::Mac.version.prerelease?
    <<~EOS
      Xcode can be updated from:
        #{Formatter.url(APPLE_DEVELOPER_DOWNLOAD_URL)}
    EOS
  else
    <<~EOS
      Xcode can be updated from the App Store.
    EOS
  end
end

.version::Version

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



182
183
184
# File 'os/mac/xcode.rb', line 182

def version
  ::Version::NULL
end

.without_clt?Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Boolean)


92
93
94
# File 'os/mac/xcode.rb', line 92

def without_clt?
  !MacOS::CLT.installed?
end