Class: Xcodeproj::Project::Object::PBXFileReference

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

Overview

This class represents a reference to a file in the file system.

Attributes collapse

Attributes inherited from AbstractObject

#isa, #project, #uuid

Helpers collapse

Methods inherited from AbstractObject

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

Instance Attribute Details

#comments ⇒ String

Note:

This is apparently no longer used by Xcode.

Returns Comments associated with this file.

Returns:

  • (String) —

    Comments associated with this file.



114
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 114

attribute :comments, String

#explicit_file_type ⇒ String

Returns the file type (apparently) used for products generated by Xcode (i.e. applications, libraries).

Returns:

  • (String) —

    the file type (apparently) used for products generated by Xcode (i.e. applications, libraries).



36
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 36

attribute :explicit_file_type, String

#fileEncoding ⇒ String

Returns a string containing a number which represents the encoding format of the file.

Returns:

  • (String) —

    a string containing a number which represents the encoding format of the file.



56
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 56

attribute :fileEncoding, String

#include_in_index ⇒ String

Note:

Apparently present only for products generated by Xcode with a value of 0.

Returns whether this file should be indexed. It can be either 0 or 1.

Returns:

  • (String) —

    whether this file should be indexed. It can be either 0 or 1.



51
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 51

attribute :include_in_index, String, '1'

#indent_width ⇒ String

Returns The width of the indent.

Examples:

`2`

Returns:

  • (String) —

    The width of the indent.



86
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 86

attribute :indent_width, String

#last_known_file_type ⇒ String

Note:

This attribute is not present if there is an explicit_file_type.

Returns the file type guessed by Xcode.

Returns:

  • (String) —

    the file type guessed by Xcode.



43
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 43

attribute :last_known_file_type, String

#line_ending ⇒ String

Returns Apparently whether Xcode should add, if needed, a new line feed before saving the file.

Examples:

`0`

Returns:

  • (String) —

    Apparently whether Xcode should add, if needed, a new line feed before saving the file.



108
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 108

attribute :line_ending, String

#name ⇒ String

Returns the name of the reference, often not present.

Returns:

  • (String) —

    the name of the reference, often not present.



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

attribute :name, String

#path ⇒ String

Returns the path to the file relative to the source tree.

Returns:

  • (String) —

    the path to the file relative to the source tree



17
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 17

attribute :path, String

#plist_structure_definition_identifier ⇒ String

Returns a string that specifies the UTI for the structure of a plist file.

Examples:

`com.apple.xcode.plist.structure-definition.iphone.info-plist`

Returns:

  • (String) —

    a string that specifies the UTI for the structure of a plist file.



72
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 72

attribute :plist_structure_definition_identifier, String

#source_tree ⇒ String

Note:

The accepted values are:

  • <absolute> for absolute paths
  • <group> for paths relative to the group
  • SOURCE_ROOT for paths relative to the project
  • DEVELOPER_DIR for paths relative to the developer directory.
  • BUILT_PRODUCTS_DIR for paths relative to the build products directory.
  • SDKROOT for paths relative to the SDK directory.

Returns the directory to which the path is relative.

Returns:

  • (String) —

    the directory to which the path is relative.



31
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 31

attribute :source_tree, String, 'SOURCE_ROOT'

#tab_width ⇒ String

Returns The width of the tabs.

Examples:

`2`

Returns:

  • (String) —

    The width of the tabs.



93
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 93

attribute :tab_width, String

#uses_tabs ⇒ String

Returns Whether Xcode should use tabs for text alignment.

Examples:

`1`

Returns:

  • (String) —

    Whether Xcode should use tabs for text alignment.



79
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 79

attribute :uses_tabs, String

#wraps_lines ⇒ String

Returns Whether Xcode should wrap lines.

Examples:

`1`

Returns:

  • (String) —

    Whether Xcode should wrap lines.



100
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 100

attribute :wraps_lines, String

#xc_language_specification_identifier ⇒ String

Returns a string that specifies the UTI for the syntax highlighting.

Examples:

`xcode.lang.ruby`

Returns:

  • (String) —

    a string that specifies the UTI for the syntax highlighting.



64
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 64

attribute :xc_language_specification_identifier, String

Instance Method Details

#build_files ⇒ Array<PBXBuildFile>

Returns the build files associated with the current file reference.

Returns:

  • (Array<PBXBuildFile>) —

    the build files associated with the current file reference.



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

def build_files
  referrers.grep(PBXBuildFile)
end

#display_name ⇒ String

Returns the name of the file taking into account the path if needed.

Returns:

  • (String) —

    the name of the file taking into account the path if needed.



125
126
127
128
129
130
131
132
133
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 125

def display_name
  if name
    name
  elsif (class << GroupableHelper; self; end)::SOURCE_TREES_BY_KEY[:built_products] == source_tree
    path
  elsif path
    File.basename(path)
  end
end

#file_reference_proxies ⇒ Array<PBXReferenceProxy>

If this file reference represents an external Xcode project reference then this will return proxies for file references contained in the external Xcode project.

Returns:

  • (Array<PBXReferenceProxy>) —

    The file reference proxies for items located in the external Xcode project.



284
285
286
287
288
289
290
291
292
293
294
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 284

def file_reference_proxies
  containers = proxy_containers
  if containers.empty?
    []
  else
    project.objects.select do |object|
      object.isa == 'PBXReferenceProxy' &&
        containers.include?(object.remote_ref)
    end
  end
end

#full_path ⇒ Pathname

source tree.

Returns:

  • (Pathname) —

    the path of the file without resolving the



175
176
177
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 175

def full_path
  GroupableHelper.full_path(self)
end

#hierarchy_path ⇒ String

Returns A representation of the reference hierarchy.

Returns:

  • (String) —

    A representation of the reference hierarchy.



150
151
152
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 150

def hierarchy_path
  GroupableHelper.hierarchy_path(self)
end

#move(new_parent) ⇒ void

This method returns an undefined value.

Moves the reference to a new parent.

Parameters:

  • new_parent (PBXGroup) —

    The new parent.



161
162
163
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 161

def move(new_parent)
  GroupableHelper.move(self, new_parent)
end

#parent ⇒ PBXGroup, PBXProject

Returns the parent of the file.

Returns:



137
138
139
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 137

def parent
  GroupableHelper.parent(self)
end

#parents ⇒ Array<PBXGroup, PBXProject>

Returns The list of the parents of the reference.

Returns:



144
145
146
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 144

def parents
  GroupableHelper.parents(self)
end

#project_reference_metadata ⇒ ObjectDictionary?

If this file reference represents an external Xcode project reference then this will return metadata about it which includes the reference to the 'Products' group that's created in this project (the project that includes the external project).

Returns:

  • (ObjectDictionary, nil) —

    The external project metadata for this file reference or nil if it's not an external project.



257
258
259
260
261
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 257

def project_reference_metadata
  project.root_object.project_references.find do |project_reference|
    project_reference[:project_ref] == self
  end
end

#proxy? ⇒ Bool

Checks whether the reference is a proxy.

Returns:

  • (Bool) —

    always false for this ISA.



245
246
247
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 245

def proxy?
  false
end

#proxy_containers ⇒ Array<PBXContainerItemProxy>

If this file reference represents an external Xcode project reference then this will return the objects that are 'containers' for items contained in the external Xcode project.

Returns:



270
271
272
273
274
275
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 270

def proxy_containers
  project.objects.select do |object|
    object.isa == 'PBXContainerItemProxy' &&
      object.container_portal == uuid
  end
end

#real_path ⇒ Pathname

source tree.

Returns:

  • (Pathname) —

    the absolute path of the file resolving the



168
169
170
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 168

def real_path
  GroupableHelper.real_path(self)
end

#remove_from_project ⇒ void

This method returns an undefined value.

In addition to removing the file reference, this will also remove any items related to this reference.

See Also:



322
323
324
325
326
327
328
329
330
331
332
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 322

def remove_from_project
  if project_reference = project_reference_metadata
    file_reference_proxies.each(&:remove_from_project)
    target_dependency_proxies.each(&:remove_from_project)
    project_reference[:product_group].remove_from_project
    project.root_object.project_references.delete(project_reference)
  end

  build_files.each(&:remove_from_project)
  super
end

#set_explicit_file_type(type = nil) ⇒ void

This method returns an undefined value.

Sets the explicit file type according to the extension of the path, and clears the last known file type.



229
230
231
232
233
234
235
236
237
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 229

def set_explicit_file_type(type = nil)
  self.last_known_file_type = nil
  if type
    self.explicit_file_type = type
  elsif path
    extension = Pathname(path).extname[1..-1]
    self.explicit_file_type = Constants::FILE_TYPES_BY_EXTENSION[extension]
  end
end

#set_last_known_file_type(type = nil) ⇒ void

This method returns an undefined value.

Sets the last known file type according to the extension of the path.



215
216
217
218
219
220
221
222
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 215

def set_last_known_file_type(type = nil)
  if type
    self.last_known_file_type = type
  elsif path
    extension = Pathname(path).extname[1..-1]
    self.last_known_file_type = Constants::FILE_TYPES_BY_EXTENSION[extension]
  end
end

#set_path(path) ⇒ void

This method returns an undefined value.

Allows to set the path according to the source tree of the reference.

Parameters:

  • the (#to_s) —

    path for the reference.



196
197
198
199
200
201
202
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 196

def set_path(path)
  if path
    GroupableHelper.set_path_with_source_tree(self, path, source_tree)
  else
    self.path = nil
  end
end

#set_source_tree(source_tree) ⇒ void

This method returns an undefined value.

Sets the source tree of the reference.

Parameters:

  • source_tree (Symbol, String) —

    The source tree, either a string or a symbol.



186
187
188
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 186

def set_source_tree(source_tree)
  GroupableHelper.set_source_tree(self, source_tree)
end

#target_dependency_proxies ⇒ Array<PBXTargetDependency>

If this file reference represents an external Xcode project reference then this will return dependencies on targets contained in the external Xcode project.

Returns:

  • (Array<PBXTargetDependency>) —

    The dependencies on targets located in the external Xcode project.



303
304
305
306
307
308
309
310
311
312
313
 
# File 'lib/xcodeproj/project/object/file_reference.rb', line 303

def target_dependency_proxies
  containers = proxy_containers
  if containers.empty?
    []
  else
    project.objects.select do |object|
      object.isa == 'PBXTargetDependency' &&
        containers.include?(object.target_proxy)
    end
  end
end