Apply Xcode 11 XCTUnwrap fix to library and framwork targets.

CHANGELOG.md

@@ -14,6 +14,10 @@ To install release candidates run `[sudo] gem install cocoapods --pre`
 
 ##### Bug Fixes
 
+* Apply Xcode 11 `XCTUnwrap` fix for libraries and frameworks.  
+  [Dimitris Koutsogiorgas](https://github.com/dnkoutso)
+  [#9500](https://github.com/CocoaPods/CocoaPods/pull/9500)
+
 * Fix resources script when building a project from a symlink.  
   [Dimitris Koutsogiorgas](https://github.com/dnkoutso)
   [#9423](https://github.com/CocoaPods/CocoaPods/issues/9423)

lib/cocoapods/target/build_settings.rb

@@ -351,6 +351,23 @@ def _ld_runpath_search_paths(requires_host_target: false, test_bundle: false)
 
       #-------------------------------------------------------------------------#
 
+      # @!group Protected Methods
+
+      protected
+
+      # Xcode 11 causes an issue with frameworks or libraries before 12.2 deployment target that link or are part of
+      # test bundles that use XCTUnwrap. Apple has provided an official work around for this.
+      #
+      # @see https://developer.apple.com/documentation/xcode_release_notes/xcode_11_release_notes
+      #
+      # @return [Boolean] Whether to apply the fix or not.
+      #
+      def should_apply_xctunwrap_fix?
+        false
+      end
+
+      #-------------------------------------------------------------------------#
+
       # @!group Private Methods
 
       private
@@ -492,9 +509,15 @@ def self.build_settings_names
         attr_reader :test_xcconfig
         alias test_xcconfig? test_xcconfig
 
+        # @return [Boolean]
+        #   whether settings are being generated for an application bundle
+        #
         attr_reader :app_xcconfig
         alias app_xcconfig? app_xcconfig
 
+        # @return [Boolean]
+        #   whether settings are being generated for an library bundle
+        #
         attr_reader :library_xcconfig
         alias library_xcconfig? library_xcconfig
 
@@ -683,6 +706,12 @@ def initialize(target, non_library_spec = nil, configuration: nil)
           file_accessors.flat_map(&:vendored_xcframeworks).map { |path| Xcode::XCFramework.new(path) }
         end
 
+        # @return [Array<String>]
+        define_build_settings_method :system_framework_search_paths, :build_setting => true, :memoized => true, :sorted => true, :uniqued => true do
+          return ['$(PLATFORM_DIR)/Developer/usr/lib'] if should_apply_xctunwrap_fix?
+          []
+        end
+
         #-------------------------------------------------------------------------#
 
         # @!group Libraries
@@ -737,7 +766,9 @@ def linker_names_from_libraries(libraries)
 
         # @return [Array<String>]
         define_build_settings_method :library_search_paths, :build_setting => true, :memoized => true, :sorted => true, :uniqued => true do
-          return [] if library_xcconfig? && target.build_as_static?
+          if library_xcconfig? && target.build_as_static?
+            return should_apply_xctunwrap_fix? ? ['$(PLATFORM_DIR)/Developer/usr/lib'] : []
+          end
 
           vendored = library_search_paths_to_import.dup
           vendored.concat dependent_targets.flat_map { |pt| pt.build_settings[@configuration].vendored_dynamic_library_search_paths }
@@ -746,6 +777,7 @@ def linker_names_from_libraries(libraries)
           else
             vendored.concat(dependent_targets.flat_map { |pt| pt.build_settings[@configuration].library_search_paths_to_import })
           end
+          vendored.concat ['$(PLATFORM_DIR)/Developer/usr/lib'] if should_apply_xctunwrap_fix?
           vendored
         end
 
@@ -837,6 +869,7 @@ def other_swift_flags_without_swift?
         define_build_settings_method :swift_include_paths, :build_setting => true, :memoized => true, :sorted => true, :uniqued => true do
           paths = dependent_targets.flat_map { |pt| pt.build_settings[@configuration].swift_include_paths_to_import }
           paths.concat swift_include_paths_to_import if non_library_xcconfig?
+          paths.concat ['$(PLATFORM_DIR)/Developer/usr/lib'] if should_apply_xctunwrap_fix?
           paths
         end
 
@@ -966,6 +999,12 @@ def pod_target_xcconfig_values_by_consumer_by_key
           end
         end
 
+        # @see BuildSettings#should_apply_xctunwrap_fix?
+        def should_apply_xctunwrap_fix?
+          non_library_specs = target.test_specs + target.app_specs
+          libr && non_library_specs.any? { |spec| Version.new(target.deployment_target_for_non_library_spec(spec)) <= Version.new('12.1') }
+        end
+
         #-------------------------------------------------------------------------#
       end
 
@@ -1037,6 +1076,12 @@ def initialize(target, configuration_name, configuration: nil)
           []
         end
 
+        # @return [Array<String>]
+        define_build_settings_method :system_framework_search_paths, :build_setting => true, :memoized => true, :sorted => true, :uniqued => true do
+          return ['$(PLATFORM_DIR)/Developer/usr/lib'] if should_apply_xctunwrap_fix?
+          []
+        end
+
         #-------------------------------------------------------------------------#
 
         # @!group Libraries
@@ -1048,6 +1093,7 @@ def initialize(target, configuration_name, configuration: nil)
 
         # @return [Array<String>]
         define_build_settings_method :library_search_paths, :build_setting => true, :memoized => true, :sorted => true, :uniqued => true, :from_pod_targets_to_link => true, :from_search_paths_aggregate_targets => :vendored_dynamic_library_search_paths do
+          return ['$(PLATFORM_DIR)/Developer/usr/lib'] if should_apply_xctunwrap_fix?
           []
         end
 
@@ -1113,6 +1159,7 @@ def other_swift_flags_without_swift?
 
         # @return [Array<String>]
         define_build_settings_method :swift_include_paths, :build_setting => true, :memoized => true, :sorted => true, :uniqued => true, :from_pod_targets_to_link => true, :from_search_paths_aggregate_targets => :swift_include_paths_to_import do
+          return ['$(PLATFORM_DIR)/Developer/usr/lib'] if should_apply_xctunwrap_fix?
           []
         end
 
@@ -1246,6 +1293,11 @@ def user_target_xcconfig_values_by_consumer_by_key
           merged_xcconfigs(user_target_xcconfig_values_by_consumer_by_key, :user_target_xcconfig)
         end
 
+        # @see BuildSettings#should_apply_xctunwrap_fix?
+        def should_apply_xctunwrap_fix?
+          target.library? && target.user_targets.any? { |ut| Version.new(ut.deployment_target) <= Version.new('12.1') }
+        end
+
         #-------------------------------------------------------------------------#
       end
     end

spec/spec_helper.rb

@@ -138,10 +138,12 @@ def fixture_pod_target_with_specs(specs, build_type = Pod::BuildType.static_libr
 
 def fixture_aggregate_target(pod_targets = [], build_type = Pod::BuildType.static_library,
                              user_build_configurations = Pod::Target::DEFAULT_BUILD_CONFIGURATIONS, archs = [],
-                             platform = Pod::Platform.new(:ios, '6.0'), target_definition = nil)
+                             platform = Pod::Platform.new(:ios, '6.0'), target_definition = nil, user_project = nil,
+                             user_target_uuids = [])
   target_definition ||= pod_targets.flat_map(&:target_definitions).first || fixture_target_definition
   Pod::AggregateTarget.new(config.sandbox, build_type, user_build_configurations, archs, platform,
-                           target_definition, config.sandbox.root.dirname, nil, nil, 'Release' => pod_targets)
+                           target_definition, config.sandbox.root.dirname, user_project, user_target_uuids,
+                           'Release' => pod_targets)
 end
 
 #-----------------------------------------------------------------------------#

spec/unit/target/build_settings/aggregate_target_settings_spec.rb

@@ -13,13 +13,18 @@ def pod_target(spec, target_definition)
         end
 
         before do
-          @target_definition = fixture_target_definition
+          project_path = SpecHelper.create_sample_app_copy_from_fixture('SampleProject')
+          @project = Xcodeproj::Project.open(project_path)
+          @project.save
+          @native_target = @project.targets.find { |t| t.name == 'SampleProject' }
+          @target_definition = fixture_target_definition('SampleProject')
           @specs = specs
           @specs.first.user_target_xcconfig = { 'OTHER_LDFLAGS' => '-no_compact_unwind', 'USE_HEADERMAP' => 'NO' } unless @specs.empty?
           @specs.first.pod_target_xcconfig = { 'CLANG_CXX_LANGUAGE_STANDARD' => 'c++11' } unless @specs.empty?
           @pod_targets = @specs.map { |spec| pod_target(spec, @target_definition) }
           @target = fixture_aggregate_target(@pod_targets, BuildType.static_library, { 'Release' => :release }, [],
-                                             Platform.new(:ios, '6.0'), @target_definition)
+                                             Platform.new(:ios, '6.0'), @target_definition, @project,
+                                             [@native_target.uuid])
           unless @specs.empty?
             @target.target_definition.whitelist_pod_for_configuration(@specs.first.name, 'Release')
           end
@@ -190,7 +195,7 @@ def pod_target(spec, target_definition)
             end
 
             it 'links the pod targets with the aggregate target' do
-              @xcconfig.to_hash['OTHER_LDFLAGS'].should.include '-l"BananaLib-Pods"'
+              @xcconfig.to_hash['OTHER_LDFLAGS'].should.include '-l"BananaLib-Pods-SampleProject"'
             end
           end
 
@@ -316,6 +321,43 @@ def specs
               @target.stubs(:build_type => BuildType.static_library)
               @generator.generate.to_hash['LD_RUNPATH_SEARCH_PATHS'].should == "$(inherited) '@executable_path/Frameworks' '@loader_path/Frameworks'"
             end
+
+            it 'includes the xctunwrap fix for library targets with iOS deployment target <= 12.1' do
+              SpecHelper.create_sample_app_copy_from_fixture('SampleProject/Sample Lib')
+              project_path = File.join(temporary_directory, 'SampleProject', 'Sample Lib', 'Sample Lib.xcodeproj')
+              project = Xcodeproj::Project.open(project_path)
+              project.save
+              native_target = project.targets.find { |t| t.name == 'SampleFramework' }
+              target_definition = fixture_target_definition('SampleFramework')
+              pod_targets = specs.map { |spec| pod_target(spec, target_definition) }
+              target = fixture_aggregate_target(pod_targets, BuildType.static_library, { 'Release' => :release }, [],
+                                                Platform.new(:ios, '6.0'), target_definition, project,
+                                                [native_target.uuid])
+              generator = AggregateTargetSettings.new(target, 'Release', :configuration => :release)
+              hash = generator.generate.to_hash
+              hash['SYSTEM_FRAMEWORK_SEARCH_PATHS'].should.include '"$(PLATFORM_DIR)/Developer/usr/lib"'
+              hash['LIBRARY_SEARCH_PATHS'].should.include '"$(PLATFORM_DIR)/Developer/usr/lib"'
+              hash['SWIFT_INCLUDE_PATHS'].should.include '"$(PLATFORM_DIR)/Developer/usr/lib"'
+            end
+
+            it 'does not include xctunwrap fix for a library target with higher than 12.1 deployment target' do
+              SpecHelper.create_sample_app_copy_from_fixture('SampleProject/Sample Lib')
+              project_path = File.join(temporary_directory, 'SampleProject', 'Sample Lib', 'Sample Lib.xcodeproj')
+              project = Xcodeproj::Project.open(project_path)
+              project.save
+              native_target = project.targets.find { |t| t.name == 'SampleFramework' }
+              native_target.stubs(:deployment_target).returns('12.2')
+              target_definition = fixture_target_definition('SampleFramework')
+              pod_targets = specs.map { |spec| pod_target(spec, target_definition) }
+              target = fixture_aggregate_target(pod_targets, BuildType.static_library, { 'Release' => :release }, [],
+                                                Platform.new(:ios, '12.2'), target_definition, project,
+                                                [native_target.uuid])
+              generator = AggregateTargetSettings.new(target, 'Release', :configuration => :release)
+              hash = generator.generate.to_hash
+              hash['SYSTEM_FRAMEWORK_SEARCH_PATHS'].should.be.nil
+              hash['LIBRARY_SEARCH_PATHS'].should.not.include '"$(PLATFORM_DIR)/Developer/usr/lib"'
+              hash['SWIFT_INCLUDE_PATHS'].should.be.nil
+            end
           end
 
           describe 'with a scoped pod target' do
@@ -387,14 +429,16 @@ def pod_target(spec, target_definition)
 
           it 'includes correct default runpath search path list for OSX unit test bundle user target' do
             @target.stubs(:platform).returns(Platform.new(:osx, '10.10'))
-            mock_user_target = mock('usertarget', :symbol_type => :unit_test_bundle)
+            mock_user_target = mock('usertarget')
+            mock_user_target.stubs(:symbol_type).returns(:unit_test_bundle)
             @target.stubs(:user_targets).returns([mock_user_target])
             @generator.generate.to_hash['LD_RUNPATH_SEARCH_PATHS'].should == "$(inherited) '@executable_path/../Frameworks' '@loader_path/../Frameworks'"
           end
 
           it 'includes correct default runpath search path list for OSX application user target' do
             @target.stubs(:platform).returns(Platform.new(:osx, '10.10'))
-            mock_user_target = mock('usertarget', :symbol_type => :application)
+            mock_user_target = mock('usertarget')
+            mock_user_target.stubs(:symbol_type).returns(:application)
             @target.stubs(:user_targets).returns([mock_user_target])
             @generator.generate.to_hash['LD_RUNPATH_SEARCH_PATHS'].should == "$(inherited) '@executable_path/../Frameworks' '@loader_path/Frameworks'"
           end

spec/unit/target/build_settings/pod_target_settings_spec.rb

@@ -420,7 +420,7 @@ class BuildSettings
             @coconut_pod_target.test_dependent_targets_by_spec_name = { @coconut_test_spec.name => [@monkey_pod_target] }
             generator = PodTargetSettings.new(@coconut_pod_target, nil, :configuration => :debug)
             xcconfig = generator.generate
-            xcconfig.to_hash['LIBRARY_SEARCH_PATHS'].should.be.nil
+            xcconfig.to_hash['LIBRARY_SEARCH_PATHS'].should == '$(inherited) "$(PLATFORM_DIR)/Developer/usr/lib"'
             xcconfig.to_hash['OTHER_LDFLAGS'].should.be.nil
           end