cocoapods-dependency-html 0.0.1

data/vendor/bundle/gems/cocoapods-1.6.1/lib/cocoapods/installer/xcode/pods_project_generator/pod_target_installer.rb

@@ -0,0 +1,837 @@
+module Pod
+  class Installer
+    class Xcode
+      class PodsProjectGenerator
+        # Creates the target for the Pods libraries in the Pods project and the
+        # relative support files.
+        #
+        class PodTargetInstaller < TargetInstaller
+          require 'cocoapods/installer/xcode/pods_project_generator/app_host_installer'
+
+          # @return [Array<Pathname>] Array of umbrella header paths in the headers directory
+          #
+          attr_reader :umbrella_header_paths
+
+          # Initialize a new instance
+          #
+          # @param [Sandbox] sandbox @see TargetInstaller#sandbox
+          # @param [Pod::Project] project @see TargetInstaller#project
+          # @param [Target] target @see TargetInstaller#target
+          # @param [Array<Pathname>] umbrella_header_paths @see #umbrella_header_paths
+          #
+          def initialize(sandbox, project, target, umbrella_header_paths = nil)
+            super(sandbox, project, target)
+            @umbrella_header_paths = umbrella_header_paths
+          end
+
+          # Creates the target in the Pods project and the relative support files.
+          #
+          # @return [TargetInstallationResult] the result of the installation of this target.
+          #
+          def install!
+            UI.message "- Installing target `#{target.name}` #{target.platform}" do
+              create_support_files_dir
+              test_file_accessors, file_accessors = target.file_accessors.partition { |fa| fa.spec.test_specification? }
+
+              unless target.should_build?
+                # For targets that should not be built (e.g. pre-built vendored frameworks etc), we add a placeholder
+                # PBXAggregateTarget that will be used to wire up dependencies later.
+                native_target = add_placeholder_target
+                resource_bundle_targets = add_resources_bundle_targets(file_accessors).values.flatten
+                create_xcconfig_file(native_target, resource_bundle_targets)
+                return TargetInstallationResult.new(target, native_target, resource_bundle_targets)
+              end
+
+              native_target = add_target
+              resource_bundle_targets = add_resources_bundle_targets(file_accessors).values.flatten
+
+              test_native_targets = add_test_targets
+              test_app_host_targets = add_test_app_host_targets(test_native_targets)
+              test_resource_bundle_targets = add_resources_bundle_targets(test_file_accessors)
+
+              add_files_to_build_phases(native_target, test_native_targets)
+              validate_targets_contain_sources(test_native_targets + [native_target])
+
+              create_xcconfig_file(native_target, resource_bundle_targets)
+              create_test_xcconfig_files(test_native_targets, test_resource_bundle_targets)
+
+              if target.defines_module?
+                create_module_map(native_target) do |generator|
+                  generator.headers.concat module_map_additional_headers
+                end
+                create_umbrella_header(native_target) do |generator|
+                  generator.imports += file_accessors.flat_map do |file_accessor|
+                    header_dir = if !target.requires_frameworks? && dir = file_accessor.spec_consumer.header_dir
+                                   Pathname.new(dir)
+                    end
+
+                    file_accessor.public_headers.map do |public_header|
+                      public_header = if header_mappings_dir
+                                        public_header.relative_path_from(header_mappings_dir)
+                                      else
+                                        public_header.basename
+                                      end
+                      if header_dir
+                        public_header = header_dir.join(public_header)
+                      end
+                      public_header
+                    end
+                  end
+                end
+              end
+
+              if target.requires_frameworks?
+                unless skip_info_plist?(native_target)
+                  create_info_plist_file(target.info_plist_path, native_target, target.version, target.platform)
+                end
+                create_build_phase_to_symlink_header_folders(native_target)
+              elsif target.uses_swift?
+                add_swift_static_library_compatibility_header_phase(native_target)
+              end
+
+              unless skip_pch?(target.non_test_specs)
+                path = target.prefix_header_path
+                create_prefix_header(path, file_accessors, target.platform, native_target)
+              end
+              unless skip_pch?(target.test_specs)
+                target.test_specs.each do |test_spec|
+                  path = target.prefix_header_path_for_test_spec(test_spec)
+                  test_spec_consumer = test_spec.consumer(target.platform)
+                  test_native_target = test_native_target_from_spec_consumer(test_spec_consumer, test_native_targets)
+                  create_prefix_header(path, test_file_accessors, target.platform, test_native_target)
+                end
+              end
+              create_dummy_source(native_target)
+              clean_support_files_temp_dir
+              TargetInstallationResult.new(target, native_target, resource_bundle_targets, test_native_targets,
+                                           test_resource_bundle_targets, test_app_host_targets)
+            end
+          end
+
+          private
+
+          # @param [Array<Specification>] specs
+          #        the specs to check against whether `.pch` generation should be skipped or not.
+          #
+          # @return [Boolean] Whether the target should build a pch file.
+          #
+          def skip_pch?(specs)
+            specs.any? { |spec| spec.prefix_header_file.is_a?(FalseClass) }
+          end
+
+          # True if info.plist generation should be skipped
+          #
+          # @param [PXNativeTarget] native_target
+          #
+          # @return [Boolean] Whether the target should build an Info.plist file
+          #
+          def skip_info_plist?(native_target)
+            existing_setting = native_target.resolved_build_setting('INFOPLIST_FILE', true).values.compact
+            !existing_setting.empty?
+          end
+
+          # Remove the default headers folder path settings for static library pod
+          # targets.
+          #
+          # @return [Hash{String => String}]
+          #
+          def custom_build_settings
+            settings = super
+            unless target.requires_frameworks?
+              settings['PRIVATE_HEADERS_FOLDER_PATH'] = ''
+              settings['PUBLIC_HEADERS_FOLDER_PATH'] = ''
+            end
+
+            settings['PRODUCT_NAME'] = target.product_basename
+            settings['PRODUCT_MODULE_NAME'] = target.product_module_name
+
+            settings['CODE_SIGN_IDENTITY[sdk=appletvos*]'] = ''
+            settings['CODE_SIGN_IDENTITY[sdk=iphoneos*]'] = ''
+            settings['CODE_SIGN_IDENTITY[sdk=watchos*]'] = ''
+
+            settings['SWIFT_ACTIVE_COMPILATION_CONDITIONS'] = '$(inherited) '
+
+            if target.swift_version
+              settings['SWIFT_VERSION'] = target.swift_version
+            end
+
+            settings
+          end
+
+          # Filters the given resource file references discarding empty paths which are
+          # added by their parent directory. This will also include references to the parent [PBXVariantGroup]
+          # for all resources underneath it.
+          #
+          # @param  [Array<Pathname>] resource_file_references
+          #         The array of all resource file references to filter.
+          #
+          # @yield_param  [Array<PBXFileReference>} The filtered resource file references to be installed
+          #               in the copy resources phase.
+          #
+          # @yield_param  [Array<PBXFileReference>} The filtered resource file references to be installed
+          #               in the compile sources phase.
+          #
+          # @note   Core Data model directories (.xcdatamodeld) used to be added to the
+          #         `Copy Resources` build phase like all other resources, since they would
+          #         compile correctly in either the resources or compile phase. In recent
+          #         versions of xcode, there's an exception for data models that generate
+          #         headers. These need to be added to the compile sources phase of a real
+          #         target for the headers to be built in time for code in the target to
+          #         use them. These kinds of models generally break when added to resource
+          #         bundles.
+          #
+          def filter_resource_file_references(resource_file_references)
+            file_references = resource_file_references.map do |resource_file_reference|
+              ref = project.reference_for_path(resource_file_reference)
+
+              # Some nested files are not directly present in the Xcode project, such as the contents
+              # of an .xcdatamodeld directory. These files are implicitly included by including their
+              # parent directory.
+              next if ref.nil?
+
+              # For variant groups, the variant group itself is added, not its members.
+              next ref.parent if ref.parent.is_a?(Xcodeproj::Project::Object::PBXVariantGroup)
+
+              ref
+            end.compact.uniq
+            compile_phase_matcher = lambda { |ref| !(ref.path =~ /.*\.xcdatamodeld/i).nil? }
+            resources_phase_refs = file_references.reject(&compile_phase_matcher)
+            compile_phase_refs = file_references.select(&compile_phase_matcher)
+            yield resources_phase_refs, compile_phase_refs
+          end
+
+          #-----------------------------------------------------------------------#
+
+          # Adds the build files of the pods to the target and adds a reference to
+          # the frameworks of the Pods.
+          #
+          # @note   The Frameworks are used only for presentation purposes as the
+          #         xcconfig is the authoritative source about their information.
+          #
+          # @note   Core Data model directories (.xcdatamodeld) defined in the `resources`
+          #         property are currently added to the `Copy Resources` build phase like
+          #         all other resources. The Xcode UI adds these to the `Compile Sources`
+          #         build phase, but they will compile correctly either way.
+          #
+          # @return [void]
+          #
+          def add_files_to_build_phases(native_target, test_native_targets)
+            target.file_accessors.each do |file_accessor|
+              consumer = file_accessor.spec_consumer
+
+              native_target = if !consumer.spec.test_specification?
+                                native_target
+                              else
+                                test_native_target_from_spec_consumer(consumer, test_native_targets)
+                              end
+
+              headers = file_accessor.headers
+              public_headers = file_accessor.public_headers.map(&:realpath)
+              private_headers = file_accessor.private_headers.map(&:realpath)
+              other_source_files = file_accessor.other_source_files
+
+              {
+                true => file_accessor.arc_source_files,
+                false => file_accessor.non_arc_source_files,
+              }.each do |arc, files|
+                next if files.empty?
+                files = files - headers - other_source_files
+                flags = compiler_flags_for_consumer(consumer, arc)
+                regular_file_refs = project_file_references_array(files, 'source')
+                native_target.add_file_references(regular_file_refs, flags)
+              end
+
+              header_file_refs = project_file_references_array(headers, 'header')
+              native_target.add_file_references(header_file_refs) do |build_file|
+                add_header(build_file, public_headers, private_headers, native_target)
+              end
+
+              other_file_refs = project_file_references_array(other_source_files, 'other source')
+              native_target.add_file_references(other_file_refs, nil)
+
+              next unless target.requires_frameworks?
+
+              filter_resource_file_references(file_accessor.resources.flatten) do |resource_phase_refs, compile_phase_refs|
+                native_target.add_file_references(compile_phase_refs, nil)
+                native_target.add_resources(resource_phase_refs)
+              end
+            end
+          end
+
+          # Adds the test targets for the library to the Pods project with the
+          # appropriate build configurations.
+          #
+          # @return [Array<PBXNativeTarget>] the test native targets created.
+          #
+          def add_test_targets
+            target.test_specs.map do |test_spec|
+              spec_consumer = test_spec.consumer(target.platform)
+              test_type = spec_consumer.test_type
+              product_type = target.product_type_for_test_type(test_type)
+              name = target.test_target_label(test_spec)
+              platform_name = target.platform.name
+              language = target.uses_swift_for_test_spec?(test_spec) ? :swift : :objc
+              test_native_target = project.new_target(product_type, name, platform_name, deployment_target, nil, language)
+              test_native_target.product_reference.name = name
+
+              target.user_build_configurations.each do |bc_name, type|
+                test_native_target.add_build_configuration(bc_name, type)
+              end
+
+              test_native_target.build_configurations.each do |configuration|
+                configuration.build_settings.merge!(custom_build_settings)
+                # target_installer will automatically add an empty `OTHER_LDFLAGS`. For test
+                # targets those are set via a test xcconfig file instead.
+                configuration.build_settings.delete('OTHER_LDFLAGS')
+                # target_installer will automatically set the product name to the module name if the target
+                # requires frameworks. For tests we always use the test target name as the product name
+                # irrelevant to whether we use frameworks or not.
+                configuration.build_settings['PRODUCT_NAME'] = name
+                # target_installer sets 'MACH_O_TYPE' for static frameworks ensure this does not propagate
+                # to test target.
+                configuration.build_settings.delete('MACH_O_TYPE')
+                # Use xcode default product module name, which is $(PRODUCT_NAME:c99extidentifier)
+                # this gives us always valid name that is distinct from the parent spec module name
+                # which allow tests to use either import or @testable import to access the parent framework
+                configuration.build_settings.delete('PRODUCT_MODULE_NAME')
+                # We must codesign iOS XCTest bundles that contain binary frameworks to allow them to be launchable in the simulator
+                unless target.platform == :osx
+                  configuration.build_settings['CODE_SIGNING_REQUIRED'] = 'YES'
+                  configuration.build_settings['CODE_SIGNING_ALLOWED'] = 'YES'
+                end
+                # For macOS we do not code sign the XCTest bundle because we do not code sign the frameworks either.
+                configuration.build_settings['CODE_SIGN_IDENTITY'] = '' if target.platform == :osx
+              end
+
+              # Test native targets also need frameworks and resources to be copied over to their xctest bundle.
+              create_test_target_embed_frameworks_script(test_spec)
+              create_test_target_copy_resources_script(test_spec)
+
+              # Generate vanilla Info.plist for test target similar to the one Xcode generates for new test target.
+              # This creates valid test bundle accessible at the runtime, allowing tests to load bundle resources
+              # defined in podspec.
+              create_info_plist_file(target.info_plist_path_for_test_spec(test_spec), test_native_target, '1.0', target.platform, :bndl)
+
+              test_native_target
+            end
+          end
+
+          # Adds the test app host targets for the library to the Pods project with the
+          # appropriate build configurations.
+          #
+          # @param  [Array<PBXNativeTarget>] test_native_targets
+          #         the test native targets that have been created to use as a lookup when linking the app host to.
+          #
+          # @return [Array<PBXNativeTarget>] the app host targets created.
+          #
+          def add_test_app_host_targets(test_native_targets)
+            target.test_spec_consumers.select(&:requires_app_host?).group_by(&:test_type).map do |test_type, test_spec_consumers|
+              platform = target.platform
+              name = "AppHost-#{target.label}-#{test_type.capitalize}-Tests"
+              app_host_target = AppHostInstaller.new(sandbox, project, platform, name, target.pod_name).install!
+              # Wire test native targets to the generated app host.
+              test_spec_consumers.each do |test_spec_consumer|
+                test_native_target = test_native_target_from_spec_consumer(test_spec_consumer, test_native_targets)
+                test_native_target.build_configurations.each do |configuration|
+                  test_host = "$(BUILT_PRODUCTS_DIR)/#{app_host_target.name}.app/"
+                  test_host << 'Contents/MacOS/' if platform == :osx
+                  test_host << app_host_target.name.to_s
+                  configuration.build_settings['TEST_HOST'] = test_host
+                end
+                target_attributes = project.root_object.attributes['TargetAttributes'] || {}
+                target_attributes[test_native_target.uuid.to_s] = { 'TestTargetID' => app_host_target.uuid.to_s }
+                project.root_object.attributes['TargetAttributes'] = target_attributes
+                test_native_target.add_dependency(app_host_target)
+              end
+              app_host_target
+            end
+          end
+
+          # Adds the resources of the Pods to the Pods project.
+          #
+          # @note   The source files are grouped by Pod and in turn by subspec
+          #         (recursively) in the resources group.
+          #
+          # @param  [Array<Sandbox::FileAccessor>] file_accessors
+          #         the file accessors list to generate resource bundles for.
+          #
+          # @return [Array<PBXNativeTarget] the resource bundle native targets created.
+          #
+          def add_resources_bundle_targets(file_accessors)
+            file_accessors.each_with_object({}) do |file_accessor, hash|
+              hash[file_accessor.spec.name] = file_accessor.resource_bundles.map do |bundle_name, paths|
+                label = target.resources_bundle_target_label(bundle_name)
+                resource_bundle_target = project.new_resources_bundle(label, file_accessor.spec_consumer.platform_name)
+                resource_bundle_target.product_reference.tap do |bundle_product|
+                  bundle_file_name = "#{bundle_name}.bundle"
+                  bundle_product.name = bundle_file_name
+                end
+
+                contains_compile_phase_refs = false
+                filter_resource_file_references(paths) do |resource_phase_refs, compile_phase_refs|
+                  # Resource bundles are only meant to have resources, so install everything
+                  # into the resources phase. See note in filter_resource_file_references.
+                  resource_bundle_target.add_resources(resource_phase_refs + compile_phase_refs)
+                  contains_compile_phase_refs = !compile_phase_refs.empty?
+                end
+
+                target.user_build_configurations.each do |bc_name, type|
+                  resource_bundle_target.add_build_configuration(bc_name, type)
+                end
+                resource_bundle_target.deployment_target = deployment_target
+
+                # Create Info.plist file for bundle
+                path = target.info_plist_path
+                path.dirname.mkdir unless path.dirname.exist?
+                info_plist_path = path.dirname + "ResourceBundle-#{bundle_name}-#{path.basename}"
+                create_info_plist_file(info_plist_path, resource_bundle_target, target.version, target.platform, :bndl)
+
+                resource_bundle_target.build_configurations.each do |configuration|
+                  configuration.build_settings['PRODUCT_NAME'] = bundle_name
+                  # Do not set the CONFIGURATION_BUILD_DIR for resource bundles that are only meant for test targets.
+                  # This is because the test target itself also does not set this configuration build dir and it expects
+                  # all bundles to be copied from the default path.
+                  unless file_accessor.spec.test_specification?
+                    configuration.build_settings['CONFIGURATION_BUILD_DIR'] = target.configuration_build_dir('$(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)')
+                  end
+
+                  # Set the `SWIFT_VERSION` build setting for resource bundles that could have resources that get
+                  # compiled such as an `xcdatamodeld` file which has 'Swift' as its code generation language.
+                  if contains_compile_phase_refs && target.uses_swift?
+                    configuration.build_settings['SWIFT_VERSION'] = target.swift_version
+                  end
+
+                  # Set the correct device family for this bundle, based on the platform
+                  device_family_by_platform = {
+                    :ios => '1,2',
+                    :tvos => '3',
+                    :watchos => '1,2' # The device family for watchOS is 4, but Xcode creates watchkit-compatible bundles as 1,2
+                  }
+
+                  if (family = device_family_by_platform[target.platform.name])
+                    configuration.build_settings['TARGETED_DEVICE_FAMILY'] = family
+                  end
+                end
+
+                resource_bundle_target
+              end
+            end
+          end
+
+          # Generates the contents of the xcconfig file and saves it to disk.
+          #
+          # @param  [PBXNativeTarget] native_target
+          #         the native target to link the xcconfig file into.
+          #
+          # @param  [Array<PBXNativeTarget>] resource_bundle_targets
+          #         the additional resource bundle targets to link the xcconfig file into.
+          #
+          # @return [void]
+          #
+          def create_xcconfig_file(native_target, resource_bundle_targets)
+            path = target.xcconfig_path
+            update_changed_file(target.build_settings, path)
+            xcconfig_file_ref = add_file_to_support_group(path)
+
+            native_target.build_configurations.each do |c|
+              c.base_configuration_reference = xcconfig_file_ref
+            end
+
+            # also apply the private config to resource bundle targets.
+            apply_xcconfig_file_ref_to_resource_bundle_targets(resource_bundle_targets, xcconfig_file_ref)
+          end
+
+          # Generates the contents of the xcconfig file used for each test target type and saves it to disk.
+          #
+          # @param  [Array<PBXNativeTarget>] test_native_targets
+          #         the test native target to link the xcconfig file into.
+          #
+          # @param  [Hash{String=>Array<PBXNativeTarget>}] test_resource_bundle_targets
+          #         the additional test resource bundle targets to link the xcconfig file into.
+          #
+          # @return [void]
+          #
+          def create_test_xcconfig_files(test_native_targets, test_resource_bundle_targets)
+            target.test_specs.each do |test_spec|
+              spec_consumer = test_spec.consumer(target.platform)
+              test_type = spec_consumer.test_type
+              path = target.xcconfig_path("#{test_type.capitalize}-#{test_spec.name.split('/')[1..-1].join('-')}")
+              update_changed_file(Target::BuildSettings::PodTargetSettings.new(target, test_spec), path)
+              test_xcconfig_file_ref = add_file_to_support_group(path)
+
+              test_native_target = test_native_target_from_spec_consumer(spec_consumer, test_native_targets)
+              test_native_target.build_configurations.each do |test_native_target_bc|
+                test_target_swift_debug_hack(test_spec, test_native_target_bc)
+                test_native_target_bc.base_configuration_reference = test_xcconfig_file_ref
+              end
+
+              # also apply the private config to resource bundle test targets related to this test spec.
+              scoped_test_resource_bundle_targets = test_resource_bundle_targets[test_spec.name]
+              unless scoped_test_resource_bundle_targets.empty?
+                apply_xcconfig_file_ref_to_resource_bundle_targets(scoped_test_resource_bundle_targets, test_xcconfig_file_ref)
+              end
+            end
+          end
+
+          # Creates a script that copies the resources to the bundle of the test target.
+          #
+          # @param [Specification] test_spec
+          #        The test spec to create the copy resources script for.
+          #
+          # @return [void]
+          #
+          def create_test_target_copy_resources_script(test_spec)
+            path = target.copy_resources_script_path_for_test_spec(test_spec)
+            pod_targets = target.dependent_targets_for_test_spec(test_spec)
+            resource_paths_by_config = target.user_build_configurations.keys.each_with_object({}) do |config, resources_by_config|
+              resources_by_config[config] = pod_targets.flat_map do |pod_target|
+                spec_paths_to_include = pod_target.non_test_specs.map(&:name)
+                spec_paths_to_include << test_spec.name if pod_target == target
+                pod_target.resource_paths.values_at(*spec_paths_to_include).flatten.compact
+              end
+            end
+            generator = Generator::CopyResourcesScript.new(resource_paths_by_config, target.platform)
+            update_changed_file(generator, path)
+            add_file_to_support_group(path)
+          end
+
+          # Creates a script that embeds the frameworks to the bundle of the test target.
+          #
+          # @param [Specification] test_spec
+          #        The test spec to create the embed frameworks script for.
+          #
+          # @return [void]
+          #
+          def create_test_target_embed_frameworks_script(test_spec)
+            path = target.embed_frameworks_script_path_for_test_spec(test_spec)
+            pod_targets = target.dependent_targets_for_test_spec(test_spec)
+            framework_paths_by_config = target.user_build_configurations.keys.each_with_object({}) do |config, paths_by_config|
+              paths_by_config[config] = pod_targets.flat_map do |pod_target|
+                spec_paths_to_include = pod_target.non_test_specs.map(&:name)
+                spec_paths_to_include << test_spec.name if pod_target == target
+                pod_target.framework_paths.values_at(*spec_paths_to_include).flatten.compact.uniq
+              end
+            end
+            generator = Generator::EmbedFrameworksScript.new(framework_paths_by_config)
+            update_changed_file(generator, path)
+            add_file_to_support_group(path)
+          end
+
+          # Manually add `libswiftSwiftOnoneSupport.dylib` as it seems there is an issue with tests that do not include it for Debug configurations.
+          # Possibly related to Swift module optimization.
+          #
+          # @return [void]
+          #
+          def test_target_swift_debug_hack(test_spec, test_target_bc)
+            return unless test_target_bc.debug?
+            return unless target.dependent_targets_for_test_spec(test_spec).any?(&:uses_swift?)
+            ldflags = test_target_bc.build_settings['OTHER_LDFLAGS'] ||= '$(inherited)'
+            ldflags << ' -lswiftSwiftOnoneSupport'
+          end
+
+          # Creates a build phase which links the versioned header folders
+          # of the OS X into the framework bundle's root root directory.
+          # This is only necessary because the way how headers are copied
+          # via custom copy file build phases in combination with
+          # header_mappings_dir interferes with xcodebuild's expectations
+          # about the existence of private or public headers.
+          #
+          # @param  [PBXNativeTarget] native_target
+          #         the native target to add the script phase into.
+          #
+          # @return [void]
+          #
+          def create_build_phase_to_symlink_header_folders(native_target)
+            return unless target.platform.name == :osx && header_mappings_dir
+
+            build_phase = native_target.new_shell_script_build_phase('Create Symlinks to Header Folders')
+            build_phase.shell_script = <<-eos.strip_heredoc
+          base="$CONFIGURATION_BUILD_DIR/$WRAPPER_NAME"
+          ln -fs "$base/${PUBLIC_HEADERS_FOLDER_PATH\#$WRAPPER_NAME/}" "$base/${PUBLIC_HEADERS_FOLDER_PATH\#\$CONTENTS_FOLDER_PATH/}"
+          ln -fs "$base/${PRIVATE_HEADERS_FOLDER_PATH\#\$WRAPPER_NAME/}" "$base/${PRIVATE_HEADERS_FOLDER_PATH\#\$CONTENTS_FOLDER_PATH/}"
+            eos
+          end
+
+          # Creates a prefix header file which imports `UIKit` or `Cocoa` according
+          # to the platform of the target. This file also include any prefix header
+          # content reported by the specification of the pods.
+          #
+          # @param [Pathname] path
+          #        the path to generate the prefix header for.
+          #
+          # @param [Array<Sandbox::FileAccessor>] file_accessors
+          #        the file accessors to use for this prefix header that point to a path of a prefix header.
+          #
+          # @param [Platform] platform
+          #        the platform to use for this prefix header.
+          #
+          # @param [PBXNativeTarget] native_target
+          #        the native target on which the prefix header should be configured for.
+          #
+          # @return [void]
+          #
+          def create_prefix_header(path, file_accessors, platform, native_target)
+            generator = Generator::PrefixHeader.new(file_accessors, platform)
+            update_changed_file(generator, path)
+            add_file_to_support_group(path)
+
+            relative_path = path.relative_path_from(project.path.dirname)
+            native_target.build_configurations.each do |c|
+              c.build_settings['GCC_PREFIX_HEADER'] = relative_path.to_s
+            end
+          end
+
+          ENABLE_OBJECT_USE_OBJC_FROM = {
+            :ios => Version.new('6'),
+            :osx => Version.new('10.8'),
+            :watchos => Version.new('2.0'),
+            :tvos => Version.new('9.0'),
+          }.freeze
+
+          # Returns the compiler flags for the source files of the given specification.
+          #
+          # The following behavior is regarding the `OS_OBJECT_USE_OBJC` flag. When
+          # set to `0`, it will allow code to use `dispatch_release()` on >= iOS 6.0
+          # and OS X 10.8.
+          #
+          # * New libraries that do *not* require ARC don’t need to care about this
+          #   issue at all.
+          #
+          # * New libraries that *do* require ARC _and_ have a deployment target of
+          #   >= iOS 6.0 or OS X 10.8:
+          #
+          #   These no longer use `dispatch_release()` and should *not* have the
+          #   `OS_OBJECT_USE_OBJC` flag set to `0`.
+          #
+          #   **Note:** this means that these libraries *have* to specify the
+          #             deployment target in order to function well.
+          #
+          # * New libraries that *do* require ARC, but have a deployment target of
+          #   < iOS 6.0 or OS X 10.8:
+          #
+          #   These contain `dispatch_release()` calls and as such need the
+          #   `OS_OBJECT_USE_OBJC` flag set to `1`.
+          #
+          #   **Note:** libraries that do *not* specify a platform version are
+          #             assumed to have a deployment target of < iOS 6.0 or OS X 10.8.
+          #
+          #  For more information, see: http://opensource.apple.com/source/libdispatch/libdispatch-228.18/os/object.h
+          #
+          # @param  [Specification::Consumer] consumer
+          #         The consumer for the specification for which the compiler flags
+          #         are needed.
+          #
+          # @return [String] The compiler flags.
+          #
+          def compiler_flags_for_consumer(consumer, arc)
+            flags = consumer.compiler_flags.dup
+            if !arc
+              flags << '-fno-objc-arc'
+            else
+              platform_name = consumer.platform_name
+              spec_deployment_target = consumer.spec.deployment_target(platform_name)
+              if spec_deployment_target.nil? || Version.new(spec_deployment_target) < ENABLE_OBJECT_USE_OBJC_FROM[platform_name]
+                flags << '-DOS_OBJECT_USE_OBJC=0'
+              end
+            end
+            if target.inhibit_warnings?
+              flags << '-w -Xanalyzer -analyzer-disable-all-checks'
+            end
+            flags * ' '
+          end
+
+          def apply_xcconfig_file_ref_to_resource_bundle_targets(resource_bundle_targets, xcconfig_file_ref)
+            resource_bundle_targets.each do |rsrc_target|
+              rsrc_target.build_configurations.each do |rsrc_bc|
+                rsrc_bc.base_configuration_reference = xcconfig_file_ref
+              end
+            end
+          end
+
+          def create_module_map(native_target)
+            return super(native_target) unless custom_module_map
+
+            path = target.module_map_path_to_write
+            UI.message "- Copying module map file to #{UI.path(path)}" do
+              contents = custom_module_map.read
+              unless target.requires_frameworks?
+                contents.gsub!(/^(\s*)framework\s+(module[^{}]+){/, '\1\2{')
+              end
+              generator = Generator::Constant.new(contents)
+              update_changed_file(generator, path)
+              add_file_to_support_group(path)
+
+              linked_path = target.module_map_path
+              if path != linked_path
+                linked_path.dirname.mkpath
+                source = path.relative_path_from(linked_path.dirname)
+                FileUtils.ln_sf(source, linked_path)
+              end
+
+              relative_path = target.module_map_path.relative_path_from(sandbox.root).to_s
+              native_target.build_configurations.each do |c|
+                c.build_settings['MODULEMAP_FILE'] = relative_path.to_s
+              end
+            end
+          end
+
+          def module_map_additional_headers
+            return [] unless umbrella_header_paths
+
+            other_paths = umbrella_header_paths - [target.umbrella_header_path]
+            other_paths.map do |module_map_path|
+              # exclude other targets umbrella headers, to avoid
+              # incomplete umbrella warnings
+              Generator::ModuleMap::Header.new(module_map_path.basename, nil, nil, nil, true)
+            end
+          end
+
+          def create_umbrella_header(native_target)
+            return super(native_target) unless custom_module_map
+          end
+
+          def custom_module_map
+            @custom_module_map ||= target.file_accessors.first.module_map
+          end
+
+          def project_file_references_array(files, file_type)
+            files.map do |sf|
+              project.reference_for_path(sf).tap do |ref|
+                raise Informative, "Unable to find #{file_type} ref for #{sf} for target #{target.name}." unless ref
+              end
+            end
+          end
+
+          def header_mappings_dir
+            return @header_mappings_dir if defined?(@header_mappings_dir)
+            file_accessor = target.file_accessors.first
+            @header_mappings_dir = if dir = file_accessor.spec_consumer.header_mappings_dir
+                                     file_accessor.path_list.root + dir
+                                   end
+          end
+
+          def add_header(build_file, public_headers, private_headers, native_target)
+            file_ref = build_file.file_ref
+            acl = if !target.requires_frameworks? # Headers are already rooted at ${PODS_ROOT}/Headers/P*/[pod]/...
+                    'Project'
+                  elsif public_headers.include?(file_ref.real_path)
+                    'Public'
+                  elsif private_headers.include?(file_ref.real_path)
+                    'Private'
+                  else
+                    'Project'
+                  end
+
+            if target.requires_frameworks? && header_mappings_dir && acl != 'Project'
+              relative_path = file_ref.real_path.relative_path_from(header_mappings_dir)
+              sub_dir = relative_path.dirname
+              copy_phase_name = "Copy #{sub_dir} #{acl} Headers"
+              copy_phase = native_target.copy_files_build_phases.find { |bp| bp.name == copy_phase_name } ||
+                native_target.new_copy_files_build_phase(copy_phase_name)
+              copy_phase.symbol_dst_subfolder_spec = :products_directory
+              copy_phase.dst_path = "$(#{acl.upcase}_HEADERS_FOLDER_PATH)/#{sub_dir}"
+              copy_phase.add_file_reference(file_ref, true)
+            else
+              build_file.settings ||= {}
+              build_file.settings['ATTRIBUTES'] = [acl]
+            end
+          end
+
+          def support_files_group
+            pod_name = target.pod_name
+            dir = target.support_files_dir
+            project.pod_support_files_group(pod_name, dir)
+          end
+
+          # @param [String] name
+          #        The name of the app host.
+
+          # @param [Symbol] test_type
+          #        The test type this Info.plist path is for.
+          #
+          # @return [Pathname] The absolute path of the Info.plist to use for an app host.
+          #
+          def app_host_info_plist_path_for_test_type(name, test_type)
+            project.path.dirname.+("#{name}/#{target.app_host_label(test_type)}-Info.plist")
+          end
+
+          def test_native_target_from_spec_consumer(spec_consumer, test_native_targets)
+            test_native_targets.find do |test_native_target|
+              test_native_target.name == target.test_target_label(spec_consumer.spec)
+            end
+          end
+
+          # Adds a placeholder native target for the library to the Pods project with the
+          # appropriate build configurations.
+          #
+          # @return [PBXAggregateTarget] the native target that was added.
+          #
+          def add_placeholder_target
+            native_target = project.new_aggregate_target(target.label, [], target.platform.name, deployment_target)
+            target.user_build_configurations.each do |bc_name, type|
+              native_target.add_build_configuration(bc_name, type)
+            end
+            unless target.archs.empty?
+              native_target.build_configurations.each do |configuration|
+                configuration.build_settings['ARCHS'] = target.archs
+              end
+            end
+            native_target
+          end
+
+          # Adds a shell script phase, intended only for static library targets that contain swift,
+          # to copy the ObjC compatibility header (the -Swift.h file that the swift compiler generates)
+          # to the built products directory. Additionally, the script phase copies the module map, appending a `.Swift`
+          # submodule that references the (moved) compatibility header. Since the module map has been moved, the umbrella header
+          # is _also_ copied, so that it is sitting next to the module map. This is necessary for a successful archive build.
+          #
+          # @param  [PBXNativeTarget] native_target
+          #         the native target to add the Swift static library script phase into.
+          #
+          # @return [Void]
+          #
+          def add_swift_static_library_compatibility_header_phase(native_target)
+            if custom_module_map
+              raise Informative, 'Using Swift static libraries with custom module maps is currently not supported. ' \
+                                 "Please build `#{target.label}` as a framework or remove the custom module map."
+            end
+
+            build_phase = native_target.new_shell_script_build_phase('Copy generated compatibility header')
+
+            relative_module_map_path = target.module_map_path.relative_path_from(target.sandbox.root)
+            relative_umbrella_header_path = target.umbrella_header_path.relative_path_from(target.sandbox.root)
+
+            build_phase.shell_script = <<-SH.strip_heredoc
+              COMPATIBILITY_HEADER_PATH="${BUILT_PRODUCTS_DIR}/Swift Compatibility Header/${PRODUCT_MODULE_NAME}-Swift.h"
+              MODULE_MAP_PATH="${BUILT_PRODUCTS_DIR}/${PRODUCT_MODULE_NAME}.modulemap"
+
+              ditto "${DERIVED_SOURCES_DIR}/${PRODUCT_MODULE_NAME}-Swift.h" "${COMPATIBILITY_HEADER_PATH}"
+              ditto "${PODS_ROOT}/#{relative_module_map_path}" "${MODULE_MAP_PATH}"
+              ditto "${PODS_ROOT}/#{relative_umbrella_header_path}" "${BUILT_PRODUCTS_DIR}"
+              printf "\\n\\nmodule ${PRODUCT_MODULE_NAME}.Swift {\\n  header \\"${COMPATIBILITY_HEADER_PATH}\\"\\n  requires objc\\n}\\n" >> "${MODULE_MAP_PATH}"
+            SH
+            build_phase.input_paths = %W(
+              ${DERIVED_SOURCES_DIR}/${PRODUCT_MODULE_NAME}-Swift.h
+              ${PODS_ROOT}/#{relative_module_map_path}
+              ${PODS_ROOT}/#{relative_umbrella_header_path}
+            )
+            build_phase.output_paths = %W(
+              ${BUILT_PRODUCTS_DIR}/${PRODUCT_MODULE_NAME}.modulemap
+              ${BUILT_PRODUCTS_DIR}/#{relative_umbrella_header_path.basename}
+              ${BUILT_PRODUCTS_DIR}/Swift\ Compatibility\ Header/${PRODUCT_MODULE_NAME}-Swift.h
+            )
+          end
+
+          def validate_targets_contain_sources(native_targets)
+            native_targets.each do |native_target|
+              next unless native_target.source_build_phase.files.empty?
+              raise Informative, "Unable to install the `#{target.label}` pod, because the `#{native_target}` target in Xcode would have no sources to compile."
+            end
+          end
+
+          #-----------------------------------------------------------------------#
+        end
+      end
+    end
+  end
+end