cocoapods 1.5.2 → 1.6.1

data/lib/cocoapods/generator/app_target_helper.rb

@@ -38,26 +38,46 @@ module Pod
       # @param  [Symbol] platform
       #         the platform of the target. Can be `:ios` or `:osx`, etc.
       #
-      # @param  [Boolean] use_frameworks
-      #         whether to use frameworks or not when generating the contents of the import file.
-      #
       # @param  [String] name
       #         The name to use for the target, defaults to 'App'.
       #
       # @return [Array<PBXBuildFile>] the created build file references.
       #
-      def self.add_app_project_import(project, target, pod_target, platform, use_frameworks, name = 'App')
-        source_file = AppTargetHelper.create_app_import_source_file(project, pod_target, platform, use_frameworks, name)
-        source_file_ref = project.new_group(name, name).new_file(source_file)
+      def self.add_app_project_import(project, target, pod_target, platform, name = 'App')
+        source_file = AppTargetHelper.create_app_import_source_file(project, pod_target, platform, name)
+        group = project[name] || project.new_group(name, name)
+        source_file_ref = group.new_file(source_file)
         target.add_file_references([source_file_ref])
       end
 
-      # Creates and links a default app host 'main.m' file.
+      # Creates and links an empty Swift file for the given target.
       #
       # @param  [Project] project
       #         the Xcodeproj to generate the target into.
       #
       # @param  [PBXNativeTarget] target
+      #         the native target to link the generated import file into.
+      #
+      # @param  [String] name
+      #         The name to use for the target, defaults to 'App'.
+      #
+      # @return [Array<PBXBuildFile>] the created build file references.
+      #
+      def self.add_empty_swift_file(project, target, name = 'App')
+        swift_file = project.path.dirname.+("#{name}/dummy.swift")
+        swift_file.parent.mkpath
+        File.write(swift_file, '')
+        group = project[name] || project.new_group(name, name)
+        swift_file_ref = group.new_file(swift_file)
+        target.add_file_references([swift_file_ref])
+      end
+
+      # Creates and links a default app host 'main.m' file.
+      #
+      # @param  [Project] project
+      #         the Xcodeproj to generate the main file into.
+      #
+      # @param  [PBXNativeTarget] target
       #         the native target to link the generated main file into.
       #
       # @param  [Symbol] platform
@@ -68,12 +88,37 @@ module Pod
       #
       # @return [Array<PBXBuildFile>] the created build file references.
       #
-      def self.add_app_host_main_file(project, target, platform, name = 'App')
+      def self.add_app_host_main_file(project, target, platform, group, name = 'App')
         source_file = AppTargetHelper.create_app_host_main_file(project, platform, name)
-        source_file_ref = project.new_group(name, name).new_file(source_file)
+        source_file_ref = group.new_file(source_file)
         target.add_file_references([source_file_ref])
       end
 
+      # Creates a default launchscreen storyboard.
+      #
+      # @param  [Project] project
+      #         the Xcodeproj to generate the launchscreen storyboard into.
+      #
+      # @param  [PBXNativeTarget] target
+      #         the native target to link the generated launchscreen storyboard into.
+      #
+      # @param  [Symbol] platform
+      #         the platform of the target. Can be `:ios` or `:osx`, etc.
+      #
+      # @param  [String] deployment_target
+      #         the deployment target for the platform.
+      #
+      # @param  [String] name
+      #         The name to use for the target, defaults to 'App'.
+      #
+      # @return [PBXFileReference] the created file reference of the launchscreen storyboard.
+      #
+      def self.add_launchscreen_storyboard(project, target, group, deployment_target, name = 'App')
+        launch_storyboard_file = AppTargetHelper.create_launchscreen_storyboard_file(project, deployment_target, name)
+        launch_storyboard_ref = group.new_file(launch_storyboard_file)
+        target.resources_build_phase.add_file_reference(launch_storyboard_ref)
+      end
+
       # Adds the xctest framework search paths into the given target.
       #
       # @param  [PBXNativeTarget] target
@@ -116,26 +161,23 @@ module Pod
       # @param  [Symbol] platform
       #         the platform of the target. Can be `:ios` or `:osx`, etc.
       #
-      # @param  [Boolean] use_frameworks
-      #         whether to use frameworks or not when generating the contents of the import file.
-      #
       # @param  [String] name
       #         The name of the folder to use and save the generated main file.
       #
       # @return [Pathname] the new source file that was generated.
       #
-      def self.create_app_import_source_file(project, pod_target, platform, use_frameworks, name = 'App')
+      def self.create_app_import_source_file(project, pod_target, platform, name = 'App')
         language = pod_target.uses_swift? ? :swift : :objc
 
         if language == :swift
           source_file = project.path.dirname.+("#{name}/main.swift")
           source_file.parent.mkpath
-          import_statement = use_frameworks && pod_target.should_build? ? "import #{pod_target.product_module_name}\n" : ''
+          import_statement = pod_target.should_build? && pod_target.defines_module? ? "import #{pod_target.product_module_name}\n" : ''
           source_file.open('w') { |f| f << import_statement }
         else
           source_file = project.path.dirname.+("#{name}/main.m")
           source_file.parent.mkpath
-          import_statement = if use_frameworks && pod_target.should_build?
+          import_statement = if pod_target.should_build? && pod_target.defines_module?
                                "@import #{pod_target.product_module_name};\n"
                              else
                                header_name = "#{pod_target.product_module_name}/#{pod_target.product_module_name}.h"
@@ -155,6 +197,30 @@ module Pod
         source_file
       end
 
+      # Creates a default launchscreen storyboard file.
+      #
+      # @param  [Project] project
+      #         the Xcodeproj to generate the launchscreen storyboard into.
+      #
+      # @param  [String] deployment_target
+      #         the deployment target for the platform.
+      #
+      # @param  [String] name
+      #         The name of the folder to use and save the generated launchscreen storyboard file.
+      #
+      # @return [Pathname] the new launchscreen storyboard file that was generated.
+      #
+      def self.create_launchscreen_storyboard_file(project, deployment_target, name = 'App')
+        launch_storyboard_file = project.path.dirname.+("#{name}/LaunchScreen.storyboard")
+        launch_storyboard_file.parent.mkpath
+        if Version.new(deployment_target) >= Version.new('9.0')
+          File.write(launch_storyboard_file, LAUNCHSCREEN_STORYBOARD_CONTENTS)
+        else
+          File.write(launch_storyboard_file, LAUNCHSCREEN_STORYBOARD_CONTENTS_IOS_8)
+        end
+        launch_storyboard_file
+      end
+
       # Creates a default app host 'main.m' file.
       #
       # @param  [Project] project
@@ -176,7 +242,7 @@ module Pod
           when :ios, :tvos
             f << IOS_APP_HOST_MAIN_CONTENTS
           when :osx
-            f << MACOS_APP_APP_HOST_MAIN_CONTENTS
+            f << MACOS_APP_HOST_MAIN_CONTENTS
           end
         end
         source_file
@@ -215,13 +281,71 @@ int main(int argc, char *argv[])
 }
 EOS
 
-      MACOS_APP_APP_HOST_MAIN_CONTENTS = <<EOS.freeze
+      MACOS_APP_HOST_MAIN_CONTENTS = <<EOS.freeze
 #import <Cocoa/Cocoa.h>
 
 int main(int argc, const char * argv[]) {
     return NSApplicationMain(argc, argv);
 }
 EOS
+
+      LAUNCHSCREEN_STORYBOARD_CONTENTS_IOS_8 = <<-XML.strip_heredoc.freeze
+              <?xml version="1.0" encoding="UTF-8" standalone="no"?>
+              <document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="13122.16" systemVersion="17A277" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" colorMatched="YES" initialViewController="01J-lp-oVM">
+                <dependencies>
+                  <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="13104.12"/>
+                  <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
+                </dependencies>
+                <scenes>
+                  <!--View Controller-->
+                  <scene sceneID="EHf-IW-A2E">
+                    <objects>
+                      <viewController id="01J-lp-oVM" sceneMemberID="viewController">
+                        <layoutGuides>
+                          <viewControllerLayoutGuide type="top" id="rUq-ht-380"/>
+                          <viewControllerLayoutGuide type="bottom" id="a9l-8d-mfx"/>
+                        </layoutGuides>
+                        <view key="view" contentMode="scaleToFill" id="Ze5-6b-2t3">
+                          <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
+                          <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                          <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+                        </view>
+                      </viewController>
+                      <placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
+                    </objects>
+                    <point key="canvasLocation" x="53" y="375"/>
+                  </scene>
+                </scenes>
+              </document>
+      XML
+
+      LAUNCHSCREEN_STORYBOARD_CONTENTS = <<-XML.strip_heredoc.freeze
+              <?xml version="1.0" encoding="UTF-8" standalone="no"?>
+              <document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="13122.16" systemVersion="17A277" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="01J-lp-oVM">
+                <dependencies>
+                  <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="13104.12"/>
+                  <capability name="Safe area layout guides" minToolsVersion="9.0"/>
+                  <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
+                </dependencies>
+                <scenes>
+                  <!--View Controller-->
+                  <scene sceneID="EHf-IW-A2E">
+                    <objects>
+                      <viewController id="01J-lp-oVM" sceneMemberID="viewController">
+                        <view key="view" contentMode="scaleToFill" id="Ze5-6b-2t3">
+                          <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
+                          <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                          <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+                          <viewLayoutGuide key="safeArea" id="6Tk-OE-BBY"/>
+                        </view>
+                      </viewController>
+                      <placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
+                    </objects>
+                    <point key="canvasLocation" x="53" y="375"/>
+                  </scene>
+                </scenes>
+              </document>
+      XML
     end
   end
 end

data/lib/cocoapods/generator/copy_resources_script.rb

@@ -38,6 +38,12 @@ module Pod
         File.chmod(0755, pathname.to_s)
       end
 
+      # @return [String] The contents of the copy resources script.
+      #
+      def generate
+        script
+      end
+
       private
 
       # @!group Private Helpers
@@ -99,10 +105,15 @@ set -e
 set -u
 set -o pipefail
 
+function on_error {
+  echo "$(realpath -mq "${0}"):$1: error: Unexpected failure"
+}
+trap 'on_error $LINENO' ERR
+
 if [ -z ${UNLOCALIZED_RESOURCES_FOLDER_PATH+x} ]; then
-    # If UNLOCALIZED_RESOURCES_FOLDER_PATH is not set, then there's nowhere for us to copy
-    # resources to, so exit 0 (signalling the script phase was successful).
-    exit 0
+  # If UNLOCALIZED_RESOURCES_FOLDER_PATH is not set, then there's nowhere for us to copy
+  # resources to, so exit 0 (signalling the script phase was successful).
+  exit 0
 fi
 
 mkdir -p "${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}"

data/lib/cocoapods/generator/dummy_source.rb

@@ -8,13 +8,22 @@ module Pod
         @class_name = "PodsDummy_#{validated_class_name_identifier}"
       end
 
+      # @return [String] the string contents of the dummy source file.
+      #
+      def generate
+        result = <<-source.strip_heredoc
+          #import <Foundation/Foundation.h>
+          @interface #{class_name} : NSObject
+          @end
+          @implementation #{class_name}
+          @end
+        source
+        result
+      end
+
       def save_as(pathname)
         pathname.open('w') do |source|
-          source.puts '#import <Foundation/Foundation.h>'
-          source.puts "@interface #{class_name} : NSObject"
-          source.puts '@end'
-          source.puts "@implementation #{class_name}"
-          source.puts '@end'
+          source.write(generate)
         end
       end
     end

data/lib/cocoapods/generator/embed_frameworks_script.rb

@@ -1,12 +1,14 @@
+require 'cocoapods/target/framework_paths'
+
 module Pod
   module Generator
     class EmbedFrameworksScript
-      # @return [Hash{String => Array<String>}] Multiple lists of frameworks per
+      # @return [Hash{String => Array<FrameworkPaths>}] Multiple lists of frameworks per
       #         configuration.
       #
       attr_reader :frameworks_by_config
 
-      # @param  [Hash{String => Array<String>] frameworks_by_config
+      # @param  [Hash{String => Array<FrameworkPaths>] frameworks_by_config
       #         @see #frameworks_by_config
       #
       def initialize(frameworks_by_config)
@@ -27,6 +29,12 @@ module Pod
         File.chmod(0755, pathname.to_s)
       end
 
+      # @return [String] The contents of the embed frameworks script.
+      #
+      def generate
+        script
+      end
+
       private
 
       # @!group Private Helpers
@@ -40,10 +48,15 @@ module Pod
           set -u
           set -o pipefail
 
+          function on_error {
+            echo "$(realpath -mq "${0}"):$1: error: Unexpected failure"
+          }
+          trap 'on_error $LINENO' ERR
+
           if [ -z ${FRAMEWORKS_FOLDER_PATH+x} ]; then
-              # If FRAMEWORKS_FOLDER_PATH is not set, then there's nowhere for us to copy
-              # frameworks to, so exit 0 (signalling the script phase was successful).
-              exit 0
+            # If FRAMEWORKS_FOLDER_PATH is not set, then there's nowhere for us to copy
+            # frameworks to, so exit 0 (signalling the script phase was successful).
+            exit 0
           fi
 
           echo "mkdir -p ${CONFIGURATION_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}"
@@ -73,8 +86,8 @@ module Pod
             local destination="${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}"
 
             if [ -L "${source}" ]; then
-                echo "Symlinked..."
-                source="$(readlink "${source}")"
+              echo "Symlinked..."
+              source="$(readlink "${source}")"
             fi
 
             # Use filter instead of exclude so missing patterns don't throw errors.
@@ -84,8 +97,13 @@ module Pod
             local basename
             basename="$(basename -s .framework "$1")"
             binary="${destination}/${basename}.framework/${basename}"
+
             if ! [ -r "$binary" ]; then
               binary="${destination}/${basename}"
+            elif [ -L "${binary}" ]; then
+              echo "Destination binary is symlinked..."
+              dirname="$(dirname "${binary}")"
+              binary="${dirname}/$(readlink "${binary}")"
             fi
 
             # Strip invalid architectures so "fat" simulator / device frameworks work on device
@@ -99,7 +117,7 @@ module Pod
             # Embed linked Swift runtime libraries. No longer necessary as of Xcode 7.
             if [ "${XCODE_VERSION_MAJOR}" -lt 7 ]; then
               local swift_runtime_libs
-              swift_runtime_libs=$(xcrun otool -LX "$binary" | grep --color=never @rpath/libswift | sed -E s/@rpath\\\\/\\(.+dylib\\).*/\\\\1/g | uniq -u  && exit ${PIPESTATUS[0]})
+              swift_runtime_libs=$(xcrun otool -LX "$binary" | grep --color=never @rpath/libswift | sed -E s/@rpath\\\\/\\(.+dylib\\).*/\\\\1/g | uniq -u)
               for lib in $swift_runtime_libs; do
                 echo "rsync -auv \\"${SWIFT_STDLIB_PATH}/${lib}\\" \\"${destination}\\""
                 rsync -auv "${SWIFT_STDLIB_PATH}/${lib}" "${destination}"
@@ -138,8 +156,8 @@ module Pod
 
           # Signs a framework with the provided identity
           code_sign_if_enabled() {
-            if [ -n "${EXPANDED_CODE_SIGN_IDENTITY}" -a "${CODE_SIGNING_REQUIRED:-}" != "NO" -a "${CODE_SIGNING_ALLOWED}" != "NO" ]; then
-              # Use the current code_sign_identitiy
+            if [ -n "${EXPANDED_CODE_SIGN_IDENTITY:-}" -a "${CODE_SIGNING_REQUIRED:-}" != "NO" -a "${CODE_SIGNING_ALLOWED}" != "NO" ]; then
+              # Use the current code_sign_identity
               echo "Code Signing $1 with Identity ${EXPANDED_CODE_SIGN_IDENTITY_NAME}"
               local code_sign_cmd="/usr/bin/codesign --force --sign ${EXPANDED_CODE_SIGN_IDENTITY} ${OTHER_CODE_SIGN_FLAGS:-} --preserve-metadata=identifier,entitlements '$1'"
 
@@ -168,7 +186,7 @@ module Pod
             for arch in $binary_archs; do
               if ! [[ "${ARCHS}" == *"$arch"* ]]; then
                 # Strip non-valid architectures in-place
-                lipo -remove "$arch" -output "$binary" "$binary" || exit 1
+                lipo -remove "$arch" -output "$binary" "$binary"
                 stripped="$stripped $arch"
               fi
             done
@@ -181,16 +199,15 @@ module Pod
         SH
         script << "\n" unless frameworks_by_config.values.all?(&:empty?)
         frameworks_by_config.each do |config, frameworks_with_dsyms|
-          unless frameworks_with_dsyms.empty?
-            script << %(if [[ "$CONFIGURATION" == "#{config}" ]]; then\n)
-            frameworks_with_dsyms.each do |framework_with_dsym|
-              script << %(  install_framework "#{framework_with_dsym[:input_path]}"\n)
-              # Vendored frameworks might have a dSYM file next to them so ensure its copied. Frameworks built from
-              # sources will have their dSYM generated and copied by Xcode.
-              script << %(  install_dsym "#{framework_with_dsym[:dsym_input_path]}"\n) unless framework_with_dsym[:dsym_input_path].nil?
-            end
-            script << "fi\n"
+          next if frameworks_with_dsyms.empty?
+          script << %(if [[ "$CONFIGURATION" == "#{config}" ]]; then\n)
+          frameworks_with_dsyms.each do |framework_with_dsym|
+            script << %(  install_framework "#{framework_with_dsym.source_path}"\n)
+            # Vendored frameworks might have a dSYM file next to them so ensure its copied. Frameworks built from
+            # sources will have their dSYM generated and copied by Xcode.
+            script << %(  install_dsym "#{framework_with_dsym.dsym_path}"\n) unless framework_with_dsym.dsym_path.nil?
           end
+          script << "fi\n"
         end
         script << <<-SH.strip_heredoc
         if [ "${COCOAPODS_PARALLEL_CODE_SIGN}" == "true" ]; then

data/lib/cocoapods/generator/header.rb

@@ -17,7 +17,7 @@ module Pod
 
       # @return [Array<String>] The list of the modules to import.
       #
-      attr_accessor :module_imports
+      attr_reader :module_imports
 
       # Initialize a new instance
       #

data/lib/cocoapods/generator/info_plist_file.rb

@@ -18,16 +18,22 @@ module Pod
       #
       attr_reader :bundle_package_type
 
+      # @return [Hash] any additional entries to include in this Info.plist
+      #
+      attr_reader :additional_entries
+
       # Initialize a new instance
       #
-      # @param  [Version] version @see version
-      # @param  [Platform] platform @see platform
-      # @param  [Symbol] bundle_package_type @see bundle_package_type
+      # @param  [Version] version @see #version
+      # @param  [Platform] platform @see #platform
+      # @param  [Symbol] bundle_package_type @see #bundle_package_type
+      # @param  [Hash] additional_entries @see #additional_entries
       #
-      def initialize(version, platform, bundle_package_type = :fmwk)
+      def initialize(version, platform, bundle_package_type = :fmwk, additional_entries = {})
         @version = version
         @platform = platform
         @bundle_package_type = bundle_package_type
+        @additional_entries = additional_entries
       end
 
       # Generates and saves the Info.plist to the given path.
@@ -109,6 +115,8 @@ module Pod
         info['CFBundleVersion'] = '1' if bundle_package_type == :bndl
         info['NSPrincipalClass'] = 'NSApplication' if bundle_package_type == :appl && platform == :osx
 
+        info.merge!(additional_entries)
+
         info
       end
     end

data/lib/cocoapods/generator/prefix_header.rb

@@ -15,10 +15,10 @@ module Pod
       # Initialize a new instance
       #
       # @param  [Array<FileAccessor>] file_accessors
-      #         @see file_accessors
+      #         @see #file_accessors
       #
       # @param  [Platform] platform
-      #         @see platform
+      #         @see Header#platform
       #
       def initialize(file_accessors, platform)
         @file_accessors = file_accessors

data/lib/cocoapods/hooks_manager.rb

@@ -76,6 +76,20 @@ module Pod
         @registrations[hook_name] << Hook.new(hook_name, plugin_name, block)
       end
 
+      # Returns all the hooks to run for the given event name
+      # and set of whitelisted plugins
+      #
+      # @see #run
+      #
+      # @return [Array<Hook>] the hooks to run
+      #
+      def hooks_to_run(name, whitelisted_plugins = nil)
+        return [] unless registrations
+        hooks = registrations.fetch(name, [])
+        return hooks unless whitelisted_plugins
+        hooks.select { |hook| whitelisted_plugins.key?(hook.plugin_name) }
+      end
+
       # Runs all the registered blocks for the hook with the given name.
       #
       # @param  [Symbol] name
@@ -94,23 +108,20 @@ module Pod
         raise ArgumentError, 'Missing name' unless name
         raise ArgumentError, 'Missing options' unless context
 
-        if registrations
-          hooks = registrations[name]
-          if hooks
-            UI.message "- Running #{name.to_s.tr('_', ' ')} hooks" do
-              hooks.each do |hook|
-                next if whitelisted_plugins && !whitelisted_plugins.key?(hook.plugin_name)
-                UI.message "- #{hook.plugin_name} from " \
-                           "`#{hook.block.source_location.first}`" do
-                  block = hook.block
-                  if block.arity > 1
-                    user_options = whitelisted_plugins[hook.plugin_name]
-                    user_options = user_options.with_indifferent_access if user_options
-                    block.call(context, user_options)
-                  else
-                    block.call(context)
-                  end
-                end
+        hooks = hooks_to_run(name, whitelisted_plugins)
+        return if hooks.empty?
+
+        UI.message "- Running #{name.to_s.tr('_', ' ')} hooks" do
+          hooks.each do |hook|
+            UI.message "- #{hook.plugin_name} from " \
+                        "`#{hook.block.source_location.first}`" do
+              block = hook.block
+              if block.arity > 1
+                user_options = whitelisted_plugins[hook.plugin_name]
+                user_options = user_options.with_indifferent_access if user_options
+                block.call(context, user_options)
+              else
+                block.call(context)
               end
             end
           end

data/lib/cocoapods/installer/analyzer/analysis_result.rb

@@ -1,45 +1,52 @@
 module Pod
   class Installer
     class Analyzer
+      # A simple container produced after a analysis is completed by the {Analyzer}.
+      #
       class AnalysisResult
         # @return [SpecsState] the states of the Podfile specs.
         #
-        attr_accessor :podfile_state
+        attr_reader :podfile_state
 
-        # @return [Hash{TargetDefinition => Array<Specification>}] the
-        #         specifications grouped by target.
+        # @return [Hash{TargetDefinition => Array<Specification>}] the specifications grouped by target.
         #
-        attr_accessor :specs_by_target
+        attr_reader :specs_by_target
 
-        # @return [Hash{Source => Array<Specification>}] the
-        #         specifications grouped by spec repo source.
+        # @return [Hash{Source => Array<Specification>}] the specifications grouped by spec repo source.
         #
-        attr_accessor :specs_by_source
+        attr_reader :specs_by_source
 
-        # @return [Array<Specification>] the specifications of the resolved
-        #         version of Pods that should be installed.
+        # @return [Array<Specification>] the specifications of the resolved version of Pods that should be installed.
         #
-        attr_accessor :specifications
+        attr_reader :specifications
 
-        # @return [SpecsState] the states of the {Sandbox} respect the resolved
-        #         specifications.
+        # @return [SpecsState] the states of the {Sandbox} respect the resolved specifications.
         #
-        attr_accessor :sandbox_state
+        attr_reader :sandbox_state
 
-        # @return [Array<AggregateTarget>] The aggregate targets created for each
-        #         {TargetDefinition} from the {Podfile}.
+        # @return [Array<AggregateTarget>] The aggregate targets created for each {TargetDefinition} from the {Podfile}.
         #
-        attr_accessor :targets
+        attr_reader :targets
 
-        # @return [Hash{TargetDefinition => Array<TargetInspectionResult>}] the
-        #         results of inspecting the user targets
+        # @return [Array<PodTarget>] The pod targets created for all the aggregate targets.
         #
-        attr_accessor :target_inspections
+        attr_reader :pod_targets
 
-        # @return [PodfileDependencyCache] the cache of all dependencies in the
-        #         podfile.
+        # @return [PodfileDependencyCache] the cache of all dependencies in the podfile.
         #
-        attr_accessor :podfile_dependency_cache
+        attr_reader :podfile_dependency_cache
+
+        def initialize(podfile_state, specs_by_target, specs_by_source, specifications, sandbox_state, targets, pod_targets,
+                       podfile_dependency_cache)
+          @podfile_state = podfile_state
+          @specs_by_target = specs_by_target
+          @specs_by_source = specs_by_source
+          @specifications = specifications
+          @sandbox_state = sandbox_state
+          @targets = targets
+          @pod_targets = pod_targets
+          @podfile_dependency_cache = podfile_dependency_cache
+        end
 
         # @return [Hash{String=>Symbol}] A hash representing all the user build
         #         configurations across all integration targets. Each key
@@ -51,6 +58,29 @@ module Pod
             result.merge(target.user_build_configurations)
           end
         end
+
+        # @return [Bool] Whether an installation should be performed or this
+        #         CocoaPods project is already up to date.
+        #
+        def needs_install?
+          podfile_needs_install? || sandbox_needs_install?
+        end
+
+        # @return [Bool] Whether the podfile has changes respect to the lockfile.
+        #
+        def podfile_needs_install?
+          state = podfile_state
+          needing_install = state.added.length + state.changed.length + state.deleted.length
+          needing_install > 0
+        end
+
+        # @return [Bool] Whether the sandbox is in synch with the lockfile.
+        #
+        def sandbox_needs_install?
+          state = sandbox_state
+          needing_install = state.added.length + state.changed.length + state.deleted.length
+          needing_install > 0
+        end
       end
     end
   end