Class: Pod::Platform

Inherits:
Object
  • Object
show all
Defined in:
lib/cocoapods-core/platform.rb

Overview

A Platform describes an SDK name and deployment target.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, deployment_target) ⇒ Platform #initialize(platform) ⇒ Platform

Constructs a platform from either another platform or by specifying the symbolic name and optionally the deployment target.

Overloads:

  • #initialize(name, deployment_target) ⇒ Platform
    Note:

    If the deployment target is not provided a default deployment target will not be assigned.

    Examples:

    Initialization with symbol

    
Platform.new(:ios)
Platform.new(:ios, '4.3')

    Parameters:

    • name (Symbol, String) —

      the name of platform.

    • deployment_target (String, Version) —

      the optional deployment.

  • #initialize(platform) ⇒ Platform

    Examples:

    Initialization with another platform

    
platform = Platform.new(:ios)
Platform.new(platform)

    Parameters:



43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/cocoapods-core/platform.rb', line 43

def initialize(input, target = nil)
  if input.is_a? Platform
    @symbolic_name = input.name
    @deployment_target = input.deployment_target
  else
    # Allow `Platform.new('macos')` to be equivalent to `Platform.macos`
    if input == 'macos'
      input = 'osx'
    elsif input == 'xros'
      # To address the issue of the mismatch between the platform: xros in the XCFramework and the platform:
      # visionos in Cocoapods.
      #
      # This will ensure proper alignment between the platform information in the XCFramework and Cocoapods.
      input = 'visionos'
    end
    @symbolic_name = input.to_sym
    target = target[:deployment_target] if target.is_a?(Hash)
    @deployment_target = Version.create(target)
  end
end

Instance Attribute Details

#deployment_target ⇒ Version (readonly)

Returns the deployment target of the platform.

Returns:

  • (Version) —

    the deployment target of the platform.



12
13
14
 
# File 'lib/cocoapods-core/platform.rb', line 12

def deployment_target
  @deployment_target
end

#symbolic_name ⇒ Symbol, String (readonly) Also known as: name

Returns the name of the SDK represented by the platform.

Returns:

  • (Symbol, String) —

    the name of the SDK represented by the platform.



7
8
9
 
# File 'lib/cocoapods-core/platform.rb', line 7

def symbolic_name
  @symbolic_name
end

Class Method Details

.all ⇒ Array<Platform>

Convenience method to get all available platforms.

Returns:

  • (Array<Platform>) —

    list of platforms.



116
117
118
 
# File 'lib/cocoapods-core/platform.rb', line 116

def self.all
  [ios, osx, watchos, visionos, tvos]
end

.ios ⇒ Platform

Convenience method to initialize an iOS platform.

Returns:



68
69
70
 
# File 'lib/cocoapods-core/platform.rb', line 68

def self.ios
  new :ios
end

.macos ⇒ Platform

Convenience method to initialize a macOS platform.

Returns:



84
85
86
 
# File 'lib/cocoapods-core/platform.rb', line 84

def self.macos
  osx
end

.osx ⇒ Platform

Convenience method to initialize an OS X platform.

Returns:



76
77
78
 
# File 'lib/cocoapods-core/platform.rb', line 76

def self.osx
  new :osx
end

.string_name(symbolic_name) ⇒ String

Converts the symbolic name of a platform to a string name suitable to be presented to the user.

Parameters:

  • symbolic_name (Symbol) —

    the symbolic name of a platform.

Returns:

  • (String) —

    The string that describes the name of the given symbol.



250
251
252
253
254
255
256
257
258
259
 
# File 'lib/cocoapods-core/platform.rb', line 250

def self.string_name(symbolic_name)
  case symbolic_name
  when :ios then 'iOS'
  when :osx then 'macOS'
  when :watchos then 'watchOS'
  when :tvos then 'tvOS'
  when :visionos then 'visionOS'
  else symbolic_name.to_s
  end
end

.tvos ⇒ Platform

Convenience method to initialize a tvOS platform.

Returns:



92
93
94
 
# File 'lib/cocoapods-core/platform.rb', line 92

def self.tvos
  new :tvos
end

.visionos ⇒ Platform

Convenience method to initialize a visionOS platform.

Returns:



100
101
102
 
# File 'lib/cocoapods-core/platform.rb', line 100

def self.visionos
  new :visionos
end

.watchos ⇒ Platform

Convenience method to initialize a watchOS platform.

Returns:



108
109
110
 
# File 'lib/cocoapods-core/platform.rb', line 108

def self.watchos
  new :watchos
end

Instance Method Details

#<=>(other) ⇒ Fixnum

Compares the platform first by name and the by deployment_target for sorting.

Parameters:

  • other (Platform) —

    The other platform to compare.

Returns:

  • (Fixnum) —

    -1, 0, or +1 depending on whether the receiver is less than, equal to, or greater than other.



199
200
201
202
203
204
205
206
 
# File 'lib/cocoapods-core/platform.rb', line 199

def <=>(other)
  name_sort = name.to_s <=> other.name.to_s
  if name_sort.zero?
    deployment_target <=> other.deployment_target
  else
    name_sort
  end
end

#==(other) ⇒ Boolean Also known as: eql?

Note:

If a symbol is passed the comparison does not take into account the deployment target.

Checks if a platform is equivalent to another one or to a symbol representation.

Parameters:

  • other (Platform, Symbol) —

    the other platform to check.

Returns:

  • (Boolean) —

    whether two platforms are the equivalent.



131
132
133
134
135
136
137
 
# File 'lib/cocoapods-core/platform.rb', line 131

def ==(other)
  if other.is_a?(Symbol)
    @symbolic_name == other
  else
    (name == other.name) && (deployment_target == other.deployment_target)
  end
end

#inspect ⇒ String

Returns the debug representation.

Returns:

  • (String) —

    the debug representation.



179
180
181
182
 
# File 'lib/cocoapods-core/platform.rb', line 179

def inspect
  "#<#{self.class.name} name=#{name.inspect} " \
    "deployment_target=#{deployment_target.inspect}>"
end

#requires_legacy_ios_archs? ⇒ Boolean

Returns whether the platform requires legacy architectures for iOS.

Returns:

  • (Boolean) —

    whether the platform requires legacy architectures for iOS.



211
212
213
214
215
216
217
 
# File 'lib/cocoapods-core/platform.rb', line 211

def requires_legacy_ios_archs?
  if name == :ios
    deployment_target && (deployment_target < Version.new('4.3'))
  else
    false
  end
end

#safe_string_name ⇒ String

Returns The string that describes the #symbolic_name, which doesn’t contain spaces and is so safe to use in paths which might not be quoted or escaped consequently.

Returns:

  • (String) —

    The string that describes the #symbolic_name, which doesn’t contain spaces and is so safe to use in paths which might not be quoted or escaped consequently.



238
239
240
 
# File 'lib/cocoapods-core/platform.rb', line 238

def safe_string_name
  string_name.tr(' ', '')
end

#string_name ⇒ String

Returns The string that describes the #symbolic_name.

Returns:

  • (String) —

    The string that describes the #symbolic_name.



231
232
233
 
# File 'lib/cocoapods-core/platform.rb', line 231

def string_name
  self.class.string_name(symbolic_name)
end

#supports?(other) ⇒ Boolean

Checks whether a platform supports another one.

In the context of operating system SDKs, a platform supports another one if they have the same name and the other platform has a minor or equal deployment target.

Returns:

  • (Boolean) —

    whether the platform supports another platform.



159
160
161
162
163
164
165
166
 
# File 'lib/cocoapods-core/platform.rb', line 159

def supports?(other)
  other = Platform.new(other)
  if other.deployment_target && deployment_target
    (other.name == name) && (other.deployment_target <= deployment_target)
  else
    other.name == name
  end
end

#supports_dynamic_frameworks? ⇒ Boolean

Returns whether the platform supports dynamic frameworks.

Returns:

  • (Boolean) —

    whether the platform supports dynamic frameworks.



221
222
223
224
225
226
227
 
# File 'lib/cocoapods-core/platform.rb', line 221

def supports_dynamic_frameworks?
  if name == :ios
    deployment_target && (deployment_target >= Version.new(8.0))
  else
    true
  end
end

#to_s ⇒ String

Returns a string representation that includes the deployment target.

Returns:

  • (String) —

    a string representation that includes the deployment target.



171
172
173
174
175
 
# File 'lib/cocoapods-core/platform.rb', line 171

def to_s
  s = self.class.string_name(@symbolic_name)
  s << " #{deployment_target}" if deployment_target
  s
end

#to_sym ⇒ Symbol

Returns a symbol representing the name of the platform.

Returns:

  • (Symbol) —

    a symbol representing the name of the platform.



186
187
188
 
# File 'lib/cocoapods-core/platform.rb', line 186

def to_sym
  name
end