Class: Xcodeproj::Project::Object::AbstractTarget

Inherits:
AbstractObject show all
Defined in:
lib/xcodeproj/project/object/native_target.rb

Attributes collapse

Attributes inherited from AbstractObject

#isa, #project, #uuid

Attributes collapse

Helpers collapse

Build Phases Helpers collapse

System frameworks collapse

AbstractObject Hooks collapse

Methods inherited from AbstractObject

#<=>, #==, #ascii_plist_annotation, #display_name, #inspect, isa, #nested_object_for_hash, #remove_from_project, #sort, #sort_recursively, #to_ascii_plist, #to_hash

Instance Attribute Details

#build_configuration_list ⇒ XCConfigurationList

Returns the list of the build configurations of the target. This list commonly include two configurations ‘Debug` and `Release`.

Returns:

  • (XCConfigurationList) —

    the list of the build configurations of the target. This list commonly include two configurations ‘Debug` and `Release`.



25
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 25

has_one :build_configuration_list, XCConfigurationList

#comments ⇒ String

Returns Comments associated with this target.

This is apparently no longer used by Xcode.

Returns:

  • (String) —

    Comments associated with this target.

    This is apparently no longer used by Xcode.



19
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 19

attribute :comments, String

#name ⇒ String

Returns The name of the Target.

Returns:

  • (String) —

    The name of the Target.



9
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 9

attribute :name, String

#product_name ⇒ String

Returns the name of the build product.

Returns:

  • (String) —

    the name of the build product.



13
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 13

attribute :product_name, String

Instance Method Details

#add_build_configuration(name, type) ⇒ XCBuildConfiguration

Note:

If a build configuration with the given name is already present no new build configuration is added.

Adds a new build configuration to the target and populates its with default settings according to the provided type if one doesn’t exists.

Parameters:

  • name (String) —

    The name of the build configuration.

  • type (Symbol) —

    The type of the build configuration used to populate the build settings, must be :debug or :release.

Returns:

  • (XCBuildConfiguration) —

    the created build configuration or the existing one with the same name.



178
179
180
181
182
183
184
185
186
187
188
189
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 178

def add_build_configuration(name, type)
  if existing = build_configuration_list[name]
    existing
  else
    build_configuration = project.new(XCBuildConfiguration)
    build_configuration.name = name
    product_type = self.product_type if respond_to?(:product_type)
    build_configuration.build_settings = ProjectHelper.common_build_settings(type, platform_name, deployment_target, product_type)
    build_configuration_list.build_configurations << build_configuration
    build_configuration
  end
end

#add_dependency(target) ⇒ void

This method returns an undefined value.

Adds a dependency on the given target.

Parameters:

  • target (AbstractTarget) —

    the target which should be added to the dependencies list of the receiver. The target may be a target of this target’s project or of a subproject of this project. Note that the subproject must already be added to this target’s project.



235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 235

def add_dependency(target)
  unless dependency_for_target(target)
    container_proxy = project.new(Xcodeproj::Project::PBXContainerItemProxy)
    if target.project == project
      container_proxy.container_portal = project.root_object.uuid
    else
      subproject_reference = project.reference_for_path(target.project.path)
      raise ArgumentError, 'add_dependency received target that belongs to a project that is not this project and is not a subproject of this project' unless subproject_reference
      container_proxy.container_portal = subproject_reference.uuid
    end
    container_proxy.proxy_type = Constants::PROXY_TYPES[:native_target]
    container_proxy.remote_global_id_string = target.uuid
    container_proxy.remote_info = target.name

    dependency = project.new(Xcodeproj::Project::PBXTargetDependency)
    dependency.name = target.name
    dependency.target = target if target.project == project
    dependency.target_proxy = container_proxy

    dependencies << dependency
  end
end

#add_system_framework(names) ⇒ Array<PBXFileReference> Also known as: add_system_frameworks

Note:

Xcode behaviour is following: if the target has the same SDK of the project it adds the reference relative to the SDK root otherwise the reference is added relative to the Developer directory. This can create confusion or duplication of the references of frameworks linked by iOS and OS X targets. For this reason the new Xcodeproj behaviour is to add the frameworks in a subgroup according to the platform.

Adds a file reference for one or more system framework to the project if needed and adds them to the Frameworks build phases.

Parameters:

  • names (Array<String>, String) —

    The name or the list of the names of the framework.

Returns:



326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 326

def add_system_framework(names)
  Array(names).map do |name|
    case platform_name
    when :ios
      group = project.frameworks_group['iOS'] || project.frameworks_group.new_group('iOS')
      path_sdk_name = 'iPhoneOS'
      path_sdk_version = sdk_version || Constants::LAST_KNOWN_IOS_SDK
    when :osx
      group = project.frameworks_group['OS X'] || project.frameworks_group.new_group('OS X')
      path_sdk_name = 'MacOSX'
      path_sdk_version = sdk_version || Constants::LAST_KNOWN_OSX_SDK
    when :tvos
      group = project.frameworks_group['tvOS'] || project.frameworks_group.new_group('tvOS')
      path_sdk_name = 'AppleTVOS'
      path_sdk_version = sdk_version || Constants::LAST_KNOWN_TVOS_SDK
    when :watchos
      group = project.frameworks_group['watchOS'] || project.frameworks_group.new_group('watchOS')
      path_sdk_name = 'WatchOS'
      path_sdk_version = sdk_version || Constants::LAST_KNOWN_WATCHOS_SDK
    else
      raise 'Unknown platform for target'
    end

    path = "Platforms/#{path_sdk_name}.platform/Developer/SDKs/#{path_sdk_name}#{path_sdk_version}.sdk/System/Library/Frameworks/#{name}.framework"
    unless ref = group.find_file_by_path(path)
      ref = group.new_file(path, :developer_dir)
    end
    frameworks_build_phase.add_file_reference(ref, true)
    ref
  end
end

#add_system_library(names) ⇒ void Also known as: add_system_libraries

This method returns an undefined value.

Adds a file reference for one or more system dylib libraries to the project if needed and adds them to the Frameworks build phases.

Parameters:

  • names (Array<String>, String) —

    The name or the list of the names of the libraries.



367
368
369
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 367

def add_system_library(names)
  add_system_library_extension(names, 'dylib')
end

#add_system_library_tbd(names) ⇒ void Also known as: add_system_libraries_tbd

This method returns an undefined value.

Adds a file reference for one or more system tbd libraries to the project if needed and adds them to the Frameworks build phases.

Parameters:

  • names (Array<String>, String) —

    The name or the list of the names of the libraries.



393
394
395
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 393

def add_system_library_tbd(names)
  add_system_library_extension(names, 'tbd')
end

#build_configurations ⇒ ObjectList<XCBuildConfiguration>

Returns the build configurations of the target.

Returns:



157
158
159
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 157

def build_configurations
  build_configuration_list.build_configurations
end

#build_settings(build_configuration_name) ⇒ Hash

Returns the build settings of the build configuration with the given name.

Parameters:

  • build_configuration_name (String) —

    the name of a build configuration.

Returns:

  • (Hash) —

    the build settings of the build configuration with the given name.



198
199
200
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 198

def build_settings(build_configuration_name)
  build_configuration_list.build_settings(build_configuration_name)
end

#common_resolved_build_setting(key) ⇒ String

Note:

As it is common not to have a setting with no value for custom build configurations nil keys are not considered to determine if the setting is unique. This is an heuristic which might not closely match Xcode behaviour.

Gets the value for the given build setting, properly inherited if need, if shared across the build configurations.

Parameters:

  • key (String) —

    the key of the build setting.

Returns:

  • (String) —

    The value of the build setting.

Raises:

  • If the build setting has multiple values.



86
87
88
89
90
91
92
93
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 86

def common_resolved_build_setting(key)
  values = resolved_build_setting(key).values.compact.uniq
  if values.count <= 1
    values.first
  else
    raise "[Xcodeproj] Consistency issue: build setting `#{key}` has multiple values: `#{resolved_build_setting(key)}`"
  end
end

#copy_files_build_phases ⇒ Array<PBXCopyFilesBuildPhase>

Returns the copy files build phases of the target.

Returns:



214
215
216
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 214

def copy_files_build_phases
  build_phases.grep(PBXCopyFilesBuildPhase)
end

#dependencies ⇒ ObjectList<PBXTargetDependency>

Returns the targets necessary to build this target.

Returns:



30
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 30

has_many :dependencies, PBXTargetDependency

#dependency_for_target(target) ⇒ PBXTargetDependency

Checks whether this target has a dependency on the given target.

Parameters:

Returns:



265
266
267
268
269
270
271
272
273
274
275
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 265

def dependency_for_target(target)
  dependencies.find do |dep|
    if dep.target_proxy.remote?
      subproject_reference = project.reference_for_path(target.project.path)
      uuid = subproject_reference.uuid if subproject_reference
      dep.target_proxy.remote_global_id_string == target.uuid && dep.target_proxy.container_portal == uuid
    else
      dep.target.uuid == target.uuid
    end
  end
end

#deployment_target ⇒ String

Returns the deployment target of the target according to its platform.

Returns:

  • (String) —

    the deployment target of the target according to its platform.



139
140
141
142
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 139

def deployment_target
  return unless setting = DEPLOYMENT_TARGET_SETTING_BY_PLATFORM_NAME[platform_name]
  common_resolved_build_setting(setting)
end

#deployment_target=(deployment_target) ⇒ Object

Parameters:

  • deployment_target (String) —

    the deployment target to set for the target according to its platform.



147
148
149
150
151
152
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 147

def deployment_target=(deployment_target)
  return unless setting = DEPLOYMENT_TARGET_SETTING_BY_PLATFORM_NAME[platform_name]
  build_configurations.each do |config|
    config.build_settings[setting] = deployment_target
  end
end

#frameworks_build_phases ⇒ PBXFrameworksBuildPhase

Returns the frameworks build phases of the target.

Returns:



207
208
209
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 207

def frameworks_build_phases
  build_phases.find { |bp| bp.class == PBXFrameworksBuildPhase }
end

#new_copy_files_build_phase(name = nil) ⇒ PBXCopyFilesBuildPhase

Creates a new copy files build phase.

Parameters:

  • name (String) (defaults to: nil) —

    an optional name for the phase.

Returns:



284
285
286
287
288
289
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 284

def new_copy_files_build_phase(name = nil)
  phase = project.new(PBXCopyFilesBuildPhase)
  phase.name = name
  build_phases << phase
  phase
end

#new_shell_script_build_phase(name = nil) ⇒ PBXShellScriptBuildPhase

Creates a new shell script build phase.

Parameters:

  • name (String) (defaults to: nil) —

    an optional name for the phase.

Returns:



297
298
299
300
301
302
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 297

def new_shell_script_build_phase(name = nil)
  phase = project.new(PBXShellScriptBuildPhase)
  phase.name = name
  build_phases << phase
  phase
end

#platform_name ⇒ Symbol

Returns the name of the platform of the target.

Returns:

  • (Symbol) —

    the name of the platform of the target.



103
104
105
106
107
108
109
110
111
112
113
114
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 103

def platform_name
  return unless sdk
  if sdk.include? 'iphoneos'
    :ios
  elsif sdk.include? 'macosx'
    :osx
  elsif sdk.include? 'appletvos'
    :tvos
  elsif sdk.include? 'watchos'
    :watchos
  end
end

#pretty_print ⇒ Hash{String => Hash}

Returns A hash suitable to display the object to the user.

Returns:

  • (Hash{String => Hash}) —

    A hash suitable to display the object to the user.



406
407
408
409
410
411
412
413
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 406

def pretty_print
  {
    display_name => {
      'Build Phases' => build_phases.map(&:pretty_print),
      'Build Configurations' => build_configurations.map(&:pretty_print),
    },
  }
end

#resolved_build_setting(key, resolve_against_xcconfig = false) ⇒ Hash{String => String}

Gets the value for the given build setting in all the build configurations or the value inheriting the value from the project ones if needed.

TODO: Full support for this would require to take into account

the default values for the platform.

Parameters:

  • key (String) —

    the key of the build setting.

  • resolve_against_xcconfig (Bool) (defaults to: false) —

    wether the resolved setting should take in consideration any configuration file present.

Returns:

  • (Hash{String => String}) —

    The value of the build setting grouped by the name of the build configuration.



54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 54

def resolved_build_setting(key, resolve_against_xcconfig = false)
  target_settings = build_configuration_list.get_setting(key, resolve_against_xcconfig, self)
  project_settings = project.build_configuration_list.get_setting(key, resolve_against_xcconfig)
  target_settings.merge(project_settings) do |_key, target_val, proj_val|
    target_includes_inherited = Constants::INHERITED_KEYWORDS.any? { |keyword| target_val.include?(keyword) } if target_val
    if target_includes_inherited && proj_val
      if target_val.is_a? String
        target_val.gsub(Regexp.union(Constants::INHERITED_KEYWORDS), proj_val)
      else
        target_val.flat_map { |value| Constants::INHERITED_KEYWORDS.include?(value) ? proj_val : value }
      end
    else
      target_val || proj_val
    end
  end
end

#sdk ⇒ String

Returns the SDK that the target should use.

Returns:

  • (String) —

    the SDK that the target should use.



97
98
99
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 97

def sdk
  common_resolved_build_setting('SDKROOT')
end

#sdk_version ⇒ String

Returns the version of the SDK.

Returns:

  • (String) —

    the version of the SDK.



118
119
120
121
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 118

def sdk_version
  return unless sdk
  sdk.scan(/[0-9.]+/).first
end

#shell_script_build_phases ⇒ Array<PBXShellScriptBuildPhase>

Returns the shell script build phases of the target.

Returns:



221
222
223
 
# File 'lib/xcodeproj/project/object/native_target.rb', line 221

def shell_script_build_phases
  build_phases.grep(PBXShellScriptBuildPhase)
end