cocoapods-dykit 0.5.2 → 0.5.3

data/lib/pod/installer/pre_install_hooks_context.rb

@@ -0,0 +1,42 @@
+module Pod
+  class DyInstaller
+    # Context object designed to be used with the HooksManager which describes
+    # the context of the installer before analysis has been completed.
+    #
+    class PreInstallHooksContext
+      # @return [String] The path to the sandbox root (`Pods` directory).
+      #
+      attr_accessor :sandbox_root
+
+      # @return [Podfile] The Podfile for the project.
+      #
+      attr_accessor :podfile
+
+      # @return [Sandbox] The Sandbox for the project.
+      #
+      attr_accessor :sandbox
+
+      # @return [Lockfile] The Lockfile for the project.
+      #
+      attr_accessor :lockfile
+
+      # @param  [Sandbox] sandbox see {#sandbox}
+      #
+      # @param  [Podfile] podfile see {#podfile}
+      #
+      # @param  [Lockfile] lockfile see {#lockfile}
+      #
+      # @return [PreInstallHooksContext] Convenience class method to generate the
+      #         static context.
+      #
+      def self.generate(sandbox, podfile, lockfile)
+        result = new
+        result.podfile = podfile
+        result.sandbox = sandbox
+        result.sandbox_root = sandbox.root.to_s
+        result.lockfile = lockfile
+        result
+      end
+    end
+  end
+end

data/lib/pod/installer/source_provider_hooks_context.rb

@@ -0,0 +1,32 @@
+module Pod
+  class DyInstaller
+    # Context object designed to be used with the HooksManager which describes
+    # the context of the installer before spec sources have been created
+    #
+    class SourceProviderHooksContext
+      # @return [Array<Source>] The source objects to send to the installer
+      #
+      attr_reader :sources
+
+      # @return [SourceProviderHooksContext] Convenience class method to generate the
+      #         static context.
+      #
+      def self.generate
+        result = new
+        result
+      end
+
+      def initialize
+        @sources = []
+      end
+
+      # @param [Source] Source object to be added to the installer
+      #
+      def add_source(source)
+        unless source.nil?
+          @sources << source
+        end
+      end
+    end
+  end
+end

data/lib/pod/installer/user_project_integrator.rb

@@ -0,0 +1,253 @@
+require 'xcodeproj/workspace'
+require 'xcodeproj/project'
+
+require 'active_support/core_ext/string/inflections'
+require 'active_support/core_ext/array/conversions'
+
+module Pod
+  class DyInstaller
+    # The {UserProjectIntegrator} integrates the libraries generated by
+    # TargetDefinitions of the {Podfile} with their correspondent user
+    # projects.
+    #
+    class UserProjectIntegrator
+      autoload :TargetIntegrator, File.expand_path('../user_project_integrator/target_integrator', __FILE__)
+
+      # @return [Podfile] the podfile that should be integrated with the user
+      #         projects.
+      #
+      attr_reader :podfile
+
+      # @return [Project] the pods project which contains the libraries to
+      #         integrate.
+      #
+      # attr_reader :pods_project
+
+      attr_reader :sandbox
+
+      # @return [Pathname] the path of the installation.
+      #
+      # @todo This is only used to compute the workspace path in case that it
+      #       should be inferred by the project. If the workspace should be in
+      #       the same dir of the project, this could be removed.
+      #
+      attr_reader :installation_root
+
+      # @return [Array<AggregateTarget>] the targets represented in the Podfile.
+      #
+      attr_reader :targets
+
+      # Init a new UserProjectIntegrator
+      #
+      # @param  [Podfile]  podfile @see #podfile
+      # @param  [Sandbox]  sandbox @see #sandbox
+      # @param  [Pathname] installation_root @see #installation_root
+      # @param  [Array<AggregateTarget>]  targets @see #targets
+      #
+      # @todo   Too many initialization arguments
+      #
+      def initialize(podfile, sandbox, installation_root, targets)
+        @podfile = podfile
+        @sandbox = sandbox
+        @installation_root = installation_root
+        @targets = targets
+      end
+
+      # Integrates the user projects associated with the {TargetDefinitions}
+      # with the Pods project and its products.
+      #
+      # @return [void]
+      #
+      def integrate!
+        create_workspace
+        integrate_user_targets
+        warn_about_xcconfig_overrides
+        save_projects
+      end
+
+      #-----------------------------------------------------------------------#
+
+      private
+
+      # @!group Integration steps
+
+      # Creates and saved the workspace containing the Pods project and the
+      # user projects, if needed.
+      #
+      # @note If the workspace already contains the projects it is not saved
+      #       to avoid Xcode from displaying the revert dialog: `Do you want to
+      #       keep the Xcode version or revert to the version on disk?`
+      #
+      # @return [void]
+      #
+      def create_workspace
+        all_projects = user_project_paths.sort.push(sandbox.project_path).uniq
+        file_references = all_projects.map do |path|
+          relative_path = path.relative_path_from(workspace_path.dirname).to_s
+          Xcodeproj::Workspace::FileReference.new(relative_path, 'group')
+        end
+
+        if workspace_path.exist?
+          workspace = Xcodeproj::Workspace.new_from_xcworkspace(workspace_path)
+          new_file_references = file_references - workspace.file_references
+          unless new_file_references.empty?
+            new_file_references.each { |fr| workspace << fr }
+            workspace.save_as(workspace_path)
+          end
+
+        else
+          UI.notice "Please close any current Xcode sessions and use `#{workspace_path.basename}` for this project from now on."
+          workspace = Xcodeproj::Workspace.new(*file_references)
+          workspace.save_as(workspace_path)
+        end
+      end
+
+      # Integrates the targets of the user projects with the libraries
+      # generated from the {Podfile}.
+      #
+      # @note   {TargetDefinition} without dependencies are skipped prevent
+      #         creating empty libraries for targets definitions which are only
+      #         wrappers for others.
+      #
+      # @return [void]
+      #
+      def integrate_user_targets
+        target_integrators = targets_to_integrate.sort_by(&:name).map do |target|
+          puts "target --> #{target}"
+          TargetIntegrator.new(target)
+        end
+
+        Config.instance.with_changes(:silent => true) do
+          deintegrator = Deintegrator.new
+          all_project_targets = user_projects.flat_map(&:native_targets).uniq
+          all_native_targets = targets_to_integrate.flat_map(&:user_targets).uniq
+          targets_to_deintegrate = all_project_targets - all_native_targets
+          targets_to_deintegrate.each do |target|
+            deintegrator.deintegrate_target(target)
+          end
+        end
+
+        target_integrators.each(&:integrate!)
+      end
+
+      # Save all user projects.
+      #
+      # @return [void]
+      #
+      def save_projects
+        user_projects.each do |project|
+          if project.dirty?
+            project.save
+          else
+            # There is a bug in Xcode where the process of deleting and
+            # re-creating the xcconfig files used in the build
+            # configuration cause building the user project to fail until
+            # Xcode is relaunched.
+            #
+            # Touching/saving the project causes Xcode to reload these.
+            #
+            # https://github.com/CocoaPods/CocoaPods/issues/2665
+            FileUtils.touch(project.path + 'project.pbxproj')
+          end
+        end
+      end
+
+      IGNORED_KEYS = %w(CODE_SIGN_IDENTITY).freeze
+      INHERITED_FLAGS = %w($(inherited) ${inherited}).freeze
+
+      # Checks whether the settings of the CocoaPods generated xcconfig are
+      # overridden by the build configuration of a target and prints a
+      # warning to inform the user if needed.
+      #
+      def warn_about_xcconfig_overrides
+        targets.each do |aggregate_target|
+          aggregate_target.user_targets.each do |user_target|
+            user_target.build_configurations.each do |config|
+              xcconfig = aggregate_target.xcconfigs[config.name]
+              if xcconfig
+                (xcconfig.to_hash.keys - IGNORED_KEYS).each do |key|
+                  target_values = config.build_settings[key]
+                  if target_values &&
+                      !INHERITED_FLAGS.any? { |flag| target_values.include?(flag) }
+                    print_override_warning(aggregate_target, user_target, config, key)
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+
+      private
+
+      # @!group Private Helpers
+      #-----------------------------------------------------------------------#
+
+      # @return [Pathname] the path where the workspace containing the Pods
+      #         project and the user projects should be saved.
+      #
+      def workspace_path
+        if podfile.workspace_path
+          declared_path = podfile.workspace_path
+          path_with_ext = File.extname(declared_path) == '.xcworkspace' ? declared_path : "#{declared_path}.xcworkspace"
+          podfile_dir   = File.dirname(podfile.defined_in_file || '')
+          absolute_path = File.expand_path(path_with_ext, podfile_dir)
+          Pathname.new(absolute_path)
+        elsif user_project_paths.count == 1
+          project = user_project_paths.first.basename('.xcodeproj')
+          installation_root + "#{project}.xcworkspace"
+        else
+          raise Informative, 'Could not automatically select an Xcode ' \
+            "workspace. Specify one in your Podfile like so:\n\n"       \
+            "    workspace 'path/to/Workspace.xcworkspace'\n"
+        end
+      end
+
+      # @return [Array<Pathname>] the paths of all the user projects referenced
+      #         by the target definitions.
+      #
+      # @note   Empty target definitions are ignored.
+      #
+      def user_project_paths
+        targets.map(&:user_project_path).compact.uniq
+      end
+
+      def user_projects
+        targets.map(&:user_project).compact.uniq
+      end
+
+      def targets_to_integrate
+        targets
+      end
+
+      # Prints a warning informing the user that a build configuration of
+      # the integrated target is overriding the CocoaPods build settings.
+      #
+      # @param  [Target::AggregateTarget] aggregate_target
+      #         The umbrella target.
+      #
+      # @param  [XcodeProj::PBXNativeTarget] user_target
+      #         The native target.
+      #
+      # @param  [Xcodeproj::XCBuildConfiguration] config
+      #         The build configuration.
+      #
+      # @param  [String] key
+      #         The key of the overridden build setting.
+      #
+      def print_override_warning(aggregate_target, user_target, config, key)
+        actions = [
+          'Use the `$(inherited)` flag, or',
+          'Remove the build settings from the target.',
+        ]
+        message = "The `#{user_target.name} [#{config.name}]` " \
+          "target overrides the `#{key}` build setting defined in " \
+          "`#{aggregate_target.xcconfig_relative_path(config.name)}'. " \
+          'This can lead to problems with the CocoaPods installation'
+        UI.warn(message, actions)
+      end
+
+      #-----------------------------------------------------------------------#
+    end
+  end
+end

data/lib/pod/installer/user_project_integrator/target_integrator.rb

@@ -0,0 +1,462 @@
+require 'active_support/core_ext/string/inflections'
+
+module Pod
+  class DyInstaller
+    class UserProjectIntegrator
+      # This class is responsible for integrating the library generated by a
+      # {TargetDefinition} with its destination project.
+      #
+      class TargetIntegrator
+        autoload :XCConfigIntegrator, File.expand_path('../target_integrator/xcconfig_integrator', __FILE__)
+
+        # @return [String] the string to use as prefix for every build phase added to the user project
+        #
+        BUILD_PHASE_PREFIX = '[CP] '.freeze
+
+        # @return [String] the string to use as prefix for every build phase declared by the user within a podfile
+        #         or podspec.
+        #
+        USER_BUILD_PHASE_PREFIX = '[CP-User] '.freeze
+
+        # @return [String] the name of the check manifest phase
+        #
+        CHECK_MANIFEST_PHASE_NAME = 'Check Pods Manifest.lock'.freeze
+
+        # @return [Array<Symbol>] the symbol types, which require that the pod
+        # frameworks are embedded in the output directory / product bundle.
+        #
+        # @note This does not include :app_extension or :watch_extension because
+        # these types must have their frameworks embedded in their host targets.
+        # For messages extensions, this only applies if it's embedded in a messages
+        # application.
+        #
+        EMBED_FRAMEWORK_TARGET_TYPES = [:application, :unit_test_bundle, :ui_test_bundle, :watch2_extension, :messages_application].freeze
+
+        # @return [String] the name of the embed frameworks phase
+        #
+        EMBED_FRAMEWORK_PHASE_NAME = 'Embed Pods Frameworks'.freeze
+
+        # @return [String] the name of the copy resources phase
+        #
+        COPY_PODS_RESOURCES_PHASE_NAME = 'Copy Pods Resources'.freeze
+
+        # @return [Integer] the maximum number of input and output paths to use for a script phase
+        #
+        MAX_INPUT_OUTPUT_PATHS = 1000
+
+        # @return [AggregateTarget] the target that should be integrated.
+        #
+        attr_reader :target
+
+        # Init a new TargetIntegrator
+        #
+        # @param  [AggregateTarget] target @see #target
+        #
+        def initialize(target)
+          @target = target
+        end
+
+        class << self
+          # Adds a shell script build phase responsible to copy (embed) the frameworks
+          # generated by the TargetDefinition to the bundle of the product of the
+          # targets.
+          #
+          # @param [PBXNativeTarget] native_target
+          #        The native target to add the script phase into.
+          #
+          # @param [String] script_path
+          #        The script path to execute as part of this script phase.
+          #
+          # @param [Array<String>] input_paths
+          #        The input paths (if any) to include for this script phase.
+          #
+          # @param [Array<String>] output_paths
+          #        The output paths (if any) to include for this script phase.
+          #
+          # @return [void]
+          #
+          def create_or_update_embed_frameworks_script_phase_to_target(native_target, script_path, input_paths = [], output_paths = [])
+            phase = TargetIntegrator.create_or_update_build_phase(native_target, BUILD_PHASE_PREFIX + EMBED_FRAMEWORK_PHASE_NAME)
+            phase.shell_script = %("#{script_path}"\n)
+            phase.input_paths = input_paths
+            phase.output_paths = output_paths
+          end
+
+          # Delete a 'Embed Pods Frameworks' Copy Files Build Phase if present
+          #
+          # @param [PBXNativeTarget] native_target
+          #        The native target to remove the script phase from.
+          #
+          def remove_embed_frameworks_script_phase_from_target(native_target)
+            embed_build_phase = native_target.shell_script_build_phases.find { |bp| bp.name && bp.name.end_with?(EMBED_FRAMEWORK_PHASE_NAME) }
+            return unless embed_build_phase.present?
+            native_target.build_phases.delete(embed_build_phase)
+          end
+
+          # Adds a shell script build phase responsible to copy the resources
+          # generated by the TargetDefinition to the bundle of the product of the
+          # targets.
+          #
+          # @param [PBXNativeTarget] native_target
+          #        The native target to add the script phase into.
+          #
+          # @param [String] script_path
+          #        The script path to execute as part of this script phase.
+          #
+          # @param [Array<String>] input_paths
+          #        The input paths (if any) to include for this script phase.
+          #
+          # @param [Array<String>] output_paths
+          #        The output paths (if any) to include for this script phase.
+          #
+          # @return [void]
+          #
+          def create_or_update_copy_resources_script_phase_to_target(native_target, script_path, input_paths = [], output_paths = [])
+            phase_name = COPY_PODS_RESOURCES_PHASE_NAME
+            phase = TargetIntegrator.create_or_update_build_phase(native_target, BUILD_PHASE_PREFIX + phase_name)
+            phase.shell_script = %("#{script_path}"\n)
+            phase.input_paths = input_paths
+            phase.output_paths = output_paths
+          end
+
+          # Delete a 'Copy Pods Resources' script phase if present
+          #
+          # @param [PBXNativeTarget] native_target
+          #        The native target to remove the script phase from.
+          #
+          def remove_copy_resources_script_phase_from_target(native_target)
+            build_phase = native_target.shell_script_build_phases.find { |bp| bp.name && bp.name.end_with?(COPY_PODS_RESOURCES_PHASE_NAME) }
+            return unless build_phase.present?
+            native_target.build_phases.delete(build_phase)
+          end
+
+          # Creates or update a shell script build phase for the given target.
+          #
+          # @param [PBXNativeTarget] native_target
+          #        The native target to add the script phase into.
+          #
+          # @param [String] phase_name
+          #        The name of the phase to use.
+          #
+          # @param [Class] phase_class
+          #        The class of the phase to use.
+          #
+          # @return [void]
+          #
+          def create_or_update_build_phase(native_target, phase_name, phase_class = Xcodeproj::Project::Object::PBXShellScriptBuildPhase)
+            build_phases = native_target.build_phases.grep(phase_class)
+            build_phases.find { |phase| phase.name && phase.name.end_with?(phase_name) }.tap { |p| p.name = phase_name if p } ||
+              native_target.project.new(phase_class).tap do |phase|
+                UI.message("Adding Build Phase '#{phase_name}' to project.") do
+                  phase.name = phase_name
+                  phase.show_env_vars_in_log = '0'
+                  native_target.build_phases << phase
+                end
+              end
+          end
+
+          # Updates all target script phases for the current target, including creating or updating, deleting
+          # and re-ordering.
+          #
+          # @return [void]
+          #
+          def create_or_update_user_script_phases(script_phases, native_target)
+            script_phase_names = script_phases.map { |k| k[:name] }
+            # Delete script phases no longer present in the target definition.
+            native_target_script_phases = native_target.shell_script_build_phases.select { |bp| !bp.name.nil? && bp.name.start_with?(USER_BUILD_PHASE_PREFIX) }
+            native_target_script_phases.each do |script_phase|
+              script_phase_name_without_prefix = script_phase.name.sub(USER_BUILD_PHASE_PREFIX, '')
+              unless script_phase_names.include?(script_phase_name_without_prefix)
+                native_target.build_phases.delete(script_phase)
+              end
+            end
+            # Create or update the ones that are expected to be.
+            script_phases.each do |td_script_phase|
+              name_with_prefix = USER_BUILD_PHASE_PREFIX + td_script_phase[:name]
+              phase = TargetIntegrator.create_or_update_build_phase(native_target, name_with_prefix)
+              phase.shell_script = td_script_phase[:script]
+              phase.shell_path = td_script_phase[:shell_path] if td_script_phase.key?(:shell_path)
+              phase.input_paths = td_script_phase[:input_files] if td_script_phase.key?(:input_files)
+              phase.output_paths = td_script_phase[:output_files] if td_script_phase.key?(:output_files)
+              phase.show_env_vars_in_log = td_script_phase[:show_env_vars_in_log] ? '1' : '0' if td_script_phase.key?(:show_env_vars_in_log)
+
+              execution_position = td_script_phase[:execution_position]
+              unless execution_position == :any
+                compile_build_phase_index = native_target.build_phases.index do |bp|
+                  bp.is_a?(Xcodeproj::Project::Object::PBXSourcesBuildPhase)
+                end
+                unless compile_build_phase_index.nil?
+                  script_phase_index = native_target.build_phases.index do |bp|
+                    bp.is_a?(Xcodeproj::Project::Object::PBXShellScriptBuildPhase) && !bp.name.nil? && bp.name == name_with_prefix
+                  end
+                  if (execution_position == :before_compile && script_phase_index > compile_build_phase_index) ||
+                    (execution_position == :after_compile && script_phase_index < compile_build_phase_index)
+                    native_target.build_phases.move_from(script_phase_index, compile_build_phase_index)
+                  end
+                end
+              end
+            end
+          end
+
+          # Script phases can have a limited number of input and output paths due to each one being exported to `env`.
+          # A large number can cause a build failure because of limitations in `env`. See issue
+          # https://github.com/CocoaPods/CocoaPods/issues/7362.
+          #
+          # @param [Array<String>] input_paths
+          #        The input paths to trim.
+          #
+          # @param [Array<String>] output_paths
+          #        The output paths to trim.
+          #
+          # @return [void]
+          #
+          def validate_input_output_path_limit(input_paths, output_paths)
+            if (input_paths.count + output_paths.count) > MAX_INPUT_OUTPUT_PATHS
+              input_paths.clear
+              output_paths.clear
+            end
+          end
+
+          # Returns an extension in the target that corresponds to the
+          # resource's input extension.
+          #
+          # @param [String] input_extension
+          #        The input extension to map to.
+          #
+          # @return [String] The output extension.
+          #
+          def output_extension_for_resource(input_extension)
+            case input_extension
+            when '.storyboard'        then '.storyboardc'
+            when '.xib'               then '.nib'
+            when '.framework'         then '.framework'
+            when '.xcdatamodel'       then '.mom'
+            when '.xcdatamodeld'      then '.momd'
+            when '.xcmappingmodel'    then '.cdm'
+            when '.xcassets'          then '.car'
+            else                      input_extension
+            end
+          end
+
+          # Returns the resource output paths for all given input paths.
+          #
+          # @param [Array<String>] resource_input_paths
+          #        The input paths to map to.
+          #
+          # @return [Array<String>] The resource output paths.
+          #
+          def resource_output_paths(resource_input_paths)
+            resource_input_paths.map do |resource_input_path|
+              base_path = '${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}'
+              extname = File.extname(resource_input_path)
+              basename = extname == '.xcassets' ? 'Assets' : File.basename(resource_input_path)
+              output_extension = TargetIntegrator.output_extension_for_resource(extname)
+              File.join(base_path, File.basename(basename, extname) + output_extension)
+            end.uniq
+          end
+        end
+
+        # Integrates the user project targets. Only the targets that do **not**
+        # already have the Pods library in their frameworks build phase are
+        # processed.
+        #
+        # @return [void]
+        #
+        def integrate!
+          UI.section(integration_message) do
+            XCConfigIntegrator.integrate(target, native_targets)
+
+            add_pods_library
+            add_embed_frameworks_script_phase
+            remove_embed_frameworks_script_phase_from_embedded_targets
+            add_copy_resources_script_phase
+            add_check_manifest_lock_script_phase
+            add_user_script_phases
+          end
+        end
+
+        # @return [String] a string representation suitable for debugging.
+        #
+        def inspect
+          "#<#{self.class} for target `#{target.label}'>"
+        end
+
+        private
+
+        # @!group Integration steps
+        #---------------------------------------------------------------------#
+
+        # Adds spec product reference to the frameworks build phase of the
+        # {TargetDefinition} integration libraries. Adds a file reference to
+        # the frameworks group of the project and adds it to the frameworks
+        # build phase of the targets.
+        #
+        # @return [void]
+        #
+        def add_pods_library
+          frameworks = user_project.frameworks_group
+          native_targets.each do |native_target|
+            build_phase = native_target.frameworks_build_phase
+
+            # Find and delete possible reference for the other product type
+            old_product_name = target.requires_frameworks? ? target.static_library_name : target.framework_name
+            old_product_ref = frameworks.files.find { |f| f.path == old_product_name }
+            if old_product_ref.present?
+              UI.message("Removing old Pod product reference #{old_product_name} from project.")
+              build_phase.remove_file_reference(old_product_ref)
+              frameworks.remove_reference(old_product_ref)
+            end
+
+            # Find or create and add a reference for the current product type
+            target_basename = target.product_basename
+            new_product_ref = frameworks.files.find { |f| f.path == target.product_name } ||
+              frameworks.new_product_ref_for_target(target_basename, target.product_type)
+            build_phase.build_file(new_product_ref) ||
+              build_phase.add_file_reference(new_product_ref, true)
+          end
+        end
+
+        # Find or create a 'Copy Pods Resources' build phase
+        #
+        # @return [void]
+        #
+        def add_copy_resources_script_phase
+          native_targets.each do |native_target|
+            puts "add copy phase native target : #{native_target}, target : #{target}"
+            script_path = target.copy_resources_script_relative_path
+            resource_paths_by_config = target.resource_paths_by_config
+            if resource_paths_by_config.values.all?(&:empty?)
+              TargetIntegrator.remove_copy_resources_script_phase_from_target(native_target)
+            else
+              resource_paths_flattened = resource_paths_by_config.values.flatten.uniq
+              input_paths = [target.copy_resources_script_relative_path, *resource_paths_flattened]
+              output_paths = TargetIntegrator.resource_output_paths(resource_paths_flattened)
+              TargetIntegrator.validate_input_output_path_limit(input_paths, output_paths)
+              TargetIntegrator.create_or_update_copy_resources_script_phase_to_target(native_target, script_path, input_paths, output_paths)
+            end
+          end
+        end
+
+        # Removes the embed frameworks build phase from embedded targets
+        #
+        # @note Older versions of CocoaPods would add this build phase to embedded
+        #       targets. They should be removed on upgrade because embedded targets
+        #       will have their frameworks embedded in their host targets.
+        #
+        def remove_embed_frameworks_script_phase_from_embedded_targets
+          return unless target.requires_host_target?
+          native_targets.each do |native_target|
+            if AggregateTarget::EMBED_FRAMEWORKS_IN_HOST_TARGET_TYPES.include? native_target.symbol_type
+              TargetIntegrator.remove_embed_frameworks_script_phase_from_target(native_target)
+            end
+          end
+        end
+
+        # Find or create a 'Embed Pods Frameworks' Copy Files Build Phase
+        #
+        # @return [void]
+        #
+        def add_embed_frameworks_script_phase
+          native_targets_to_embed_in.each do |native_target|
+            script_path = target.embed_frameworks_script_relative_path
+            framework_paths_by_config = target.framework_paths_by_config.values.flatten.uniq
+            if framework_paths_by_config.all?(&:empty?)
+              TargetIntegrator.remove_embed_frameworks_script_phase_from_target(native_target)
+            else
+              input_paths = [target.embed_frameworks_script_relative_path, *framework_paths_by_config.map { |fw| [fw[:input_path], fw[:dsym_input_path]] }.flatten.compact]
+              output_paths = framework_paths_by_config.map { |fw| [fw[:output_path], fw[:dsym_output_path]] }.flatten.compact.uniq
+              TargetIntegrator.validate_input_output_path_limit(input_paths, output_paths)
+              TargetIntegrator.create_or_update_embed_frameworks_script_phase_to_target(native_target, script_path, input_paths, output_paths)
+            end
+          end
+        end
+
+        # Updates all target script phases for the current target, including creating or updating, deleting
+        # and re-ordering.
+        #
+        # @return [void]
+        #
+        def add_user_script_phases
+          native_targets.each do |native_target|
+            TargetIntegrator.create_or_update_user_script_phases(target.target_definition.script_phases, native_target)
+          end
+        end
+
+        # Adds a shell script build phase responsible for checking if the Pods
+        # locked in the Pods/Manifest.lock file are in sync with the Pods defined
+        # in the Podfile.lock.
+        #
+        # @note   The build phase is appended to the front because to fail
+        #         fast.
+        #
+        # @return [void]
+        #
+        def add_check_manifest_lock_script_phase
+          phase_name = CHECK_MANIFEST_PHASE_NAME
+          native_targets.each do |native_target|
+            phase = TargetIntegrator.create_or_update_build_phase(native_target, BUILD_PHASE_PREFIX + phase_name)
+            native_target.build_phases.unshift(phase).uniq! unless native_target.build_phases.first == phase
+            phase.shell_script = <<-SH.strip_heredoc
+              diff "${PODS_PODFILE_DIR_PATH}/Podfile.lock" "${PODS_ROOT}/Manifest.lock" > /dev/null
+              if [ $? != 0 ] ; then
+                  # print error to STDERR
+                  echo "error: The sandbox is not in sync with the Podfile.lock. Run 'pod install' or update your CocoaPods installation." >&2
+                  exit 1
+              fi
+              # This output is used by Xcode 'outputs' to avoid re-running this script phase.
+              echo "SUCCESS" > "${SCRIPT_OUTPUT_FILE_0}"
+            SH
+            phase.input_paths = %w(${PODS_PODFILE_DIR_PATH}/Podfile.lock ${PODS_ROOT}/Manifest.lock)
+            phase.output_paths = [target.check_manifest_lock_script_output_file_path]
+          end
+        end
+
+        private
+
+        # @!group Private Helpers
+        #---------------------------------------------------------------------#
+
+        # @return [Array<PBXNativeTarget>] The list of all the targets that
+        #         match the given target.
+        #
+        def native_targets
+          @native_targets ||= target.user_targets
+        end
+
+        # @return [Array<PBXNativeTarget>] The list of all the targets that
+        #         require that the pod frameworks are embedded in the output
+        #         directory / product bundle.
+        #
+        def native_targets_to_embed_in
+          return [] if target.requires_host_target?
+          native_targets.select do |target|
+            EMBED_FRAMEWORK_TARGET_TYPES.include?(target.symbol_type)
+          end
+        end
+
+        # Read the project from the disk to ensure that it is up to date as
+        # other TargetIntegrators might have modified it.
+        #
+        # @return [Project]
+        #
+        def user_project
+          target.user_project
+        end
+
+        # @return [Specification::Consumer] the consumer for the specifications.
+        #
+        def spec_consumers
+          @spec_consumers ||= target.pod_targets.map(&:file_accessors).flatten.map(&:spec_consumer)
+        end
+
+        # @return [String] the message that should be displayed for the target
+        #         integration.
+        #
+        def integration_message
+          "Integrating target `#{target.name}` " \
+            "(#{UI.path target.user_project_path} project)"
+        end
+      end
+    end
+  end
+end