pod-builder 6.0.2 → 6.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fed719cee7d859bf10cd194913e5814f3b0bcd91371bdd11952123bff998caa
-  data.tar.gz: b2767ef27bc60333be2c62c4e07fc4fba007af810cac78d8862ef3017b25186a
+  metadata.gz: 306492a077037cf3f5d3147f969c0d5a10d7192b6b62b753f976447d295e03e5
+  data.tar.gz: 2d02289b4e4916f87b1d46b11a3469f0067f9b904b299b9d0753e270db51b967
 SHA512:
-  metadata.gz: d7b18e54ac32ce7e4bdc9ddf00c2026f35a0965ba44030216a26a028384dda4a74dca769d476778e4680c118023c8666bda2914f61a292a62ace2825fb19d2b4
-  data.tar.gz: 42f4e22b67180fbeb45290028341227139bf40dbbb5071260457c5530932108972d95101e73d23f5c3ae633e40692b740464da7902d37993bcefd0767ce658c1
+  metadata.gz: 0ed234e2e919b8055e3e8e40c5e9e3bcca6722cfd65bc1a5c043748e5d21f487dc9af4eedc20c68913083e52118c76826127862340b691ae902bc97cfa463a3b
+  data.tar.gz: 2ad0db58b1c33e415e6591a45dbfae27e47f805adb11be645701896b64a17eaa55a7d86e1b7eaef0b3eab1d933c7dcefe9c304f161405c0c7ea148d2696e363c

data/README.md

@@ -322,6 +322,10 @@ Specify which pods PodBuilder should NOT be built as .xcframeworks when `build_x
 
 Specify which pods PodBuilder should be built as .xcframeworks. Will enable `library_evolution_support`. Default value: []
 
+#### `default_build_configuration`
+
+Specify the build configuration used to prebuild pods, either `debug` or `release`. Pods that specify a `prebuild_configuration` in the `pod_target_xcconfig` of their podspec (or via `spec_overrides`) are unaffected. Default value: `release`
+
 #### `generate_coverage`
 
 Specify if coverage data for use with profiled execution should be generated. Default value: false
@@ -396,6 +400,24 @@ You need to specify a `path` to the executable script which is relative to the _
 
 **Note:** The build action might be invoked more than once depending on the build strategy that PodBuilder needs to perform.
 
+#### Environment variables available to `pre_actions`/`post_actions` scripts
+
+`switch` and `build`/`install` actions are invoked with a set of environment variables describing the pods involved, so scripts don't need to re-parse the Podfile or `ARGV` themselves.
+
+| Variable | Description | `switch` | `install`/`build` |
+|---|---|---|---|
+| `PB_PODS` | Comma-separated pod names explicitly passed on the command line | ✅ | ✅ |
+| `PB_SWITCH_MODE` | `prebuilt`, `development` or `default` | ✅ | |
+| `PB_PARENT_DEPS` | Comma-separated pods added because they depend on `PB_PODS` (via `switch`'s `-r`; always resolved for `build`) | ✅ | ✅ |
+| `PB_CHILD_DEPS` | Comma-separated pods added because `PB_PODS` depends on them (via `switch`'s `-c`; always resolved for `build`) | ✅ | ✅ |
+| `PB_UPDATE_REPOS` | `true`/`false`, whether the CocoaPods repo was updated (`-u` sets this to `false`) | ✅ | ✅ |
+| `PB_CONFIGURATION` | `debug` or `release` | | ✅ |
+| `PB_XCFRAMEWORK` | `true`/`false`, whether this pod is being built as an xcframework | | ✅ |
+
+Note: For `pre_actions[:switch]`, dependency resolution (`-r`/`-c`) hasn't run yet, so `PB_PARENT_DEPS`/`PB_CHILD_DEPS` are always empty there; `PB_PODS` is also the raw, unresolved argument list. Check `post_actions[:switch]` if you need the fully resolved set.
+
+`pre_actions[:build]` is invoked from a different context than `pre_actions[:install]`/`post_actions[:build]` — a CocoaPods `post_install` hook nested inside the build's own `pod install`, rather than directly from the `build` command loop. All the same variables are set there too, threaded through via the internal `podbuilder-rome` plugin options.
+
 
 # Behind the scenes
 

data/lib/pod_builder/actions.rb

@@ -32,7 +32,7 @@ module PodBuilder
         raise "\n\nEmpty or missing #{step} #{name} action path\n".red if @path.empty?()
       end
 
-      def execute()
+      def execute(env = {})
         cmd = PodBuilder::basepath(path)
         unless File.exist?(cmd)
           raise "\n\n#{@step.capitalize} #{@name} action path '#{cmd}' does not exists!\n".red
@@ -43,7 +43,22 @@ module PodBuilder
         end
 
         puts "Executing #{@step} #{@name} action".yellow
+
+        previous_env = {}
+        env.each do |key, value|
+          previous_env[key] = ENV[key]
+          ENV[key] = value.to_s
+        end
+
         `#{cmd}`
+      ensure
+        previous_env&.each do |key, value|
+          if value.nil?
+            ENV.delete(key)
+          else
+            ENV[key] = value
+          end
+        end
       end
     end
   end

data/lib/pod_builder/command/build.rb

@@ -41,6 +41,8 @@ module PodBuilder
         }
         argument_pods = available_argument_pods.uniq
 
+        explicit_pod_names = argument_pods.dup
+
         Podfile.restore_podfile_clean(all_buildable_items)
 
         restore_file_error = Podfile.restore_file_sanity_check
@@ -50,6 +52,8 @@ module PodBuilder
         pods_to_build = resolve_pods_to_build(argument_pods, buildable_items)
         buildable_items -= pods_to_build
 
+        parent_dep_names = pods_to_build.map(&:root_name).uniq - explicit_pod_names
+
         argument_pods += pods_to_build.map(&:root_name)
         argument_pods.uniq!
 
@@ -67,7 +71,9 @@ module PodBuilder
         # 2. PodB is marked to be built as xcframework
         # 3. We rebuild PodA only (pods_to_build contains only PodA)
         # 4. We need to add dependencies recursively so that PodB is is added to pods_to_build_release_xcframework
+        pre_recursive_dep_names = pods_to_build.map(&:root_name).uniq
         pods_to_build = pods_to_build.map { |t| t.recursive_dependencies(all_buildable_items) }.flatten.uniq
+        child_dep_names = pods_to_build.map(&:root_name).uniq - pre_recursive_dep_names
 
         pods_to_build_debug = pods_to_build.select { |x| x.build_configuration == "debug" }
         pods_to_build_release = pods_to_build - pods_to_build_debug
@@ -113,20 +119,24 @@ module PodBuilder
           # pods_to_build_release and therefore build will fail
           podfile_items = podfile_items.map { |t| t.recursive_dependencies(all_buildable_items) }.flatten.uniq
 
-          podfile_content = Podfile.from_podfile_items(podfile_items, analyzer, build_configuration, install_using_frameworks, build_catalyst, podfile_items.first.build_xcframework)
+          podfile_content = Podfile.from_podfile_items(podfile_items, analyzer, build_configuration, install_using_frameworks, build_catalyst, podfile_items.first.build_xcframework,
+                                                        pods: explicit_pod_names, parent_deps: parent_dep_names, child_deps: child_dep_names)
 
           PodBuilder::safe_rm_rf(Configuration.build_path)
           FileUtils.mkdir_p(Configuration.build_path)
 
           init_git(Configuration.build_path) # this is needed to be able to call safe_rm_rf
 
-          Configuration.pre_actions[:install]&.execute()
+          env = build_env(explicit_pod_names, parent_deps: parent_dep_names, child_deps: child_dep_names,
+                           configuration: build_configuration, xcframework: podfile_items.first.build_xcframework)
+
+          Configuration.pre_actions[:install]&.execute(env)
 
           install_result += Install.podfile(podfile_content, podfile_items, argument_pods, podfile_items.first.build_configuration)
 
           FileUtils.rm_f(PodBuilder::basepath("Podfile.lock"))
 
-          Configuration.post_actions[:build]&.execute()
+          Configuration.post_actions[:build]&.execute(env)
         end
 
         install_result.write_prebuilt_info_files
@@ -265,6 +275,17 @@ module PodBuilder
         return buildable_subspecs - pods_to_build
       end
 
+      def self.build_env(pods, parent_deps: [], child_deps: [], configuration: nil, xcframework: false)
+        {
+          "PB_PODS" => pods.join(","),
+          "PB_PARENT_DEPS" => parent_deps.join(","),
+          "PB_CHILD_DEPS" => child_deps.join(","),
+          "PB_UPDATE_REPOS" => (OPTIONS[:update_repos] != false).to_s,
+          "PB_CONFIGURATION" => configuration.to_s,
+          "PB_XCFRAMEWORK" => xcframework.to_s,
+        }
+      end
+
       def self.resolve_pods_to_build(argument_pods, buildable_items)
         pods_to_build = []
 

data/lib/pod_builder/command/switch.rb

@@ -25,11 +25,11 @@ module PodBuilder
           end
         end
 
-        unless argument_pods.count > 0 
+        unless argument_pods.count > 0
           return -1
         end
 
-        Configuration.pre_actions[:switch]&.execute()
+        Configuration.pre_actions[:switch]&.execute(switch_env(argument_pods))
 
         pods_not_found = []
         pod_names_to_switch = []
@@ -40,12 +40,14 @@ module PodBuilder
           if pod_name_to_switch.nil?
             raise "\n\n'#{pod}' not found in PodBuilder's Podfile.\n\nYou might need to explictly add:\n\n    pod '#{pod}'\n\nto #{PodBuilder::basepath("Podfile")}\n".red
           else
-            check_not_building_subspec(pod_name_to_switch)  
+            check_not_building_subspec(pod_name_to_switch)
 
-            pod_names_to_switch.push(pod_name_to_switch)  
-          end          
+            pod_names_to_switch.push(pod_name_to_switch)
+          end
         end
 
+        explicit_pod_names = pod_names_to_switch.dup
+
         if OPTIONS[:resolve_parent_dependencies] == true
           install_update_repo = OPTIONS.fetch(:update_repos, false)
           installer, analyzer = Analyze.installer_at(PodBuilder::basepath, install_update_repo)
@@ -67,6 +69,8 @@ module PodBuilder
           pod_names_to_switch.uniq!
         end
 
+        parent_dep_names = pod_names_to_switch - explicit_pod_names
+
         dep_pod_names_to_switch = []
         if OPTIONS[:resolve_child_dependencies] == true
           pod_names_to_switch.each do |pod|
@@ -207,7 +211,7 @@ module PodBuilder
           system("#{bundler_prefix}pod install;")  
         end
 
-        Configuration.post_actions[:switch]&.execute()
+        Configuration.post_actions[:switch]&.execute(switch_env(explicit_pod_names, parent_deps: parent_dep_names, child_deps: dep_pod_names_to_switch))
 
         puts "\n\n🎉 done!\n".green
 
@@ -284,6 +288,16 @@ module PodBuilder
           raise "\n\nCan't switch subspec #{pod_to_switch} refer to podspec name.\n\nUse `pod_builder switch #{pod_to_switch.split("/").first}` instead\n".red
         end
       end
+
+      def self.switch_env(pods, parent_deps: [], child_deps: [])
+        {
+          "PB_PODS" => pods.join(","),
+          "PB_SWITCH_MODE" => OPTIONS[:switch_mode].to_s,
+          "PB_PARENT_DEPS" => parent_deps.join(","),
+          "PB_CHILD_DEPS" => child_deps.join(","),
+          "PB_UPDATE_REPOS" => (OPTIONS[:update_repos] != false).to_s,
+        }
+      end
     end
   end    
 end

data/lib/pod_builder/configuration.rb

@@ -49,6 +49,7 @@ module PodBuilder
       attr_accessor :build_settings
       attr_accessor :build_settings_overrides
       attr_accessor :build_system
+      attr_accessor :default_build_configuration
       attr_accessor :library_evolution_support
       attr_accessor :base_path
       attr_accessor :spec_overrides
@@ -91,6 +92,7 @@ module PodBuilder
 
     @allow_building_development_pods = false
     @build_system = "Latest".freeze # either Latest (New build system) or Legacy (Standard build system)
+    @default_build_configuration = "release" # either debug or release, overridable per pod via podspec's `prebuild_configuration`
     @library_evolution_support = false
     @base_path = "PodBuilder" # Not nice. This value is used only for initial initization. Once config is loaded it will be an absolute path. FIXME
     @skip_licenses = []
@@ -186,6 +188,10 @@ module PodBuilder
         if value.is_a?(String) && ["Latest", "Legacy"].include?(value)
           Configuration.build_system = value
         end
+        value = json["default_build_configuration"]
+        if value.is_a?(String) && ["debug", "release"].include?(value.downcase)
+          Configuration.default_build_configuration = value.downcase
+        end
         value = json["library_evolution_support"]
         if [TrueClass, FalseClass].include?(value.class)
           Configuration.library_evolution_support = value

data/lib/pod_builder/podfile.rb

@@ -4,7 +4,7 @@ module PodBuilder
   class Podfile
     PODBUILDER_LOCK_ACTION = ["raise \"\\n🚨  Do not launch 'pod install' manually, use `pod_builder` instead!\\n\" if !File.exist?('pod_builder.lock')"].freeze
 
-    def self.from_podfile_items(items, analyzer, build_configuration, install_using_frameworks, build_catalyst, build_xcframeworks)
+    def self.from_podfile_items(items, analyzer, build_configuration, install_using_frameworks, build_catalyst, build_xcframeworks, pods: [], parent_deps: [], child_deps: [])
       raise "\n\nno items\n".red unless items.count > 0
 
       # Xcode 14 requires a development team to be specified for the compilation to succeed
@@ -54,6 +54,10 @@ module PodBuilder
 
       podfile.sub!("%%%code_sign_identity%%%", code_sign_identity)
 
+      podfile.sub!("%%%pods%%%", pods.join(","))
+      podfile.sub!("%%%parent_deps%%%", parent_deps.join(","))
+      podfile.sub!("%%%child_deps%%%", child_deps.join(","))
+
       podfile_build_settings = ""
 
       git_rootpath = PodBuilder::git_rootpath

data/lib/pod_builder/podfile_item.rb

@@ -250,7 +250,7 @@ module PodBuilder
       root_spec = all_specs.detect { |t| t.name == @root_name } || spec
       @source_files = source_files_from([spec, root_spec] + default_subspecs_specs)
 
-      @build_configuration = spec.root.attributes_hash.dig("pod_target_xcconfig", "prebuild_configuration") || "release"
+      @build_configuration = spec.root.attributes_hash.dig("pod_target_xcconfig", "prebuild_configuration") || Configuration.default_build_configuration
       @build_configuration.downcase!
 
       default_license = "MIT"

data/lib/pod_builder/rome/post_install.rb

@@ -342,7 +342,14 @@ Pod::HooksManager.register("podbuilder-rome", :post_install) do |installer_conte
   raise "\n\nUnsupported target count\n".red unless targets.count == 1
   target = targets.first
 
-  PodBuilder::Configuration.pre_actions[:build]&.execute()
+  PodBuilder::Configuration.pre_actions[:build]&.execute({
+    "PB_PODS" => user_options.fetch("pods", ""),
+    "PB_PARENT_DEPS" => user_options.fetch("parent_deps", ""),
+    "PB_CHILD_DEPS" => user_options.fetch("child_deps", ""),
+    "PB_UPDATE_REPOS" => (OPTIONS[:update_repos] != false).to_s,
+    "PB_CONFIGURATION" => configuration.to_s.downcase,
+    "PB_XCFRAMEWORK" => build_xcframeworks.to_s,
+  })
 
   if build_xcframeworks
     project_path = sandbox_root.parent + "Pods/Pods.xcodeproj"

data/lib/pod_builder/templates/build_podfile.template

@@ -7,7 +7,7 @@ PodBuilder::Configuration::load
 
 %%%use_frameworks%%%
 
-plugin 'podbuilder-rome', {  dsym: true, configuration: '%%%build_configuration%%%', uses_frameworks: %%%uses_frameworks%%%, keep_swiftmodules: %%%keep_swiftmodules%%%, build_catalyst: %%%build_catalyst%%%, build_xcframeworks: %%%build_xcframeworks%%%, code_sign_identity: '%%%code_sign_identity%%%', prebuilt_root_paths: '%%%prebuilt_root_paths%%%', pre_compile: Proc.new { |installer|
+plugin 'podbuilder-rome', {  dsym: true, configuration: '%%%build_configuration%%%', uses_frameworks: %%%uses_frameworks%%%, keep_swiftmodules: %%%keep_swiftmodules%%%, build_catalyst: %%%build_catalyst%%%, build_xcframeworks: %%%build_xcframeworks%%%, code_sign_identity: '%%%code_sign_identity%%%', prebuilt_root_paths: '%%%prebuilt_root_paths%%%', pods: '%%%pods%%%', parent_deps: '%%%parent_deps%%%', child_deps: '%%%child_deps%%%', pre_compile: Proc.new { |installer|
 
   def set_build_settings(target_name, build_configurations, installer)
     installer.pods_project.targets.each do |target|

data/lib/pod_builder/version.rb

@@ -1,3 +1,3 @@
 module PodBuilder
-  VERSION = "6.0.2"
+  VERSION = "6.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pod-builder
 version: !ruby/object:Gem::Version
-  version: 6.0.2
+  version: 6.2.0
 platform: ruby
 authors:
 - Tomas Camin
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-30 00:00:00.000000000 Z
+date: 2026-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler