cocoapods 1.10.0 → 1.16.0

data/lib/cocoapods/generator/copy_xcframework_script.rb

@@ -64,20 +64,26 @@ module Pod
 
 #{Pod::Generator::ScriptPhaseConstants::RSYNC_PROTECT_TMP_FILES}
 
+#{variant_for_slice}
+
+#{archs_for_slice}
+
 copy_dir()
 {
   local source="$1"
   local destination="$2"
 
   # Use filter instead of exclude so missing patterns don't throw errors.
-  echo "rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter \\"- CVS/\\" --filter \\"- .svn/\\" --filter \\"- .git/\\" --filter \\"- .hg/\\" \\"${source}\\" \\"${destination}\\""
-  rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" "${source}" "${destination}"
+  echo "rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter \\"- CVS/\\" --filter \\"- .svn/\\" --filter \\"- .git/\\" --filter \\"- .hg/\\" \\"${source}*\\" \\"${destination}\\""
+  rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" "${source}"/* "${destination}"
 }
 
 SELECT_SLICE_RETVAL=""
 
 select_slice() {
-  local paths=("$@")
+  local xcframework_name="$1"
+  xcframework_name="${xcframework_name##*/}"
+  local paths=("${@:2}")
   # Locate the correct slice of the .xcframework for the current architectures
   local target_path=""
 
@@ -93,29 +99,15 @@ select_slice() {
   fi
   for i in ${!paths[@]}; do
     local matched_all_archs="1"
-    for target_arch in $target_archs
-    do
-      if ! [[ "${paths[$i]}" == *"$target_variant"* ]]; then
-        matched_all_archs="0"
-        break
-      fi
-
-      # Verifies that the path contains the variant string (simulator or maccatalyst) if the variant is set.
-      if [[ -z "$target_variant" && ("${paths[$i]}" == *"simulator"* || "${paths[$i]}" == *"maccatalyst"*) ]]; then
+    local slice_archs="$(archs_for_slice "${xcframework_name}/${paths[$i]}")"
+    local slice_variant="$(variant_for_slice "${xcframework_name}/${paths[$i]}")"
+    for target_arch in $target_archs; do
+      if ! [[ "${slice_variant}" == "$target_variant" ]]; then
         matched_all_archs="0"
         break
       fi
 
-      # This regex matches all possible variants of the arch in the folder name:
-      # Let's say the folder name is: ios-armv7_armv7s_arm64_arm64e/CoconutLib.framework
-      # We match the following: -armv7_, _armv7s_, _arm64_ and _arm64e/.
-      # If we have a specific variant: ios-i386_x86_64-simulator/CoconutLib.framework
-      # We match the following: -i386_ and _x86_64-
-      # When the .xcframework wraps a static library, the folder name does not include
-      # any .framework. In that case, the folder name can be: ios-arm64_armv7
-      # We also match _armv7$ to handle that case.
-      local target_arch_regex="[_\\-]${target_arch}([\\/_\\-]|$)"
-      if ! [[ "${paths[$i]}" =~ $target_arch_regex ]]; then
+      if ! echo "${slice_archs}" | tr " " "\\n" | grep -F -q -x "$target_arch"; then
         matched_all_archs="0"
         break
       fi
@@ -130,60 +122,17 @@ select_slice() {
   done
 }
 
-install_library() {
-  local source="$1"
-  local name="$2"
-  local destination="#{Target::BuildSettings::XCFRAMEWORKS_BUILD_DIR_VARIABLE}/${name}"
-
-  # Libraries can contain headers, module maps, and a binary, so we'll copy everything in the folder over
-
-  local source="$binary"
-  echo "rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter \\"- CVS/\\" --filter \\"- .svn/\\" --filter \\"- .git/\\" --filter \\"- .hg/\\" \\"${source}/*\\" \\"${destination}\\""
-  rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" "${source}/*" "${destination}"
-}
-
-# Copies a framework to derived data for use in later build phases
-install_framework()
-{
-  local source="$1"
-  local name="$2"
-  local destination="#{Pod::Target::BuildSettings::XCFRAMEWORKS_BUILD_DIR_VARIABLE}/${name}"
-
-  if [ ! -d "$destination" ]; then
-    mkdir -p "$destination"
-  fi
-
-  copy_dir "$source" "$destination"
-  echo "Copied $source to $destination"
-}
-
-install_xcframework_library() {
-  local basepath="$1"
-  local name="$2"
-  local paths=("$@")
-
-  # Locate the correct slice of the .xcframework for the current architectures
-  select_slice "${paths[@]}"
-  local target_path="$SELECT_SLICE_RETVAL"
-  if [[ -z "$target_path" ]]; then
-    echo "warning: [CP] Unable to find matching .xcframework slice in '${paths[@]}' for the current build architectures ($ARCHS)."
-    return
-  fi
-
-  install_framework "$basepath/$target_path" "$name"
-}
-
 install_xcframework() {
   local basepath="$1"
   local name="$2"
   local package_type="$3"
-  local paths=("$@")
+  local paths=("${@:4}")
 
   # Locate the correct slice of the .xcframework for the current architectures
-  select_slice "${paths[@]}"
+  select_slice "${basepath}" "${paths[@]}"
   local target_path="$SELECT_SLICE_RETVAL"
   if [[ -z "$target_path" ]]; then
-    echo "warning: [CP] Unable to find matching .xcframework slice in '${paths[@]}' for the current build architectures ($ARCHS)."
+    echo "warning: [CP] $(basename ${basepath}): Unable to find matching slice in '${paths[@]}' for the current build architectures ($ARCHS) and platform (${EFFECTIVE_PLATFORM_NAME-${PLATFORM_NAME}})."
     return
   fi
   local source="$basepath/$target_path"
@@ -195,7 +144,6 @@ install_xcframework() {
   fi
 
   copy_dir "$source/" "$destination"
-
   echo "Copied $source to $destination"
 }
 
@@ -218,7 +166,7 @@ install_xcframework() {
       def install_xcframework_args(xcframework, slices)
         root = xcframework.path
         args = [shell_escape("${PODS_ROOT}/#{root.relative_path_from(sandbox_root)}")]
-        args << shell_escape(xcframework.name)
+        args << shell_escape(xcframework.target_name)
         is_framework = xcframework.build_type.framework?
         args << shell_escape(is_framework ? 'framework' : 'library')
         slices.each do |slice|
@@ -227,6 +175,40 @@ install_xcframework() {
         args.join(' ')
       end
 
+      def variant_for_slice
+        script = ''
+        script << "variant_for_slice()\n"
+        script << "{\n"
+        script << "  case \"$1\" in\n"
+        xcframeworks.each do |xcframework|
+          root = xcframework.path
+          xcframework.slices.each do |slice|
+            script << "  #{shell_escape(root.basename.join(slice.path.dirname.relative_path_from(root)))})\n"
+            script << "    echo \"#{slice.platform_variant}\"\n"
+            script << "    ;;\n"
+          end
+        end
+        script << "  esac\n"
+        script << '}'
+      end
+
+      def archs_for_slice
+        script = ''
+        script << "archs_for_slice()\n"
+        script << "{\n"
+        script << "  case \"$1\" in\n"
+        xcframeworks.each do |xcframework|
+          root = xcframework.path
+          xcframework.slices.each do |slice|
+            script << "  #{shell_escape(root.basename.join(slice.path.dirname.relative_path_from(root)))})\n"
+            script << "    echo \"#{slice.supported_archs.sort.join(' ')}\"\n"
+            script << "    ;;\n"
+          end
+        end
+        script << "  esac\n"
+        script << '}'
+      end
+
       class << self
         # @param  [Pathname] xcframework_path
         #         the base path of the .xcframework bundle

data/lib/cocoapods/generator/embed_frameworks_script.rb

@@ -63,7 +63,7 @@ echo "mkdir -p ${CONFIGURATION_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}"
 mkdir -p "${CONFIGURATION_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}"
 
 COCOAPODS_PARALLEL_CODE_SIGN="${COCOAPODS_PARALLEL_CODE_SIGN:-false}"
-SWIFT_STDLIB_PATH="${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}"
+SWIFT_STDLIB_PATH="${TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}"
 BCSYMBOLMAP_DIR="BCSymbolMaps"
 
 
@@ -83,7 +83,7 @@ install_framework()
 
   if [ -L "${source}" ]; then
     echo "Symlinked..."
-    source="$(readlink "${source}")"
+    source="$(readlink -f "${source}")"
   fi
 
   if [ -d "${source}/${BCSYMBOLMAP_DIR}" ]; then
@@ -159,8 +159,9 @@ code_sign_if_enabled() {
         end
         xcframeworks_by_config.each do |config, xcframeworks|
           xcframeworks.select { |xcf| xcf.build_type.dynamic_framework? }.each do |xcframework|
+            target_name = xcframework.target_name
             name = xcframework.name
-            contents_by_config[config] << %(  install_framework "#{Target::BuildSettings::XCFRAMEWORKS_BUILD_DIR_VARIABLE}/#{name}/#{name}.framework"\n)
+            contents_by_config[config] << %(  install_framework "#{Target::BuildSettings::XCFRAMEWORKS_BUILD_DIR_VARIABLE}/#{target_name}/#{name}.framework"\n)
           end
         end
         script << "\n" unless contents_by_config.empty?

data/lib/cocoapods/generator/info_plist_file.rb

@@ -112,7 +112,7 @@ module Pod
           'CFBundleSignature' => '????',
           'CFBundleVersion' => '${CURRENT_PROJECT_VERSION}',
           'NSPrincipalClass' => '',
-          'CFBundleDevelopmentRegion' => 'en',
+          'CFBundleDevelopmentRegion' => '${PODS_DEVELOPMENT_LANGUAGE}',
         }
 
         info['CFBundleExecutable'] = '${EXECUTABLE_NAME}' if bundle_package_type != :bndl

data/lib/cocoapods/generator/script_phase_constants.rb

@@ -79,6 +79,7 @@ install_dsym() {
       rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" --filter "- Headers" --filter "- PrivateHeaders" --filter "- Modules" "${DERIVED_FILES_DIR}/${basename}.dSYM" "${DWARF_DSYM_FOLDER_PATH}"
     else
       # The dSYM was not stripped at all, in this case touch a fake folder so the input/output paths from Xcode do not reexecute this script because the file is missing.
+      mkdir -p "${DWARF_DSYM_FOLDER_PATH}"
       touch "${DWARF_DSYM_FOLDER_PATH}/${basename}.dSYM"
     fi
   fi

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

@@ -59,14 +59,14 @@ module Pod
           end
         end
 
-        # @return [Bool] Whether an installation should be performed or this
+        # @return [Boolean] 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.
+        # @return [Boolean] Whether the podfile has changes respect to the lockfile.
         #
         def podfile_needs_install?
           state = podfile_state
@@ -74,7 +74,7 @@ module Pod
           needing_install > 0
         end
 
-        # @return [Bool] Whether the sandbox is in synch with the lockfile.
+        # @return [Boolean] Whether the sandbox is in synch with the lockfile.
         #
         def sandbox_needs_install?
           state = sandbox_state

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

@@ -56,7 +56,7 @@ module Pod
         # @note Non library specs are intentionally not included as part of the equality for pod variants since a pod
         #       variant should not be affected by the number of test nor app specs included.
         #
-        # @return [Bool] whether the {PodVariant} is equal to another taking all all their attributes into account
+        # @return [Boolean] whether the {PodVariant} is equal to another taking all all their attributes into account
         #
         def ==(other)
           self.class == other.class &&

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

@@ -31,12 +31,16 @@ module Pod
         #
         attr_reader :sandbox
 
+        # @return [Podfile] The Podfile to analyze dependencies.
+        #
+        attr_reader :podfile
+
         # @return [Array<Specifications>] The specifications returned by the
         #         resolver.
         #
         attr_reader :specs
 
-        # @return [Bool] Whether the installation is performed in update mode.
+        # @return [Boolean] Whether the installation is performed in update mode.
         #
         attr_reader :update_mode
 
@@ -45,11 +49,13 @@ module Pod
         # Init a new SandboxAnalyzer
         #
         # @param [Sandbox] sandbox @see sandbox
+        # @param [Podfile] podfile @see podfile
         # @param [Array<Specifications>] specs @see specs
-        # @param [Bool] update_mode @see update_mode
+        # @param [Boolean] update_mode @see update_mode
         #
-        def initialize(sandbox, specs, update_mode)
+        def initialize(sandbox, podfile, specs, update_mode)
           @sandbox = sandbox
+          @podfile = podfile
           @specs = specs
           @update_mode = update_mode
         end
@@ -86,8 +92,8 @@ module Pod
         # @return [Symbol] The state
         #
         def pod_state(pod)
-          return :added   if pod_added?(pod)
           return :deleted if pod_deleted?(pod)
+          return :added   if pod_added?(pod)
           return :changed if pod_changed?(pod)
           :unchanged
         end
@@ -99,11 +105,11 @@ module Pod
         # @param  [String] pod
         #         the name of the Pod.
         #
-        # @return [Bool] Whether the Pod is added.
+        # @return [Boolean] Whether the Pod is added.
         #
         def pod_added?(pod)
           return true if resolved_pods.include?(pod) && !sandbox_pods.include?(pod)
-          return true if !folder_exist?(pod) && !sandbox.local?(pod)
+          return true if !sandbox.local?(pod) && !folder_exist?(pod)
           false
         end
 
@@ -113,7 +119,7 @@ module Pod
         # @param  [String] pod
         #         the name of the Pod.
         #
-        # @return [Bool] Whether the Pod is deleted.
+        # @return [Boolean] Whether the Pod is deleted.
         #
         def pod_deleted?(pod)
           return true if !resolved_pods.include?(pod) && sandbox_pods.include?(pod)
@@ -132,13 +138,15 @@ module Pod
         # @param  [String] pod
         #         the name of the Pod.
         #
-        # @return [Bool] Whether the Pod is changed.
+        # @return [Boolean] Whether the Pod is changed.
         #
         def pod_changed?(pod)
           spec = root_spec(pod)
           return true if spec.version != sandbox_version(pod)
           return true if spec.checksum != sandbox_checksum(pod)
           return true if resolved_spec_names(pod) != sandbox_spec_names(pod)
+          podfile_dep = podfile_dependency(pod)&.tap { |dep| dep.podspec_repo = nil }
+          return true if podfile_dep != sandbox_dependency(pod)
           return true if sandbox.predownloaded?(pod)
           return true if folder_empty?(pod)
           false
@@ -161,14 +169,14 @@ module Pod
         # @return [Array<String>] The name of the resolved Pods.
         #
         def resolved_pods
-          specs.map { |spec| spec.root.name }.uniq
+          @resolved_pods ||= specs.map { |spec| spec.root.name }.uniq
         end
 
         # @return [Array<String>] The name of the Pods stored in the sandbox
         #         manifest.
         #
         def sandbox_pods
-          sandbox_manifest.pod_names.map { |name| Specification.root_name(name) }.uniq
+          @sandbox_pods ||= sandbox_manifest.pod_names.map { |name| Specification.root_name(name) }.uniq
         end
 
         # @return [Array<String>] The name of the resolved specifications
@@ -223,6 +231,26 @@ module Pod
           sandbox_manifest.checksum(pod)
         end
 
+        # @return [Dependency, nil] The dependency with the given name stored in the sandbox.
+        #
+        # @param  [String] pod
+        #         the name of the Pod.
+        #
+        def sandbox_dependency(pod)
+          sandbox_manifest.dependencies.find { |d| d.name == pod }
+        end
+
+        #--------------------------------------#
+
+        # @return [Dependency, nil] The dependency with the given name from the podfile.
+        #
+        # @param  [String] pod
+        #         the name of the Pod.
+        #
+        def podfile_dependency(pod)
+          podfile.dependencies.find { |d| d.name == pod }
+        end
+
         #--------------------------------------#
 
         def folder_exist?(pod)

data/lib/cocoapods/installer/analyzer.rb

@@ -35,7 +35,7 @@ module Pod
       #
       attr_reader :podfile
 
-      # @return [Lockfile] The Lockfile, if available, that stores the information about the Pods previously installed.
+      # @return [Lockfile, nil] The Lockfile, if available, that stores the information about the Pods previously installed.
       #
       attr_reader :lockfile
 
@@ -43,7 +43,7 @@ module Pod
       #
       attr_reader :plugin_sources
 
-      # @return [Bool] Whether the analysis has dependencies and thus sources must be configured.
+      # @return [Boolean] Whether the analysis has dependencies and thus sources must be configured.
       #
       # @note   This is used by the `pod lib lint` command to prevent update of specs when not needed.
       #
@@ -67,7 +67,7 @@ module Pod
       #
       # @param  [Sandbox] sandbox @see #sandbox
       # @param  [Podfile] podfile @see #podfile
-      # @param  [Lockfile] lockfile @see #lockfile
+      # @param  [Lockfile, nil] lockfile @see #lockfile
       # @param  [Array<Source>] plugin_sources @see #plugin_sources
       # @param  [Boolean] has_dependencies @see #has_dependencies
       # @param  [Hash, Boolean, nil] pods_to_update @see #pods_to_update
@@ -84,6 +84,7 @@ module Pod
         @installation_options = podfile.installation_options
         @podfile_dependency_cache = PodfileDependencyCache.from_podfile(podfile)
         @sources_manager = sources_manager
+        @path_lists = {}
         @result = nil
       end
 
@@ -93,7 +94,7 @@ module Pod
       # compute which specification should be installed. The manifest of the
       # sandbox returns which specifications are installed.
       #
-      # @param  [Bool] allow_fetches
+      # @param  [Boolean] allow_fetches
       #         whether external sources may be fetched
       #
       # @return [AnalysisResult]
@@ -125,7 +126,7 @@ module Pod
         validate_platforms(resolver_specs_by_target)
         specifications = generate_specifications(resolver_specs_by_target)
         aggregate_targets, pod_targets = generate_targets(resolver_specs_by_target, target_inspections)
-        sandbox_state   = generate_sandbox_state(specifications)
+        sandbox_state = generate_sandbox_state(specifications)
         specs_by_target = resolver_specs_by_target.each_with_object({}) do |rspecs_by_target, hash|
           hash[rspecs_by_target[0]] = rspecs_by_target[1].map(&:spec)
         end
@@ -193,7 +194,7 @@ module Pod
 
       # @!group Configuration
 
-      # @return [Bool] Whether the version of the dependencies which did not
+      # @return [Boolean] Whether the version of the dependencies which did not
       #         change in the Podfile should be locked.
       #
       def update_mode?
@@ -565,12 +566,11 @@ module Pod
         pod_targets_by_build_config = Hash.new([].freeze)
         build_configurations.each { |config| pod_targets_by_build_config[config] = [] }
 
+        dependencies_by_root_name = @podfile_dependency_cache.target_definition_dependencies(target_definition).group_by(&:root_name)
+
         pod_targets_by_target_definition[target_definition].each do |pod_target|
           pod_name = pod_target.pod_name
-
-          dependencies = @podfile_dependency_cache.target_definition_dependencies(target_definition).select do |dependency|
-            Specification.root_name(dependency.name) == pod_name
-          end
+          dependencies = dependencies_by_root_name[pod_name] || []
 
           build_configurations.each do |configuration_name|
             whitelists = dependencies.map do |dependency|
@@ -714,7 +714,12 @@ module Pod
         dependencies.map do |root_spec, deps|
           pod_targets_by_name[root_spec.name].find do |t|
             next false if t.platform.symbolic_name != target.platform.symbolic_name ||
-                t.build_as_framework? != target.build_as_framework? # rather than target type or requires_frameworks? since we want to group by what was specified in that _target definition_
+              # In the case of variants we must ensure that the platform this target is meant for is the same
+              # as the one we are interested in.
+              t.target_definitions.first.platform != target.target_definitions.first.platform ||
+              # rather than target type or requires_frameworks? since we want to group by what was specified in that
+              # _target definition_.
+              t.build_as_framework? != target.build_as_framework?
             spec_names = t.specs.map(&:name)
             deps.all? { |dep| spec_names.include?(dep.name) }
           end
@@ -826,7 +831,10 @@ module Pod
       def create_file_accessors(specs, platform)
         name = specs.first.name
         pod_root = sandbox.pod_dir(name)
-        path_list = Sandbox::PathList.new(pod_root)
+        path_list = @path_lists.fetch(pod_root) do |root|
+          path_list = Sandbox::PathList.new(root)
+          @path_lists[root] = path_list
+        end
         specs.map do |spec|
           Sandbox::FileAccessor.new(path_list, spec.consumer(platform))
         end
@@ -1115,7 +1123,7 @@ module Pod
       def generate_sandbox_state(specifications)
         sandbox_state = nil
         UI.section 'Comparing resolved specification to the sandbox manifest' do
-          sandbox_analyzer = SandboxAnalyzer.new(sandbox, specifications, update_mode?)
+          sandbox_analyzer = SandboxAnalyzer.new(sandbox, podfile, specifications, update_mode?)
           sandbox_state = sandbox_analyzer.analyze
           sandbox_state.print
         end

data/lib/cocoapods/installer/base_install_hooks_context.rb

@@ -16,6 +16,10 @@ module Pod
       #
       attr_reader :pods_project
 
+      # @return [Array<Pod::Project>] the subprojects nested under pods_project.
+      #
+      attr_reader :pod_target_subprojects
+
       # @return [Array<UmbrellaTargetDescription>] The list of
       #         the CocoaPods umbrella targets generated by the installer.
       #
@@ -26,12 +30,14 @@ module Pod
       # @param [Sandbox] sandbox see #sandbox
       # @param [String] sandbox_root see #sandbox_root
       # @param [Xcodeproj::Project] pods_project see #pods_project
+      # @param [Array<Xcodeproj::Project>] pod_target_subprojects see #pod_target_subprojects
       # @param [Array<UmbrellaTargetDescription>] umbrella_targets see #umbrella_targets
       #
-      def initialize(sandbox, sandbox_root, pods_project, umbrella_targets)
+      def initialize(sandbox, sandbox_root, pods_project, pod_target_subprojects, umbrella_targets)
         @sandbox = sandbox
         @sandbox_root = sandbox_root
         @pods_project = pods_project
+        @pod_target_subprojects = pod_target_subprojects
         @umbrella_targets = umbrella_targets
       end
 
@@ -43,6 +49,9 @@ module Pod
       # @param  [Project] pods_project
       #         The pods project.
       #
+      # @param  [Project] pod_target_subprojects
+      #         The subprojects nested under pods_project.
+      #
       # @param  [Array<AggregateTarget>] aggregate_targets
       #         The aggregate targets, which will been presented by an adequate
       #         {UmbrellaTargetDescription} in the generated context.
@@ -50,7 +59,7 @@ module Pod
       # @return [HooksContext] Convenience class method to generate the
       #         static context.
       #
-      def self.generate(sandbox, pods_project, aggregate_targets)
+      def self.generate(sandbox, pods_project, pod_target_subprojects, aggregate_targets)
         umbrella_targets_descriptions = aggregate_targets.map do |umbrella|
           user_project = umbrella.user_project
           user_targets = umbrella.user_targets
@@ -61,7 +70,13 @@ module Pod
           UmbrellaTargetDescription.new(user_project, user_targets, specs, platform_name, platform_deployment_target, cocoapods_target_label)
         end
 
-        new(sandbox, sandbox.root.to_s, pods_project, umbrella_targets_descriptions)
+        new(sandbox, sandbox.root.to_s, pods_project, pod_target_subprojects, umbrella_targets_descriptions)
+      end
+
+      # @return [Array<Pod::Project>] all projects generated during installation
+      #
+      def generated_projects
+        [pods_project] + pod_target_subprojects
       end
 
       # Pure data class which describes an umbrella target.
@@ -82,7 +97,7 @@ module Pod
         #
         attr_reader :specs
 
-        # @return [Symbol] The platform (either `:ios`, `:watchos`, `:tvos`, or `:osx`).
+        # @return [Symbol] The platform (either `:ios`, `:watchos`, `:tvos`, `:visionos`, or `:osx`).
         #
         attr_reader :platform_name
 

data/lib/cocoapods/installer/installation_options.rb

@@ -190,6 +190,17 @@ module Pod
       # Whether to skip generating the `Pods.xcodeproj` and perform only dependency resolution and downloading.
       #
       option :skip_pods_project_generation, false
+
+      # Whether to download pods in parallel before beginning the installation process
+      #
+      option :parallel_pod_downloads, false
+
+      # The size of the thread pool to use when downloading pods in parallel. Only takes effect when
+      # `parallel_pod_downloads` is `true`.
+      #
+      # Default: 40
+      #
+      option(:parallel_pod_download_thread_pool_size, 40, :boolean => false)
     end
   end
 end