pod-builder 6.0.2 → 6.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fed719cee7d859bf10cd194913e5814f3b0bcd91371bdd11952123bff998caa
-  data.tar.gz: b2767ef27bc60333be2c62c4e07fc4fba007af810cac78d8862ef3017b25186a
+  metadata.gz: 80ded6f213c9086a27740b25a687db1738b791e3f9558e9cb161d0d7feb4a8c0
+  data.tar.gz: 0bed40e1d4a6ec73af065c1c1984e876e9a3b38138b6ef2c72aaea3ceefa1708
 SHA512:
-  metadata.gz: d7b18e54ac32ce7e4bdc9ddf00c2026f35a0965ba44030216a26a028384dda4a74dca769d476778e4680c118023c8666bda2914f61a292a62ace2825fb19d2b4
-  data.tar.gz: 42f4e22b67180fbeb45290028341227139bf40dbbb5071260457c5530932108972d95101e73d23f5c3ae633e40692b740464da7902d37993bcefd0767ce658c1
+  metadata.gz: f771e31b9761f1b37fd977c4f3528cbf8fa2d17d2c8a11a48ae4c7a410e19318bad8047a6766d345cd8775db8c0c9502490bc24e425bc5210c279cd76362bbd4
+  data.tar.gz: b24f8bb9aea6f6a8840d9c2b94a129efeb114696aa9cfef5f31748767d6d41667f58a06c5098f6a8ed692c8682a68bac30f3435d3063489b918447a7d8df9e86

data/README.md

@@ -396,6 +396,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/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/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.1.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.1.0
 platform: ruby
 authors:
 - Tomas Camin
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-30 00:00:00.000000000 Z
+date: 2026-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler