Class: Pod::Project

Inherits:
Xcodeproj::Project
  • Object
show all
Defined in:
lib/cocoapods/project.rb

Overview

The Pods project.

Model class which provides helpers for working with the Pods project through the installation process.

Legacy Xcode build root collapse

LEGACY_BUILD_ROOT =

————————————————————————-#

'${SRCROOT}/../build'

Pod Groups collapse

SPEC_SUBGROUPS =

Returns The names of the specification subgroups by key.

Returns:

  • (Hash) —

    The names of the specification subgroups by key.

{
  :resources  => 'Resources',
  :frameworks => 'Frameworks',
  :developer  => 'Pod',
}

Instance Attribute Summary collapse

Legacy Xcode build root collapse

Pod Groups collapse

File references collapse

Instance Method Summary collapse

Constructor Details

#initialize(path, skip_initialization = false, object_version = Xcodeproj::Constants::DEFAULT_OBJECT_VERSION) ⇒ Project

Initialize a new instance

Parameters:

  • path (Pathname, String) —

    @see #path

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

    Whether the project should be initialized from scratch.

  • object_version (Int) (defaults to: Xcodeproj::Constants::DEFAULT_OBJECT_VERSION) —

    Object version to use for serialization, defaults to Xcode 3.2 compatible.



32
33
34
35
36
37
38
39
40
41
 
# File 'lib/cocoapods/project.rb', line 32

def initialize(path, skip_initialization = false,
    object_version = Xcodeproj::Constants::DEFAULT_OBJECT_VERSION)
  super(path, skip_initialization, object_version)
  @support_files_group = new_group('Targets Support Files')
  @refs_by_absolute_path = {}
  @variant_groups_by_path_and_name = {}
  @pods = new_group('Pods')
  @development_pods = new_group('Development Pods')
  self.symroot = LEGACY_BUILD_ROOT
end

Instance Attribute Details

#development_pods ⇒ PBXGroup (readonly)

Returns The group for Development Pods.

Returns:

  • (PBXGroup) —

    The group for Development Pods.



22
23
24
 
# File 'lib/cocoapods/project.rb', line 22

def development_pods
  @development_pods
end

#pods ⇒ PBXGroup (readonly)

Returns The group for the Pods.

Returns:

  • (PBXGroup) —

    The group for the Pods.



18
19
20
 
# File 'lib/cocoapods/project.rb', line 18

def pods
  @pods
end

#support_files_group ⇒ PBXGroup (readonly)

Returns The group for the support files of the aggregate targets.

Returns:

  • (PBXGroup) —

    The group for the support files of the aggregate targets.



14
15
16
 
# File 'lib/cocoapods/project.rb', line 14

def support_files_group
  @support_files_group
end

Instance Method Details

#add_build_configuration(name, type) ⇒ XCBuildConfiguration

Note:

This method extends the original Xcodeproj implementation to include a preprocessor definition named after the build setting. This is done to support the TargetEnvironmentHeader specification of Pods available only on certain build configurations.

Adds a new build configuration to the project and populates it with default settings according to the provided type.

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 new build configuration.



275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
 
# File 'lib/cocoapods/project.rb', line 275

def add_build_configuration(name, type)
  build_configuration = super
  settings = build_configuration.build_settings
  definitions = settings['GCC_PREPROCESSOR_DEFINITIONS'] || ['$(inherited)']
  defines = [defininition_for_build_configuration(name)]
  defines << 'DEBUG' if type == :debug
  defines.each do |define|
    value = "#{define}=1"
    unless definitions.include?(value)
      definitions.unshift(value)
    end
  end
  settings['GCC_PREPROCESSOR_DEFINITIONS'] = definitions

  if type == :debug
    settings['SWIFT_ACTIVE_COMPILATION_CONDITIONS'] = 'DEBUG'
  end

  build_configuration
end

#add_file_reference(absolute_path, group, reflect_file_system_structure = false, base_path = nil) ⇒ PBXFileReference

Adds a file reference to given path as a child of the given group.

Parameters:

  • absolute_path (Array<Pathname,String>) —

    The path of the file.

  • group (PBXGroup) —

    The group for the new file reference.

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

    Whether group structure should reflect the file system structure. If yes, where needed, intermediate groups are created, similar to how mkdir -p operates.

  • base_path (Pathname) (defaults to: nil) —

    The base path for newly created groups when reflect_file_system_structure is true. If nil, the provided group’s real_path is used.

Returns:

  • (PBXFileReference) —

    The new file reference.



204
205
206
207
208
209
210
211
212
213
 
# File 'lib/cocoapods/project.rb', line 204

def add_file_reference(absolute_path, group, reflect_file_system_structure = false, base_path = nil)
  file_path_name = absolute_path.is_a?(Pathname) ? absolute_path : Pathname(absolute_path)
  if ref = reference_for_path(file_path_name)
    return ref
  end

  group = group_for_path_in_group(file_path_name, group, reflect_file_system_structure, base_path)
  ref = group.new_file(file_path_name.realpath)
  @refs_by_absolute_path[file_path_name.to_s] = ref
end

#add_pod_group(pod_name, path, development = false, absolute = false) ⇒ PBXGroup

Creates a new group for the Pod with the given name and configures its path.

Parameters:

  • pod_name (String) —

    The name of the Pod.

  • path (#to_s) —

    The path to the root of the Pod.

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

    Wether the group should be added to the Development Pods group.

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

    Wether the path of the group should be set as absolute.

Returns:

  • (PBXGroup) —

    The new group.



101
102
103
104
105
106
107
108
109
 
# File 'lib/cocoapods/project.rb', line 101

def add_pod_group(pod_name, path, development = false, absolute = false)
  raise '[BUG]' if pod_group(pod_name)

  parent_group = development ? development_pods : pods
  source_tree = absolute ? :absolute : :group

  group = parent_group.new_group(pod_name, path, source_tree)
  group
end

#add_podfile(podfile_path) ⇒ PBXFileReference

Adds a file reference to the Podfile.

Parameters:

  • podfile_path (#to_s) —

    The path of the Podfile.

Returns:

  • (PBXFileReference) —

    The new file reference.



239
240
241
242
243
 
# File 'lib/cocoapods/project.rb', line 239

def add_podfile(podfile_path)
  new_file(podfile_path, :project).tap do |podfile_ref|
    mark_ruby_file_ref(podfile_ref)
  end
end

#defininition_for_build_configuration(name) ⇒ String

Returns The preprocessor definition to set for the configuration.

Parameters:

  • name (String) —

    The name of the build configuration.

Returns:

  • (String) —

    The preprocessor definition to set for the configuration.



301
302
303
 
# File 'lib/cocoapods/project.rb', line 301

def defininition_for_build_configuration(name)
  "POD_CONFIGURATION_#{name.underscore}".gsub(/[^a-zA-Z0-9_]/, '_').upcase
end

#generate_available_uuid_list(count = 100) ⇒ Void

Note:

Overridden to generate UUIDs in a much faster way, since we don’t need to check for collisions (as the Pods project is regenerated each time, and thus all UUIDs will have come from this method)

Generates a list of new UUIDs that created objects can be assigned.

Parameters:

  • count (Integer) (defaults to: 100) —

    The number of UUIDs to generate

Returns:

  • (Void) 


53
54
55
56
57
58
 
# File 'lib/cocoapods/project.rb', line 53

def generate_available_uuid_list(count = 100)
  start = @generated_uuids.size
  uniques = Array.new(count) { |i| format('%011X0', start + i) }
  @generated_uuids += uniques
  @available_uuids += uniques
end

#group_for_spec(spec_name, subgroup_key = nil) ⇒ PBXGroup

Returns the group for the specification with the give name creating it if needed.

Parameters:

  • spec_name (String) —

    The full name of the specification.

Returns:

  • (PBXGroup) —

    The group.



144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
 
# File 'lib/cocoapods/project.rb', line 144

def group_for_spec(spec_name, subgroup_key = nil)
  pod_name = Specification.root_name(spec_name)
  group = pod_group(pod_name)
  raise "[Bug] Unable to locate group for Pod named `#{pod_name}`" unless group
  if spec_name != pod_name
    subspecs_names = spec_name.gsub(pod_name + '/', '').split('/')
    subspecs_names.each do |name|
      group = group[name] || group.new_group(name)
    end
  end

  if subgroup_key
    subgroup_name = SPEC_SUBGROUPS[subgroup_key]
    raise ArgumentError, "Unrecognized subgroup key `#{subgroup_key}`" unless subgroup_name
    group = group[subgroup_name] || group.new_group(subgroup_name)
  end

  group
end

#mark_ruby_file_ref(file_ref) ⇒ Object

Sets the syntax of the provided file reference to be Ruby, in the case that the file does not already have a “.rb” file extension (ex. the Podfile)

Parameters:

  • file_ref (PBXFileReference) —

    The file reference to change



251
252
253
254
255
 
# File 'lib/cocoapods/project.rb', line 251

def mark_ruby_file_ref(file_ref)
  file_ref.xc_language_specification_identifier = 'xcode.lang.ruby'
  file_ref.explicit_file_type = 'text.script.ruby'
  file_ref.last_known_file_type = 'text'
end

#pod_group(pod_name) ⇒ PBXGroup

Returns the group for the Pod with the given name.

Parameters:

  • pod_name (String) —

    The name of the Pod.

Returns:

  • (PBXGroup) —

    The group.



124
125
126
 
# File 'lib/cocoapods/project.rb', line 124

def pod_group(pod_name)
  pod_groups.find { |group| group.name == pod_name }
end

#pod_groups ⇒ Array<PBXGroup>

Returns all the group of the Pods.

Returns:

  • (Array<PBXGroup>) —

    Returns all the group of the Pods.



113
114
115
 
# File 'lib/cocoapods/project.rb', line 113

def pod_groups
  pods.children.objects + development_pods.children.objects
end

#pod_support_files_group(pod_name, dir) ⇒ PBXGroup

Returns the support files group for the Pod with the given name.

Parameters:

  • pod_name (String) —

    The name of the Pod.

Returns:

  • (PBXGroup) —

    The group.



171
172
173
174
175
176
177
178
 
# File 'lib/cocoapods/project.rb', line 171

def pod_support_files_group(pod_name, dir)
  group = pod_group(pod_name)
  support_files_group = group['Support Files']
  unless support_files_group
    support_files_group = group.new_group('Support Files', dir)
  end
  support_files_group
end

#reference_for_path(absolute_path) ⇒ PBXFileReference, Nil

Returns the file reference for the given absolute path.

Parameters:

  • absolute_path (#to_s) —

    The absolute path of the file whose reference is needed.

Returns:

  • (PBXFileReference) —

    The file reference.

  • (Nil) —

    If no file reference could be found.



223
224
225
226
227
228
229
230
 
# File 'lib/cocoapods/project.rb', line 223

def reference_for_path(absolute_path)
  absolute_path = absolute_path.is_a?(Pathname) ? absolute_path : Pathname(absolute_path)
  unless absolute_path.absolute?
    raise ArgumentError, "Paths must be absolute #{absolute_path}"
  end

  refs_by_absolute_path[absolute_path.to_s] ||= refs_by_absolute_path[absolute_path.realpath.to_s]
end

#symroot=(symroot) ⇒ void

This method returns an undefined value.

Parameters:

  • symroot (String) —

    The build root that is used when Xcode is configured to not use the workspace’s build root. Defaults to ‘$SRCROOT/../build`.



73
74
75
76
77
 
# File 'lib/cocoapods/project.rb', line 73

def symroot=(symroot)
  root_object.build_configuration_list.build_configurations.each do |config|
    config.build_settings['SYMROOT'] = symroot
  end
end