Cannot build project after requirering and importing Sentry

[philprime]

Discussed in #5044

^{Originally posted by pquerner April 2, 2025}
Hey, for a while now I cannot add Sentry to my project. I've tried on and off for a few months, thinking maybe its the Xdebug version or something inbetween and it would fix itself. But it never did and now I am lost.

I dont really know where to start looking, so I will just give every info I have, hopeing someone knows what to do. :D

Podfile has this:

pod 'Sentry', :git => 'https://github.com/getsentry/sentry-cocoa.git', :tag => '8.48.0'

pod install:

pod install
Analyzing dependencies
Pre-downloading: `Sentry` from `https://github.com/getsentry/sentry-cocoa.git`, tag `8.48.0`
Downloading dependencies
Installing Sentry (8.48.0)
Generating Pods project
Integrating client project
Pod installation complete! There are 8 dependencies from the Podfile and 17 total pods installed.

[!] Your project does not explicitly specify the CocoaPods master specs repo. Since CDN is now used as the default, you may safely remove it from your repos directory via `pod repo remove master`. To suppress this warning please add `warn_for_unused_master_specs_repo => false` to your Podfile.

Opening the project and building (no import of Sentry SDK yet) works fine. App works.
Add import Sentry to AppDelegate and try to build: doesnt build anymore.

The build logs (errors); I have modified my apps name.

2025-04-02T22-52-28.txt

Xcode Version is Version 16.2 (16C5032a) on macos 14.5 (23F79). (M1 Macbook Pro)

Min target (as per Podfile) for my app is ios 12.

What I've tried:

• delete /Library/Developer/Xcode/DerivedData (all folders within)
• clear build (many times)
• delete pods folder and pod install again (Pods folder is in my git)
• use the wizard to install sentry, same results
• trying older versions (many months ago), under different xcode versions even

Thank you!

[pquerner]

Hello, thanks for converting into an issue.
I've just send you an email with a small sample project attached.

Upon adding
import Sentry to the AppDelegate file the project does not build anymore.
I've used Cocoapods again and also included the other pods aswell - that my real application uses. In the sample project although they are all unused.

Side node: when using the wizard onto a new project, Sentry is added not by Cocoapods and is using a different dependency system. I have no knowledge about that so I scrapped that. (Because my real application doesnt use it either) But I tried building it this way (without my other dependencies) and it worked. So maybe its a CocoaPods issue?

[philprime]

Thank you for sending the sample, I can reproduce it locally.

[philprime]

Quick update from my side:

• The issue seems to be related to use_modular_headers! in the Podfile as it seems to create a module header even though sentry-cocoa includes an umbrella header. This is unexpected.
• Removing the use_modular_headers! might fix this, but it is required by the pods Firebase/Core and Firebase/Messaging
• Removing the two Firebase pods, compilation works on my end for both cases with use_modular_headers! and without it.

It seems to me that the way Firebase is compiled, it conflicts with our SDK.
Will continue investigation to understand why.

[pquerner]

I just looked at some old branches I had. (I wanted to integrate Sentry for a long time, but then other topics come up and I dropped it again. It never got merged into my app and went into production.)
The oldest version I had installed was

  - Sentry (8.27.0):
    - Sentry/Core (= 8.27.0)
  - Sentry/Core (8.27.0)

This was working (I think?), so any version after that "broke" it.

[philprime]

Thank you for the hint!

There has been quite some activity between 8.27.0 and 8.48.0.

After manually testing versions I found 8.29.1 the last version to work with the Podfile (and after fixing the SentryThreadMetadataCache.hpp, and starting with 8.30.0 the duplicate interface definitions issue is visible.

Heres the diff for reference: 8.29.1...8.30.0

While not sure yet what is causing this issue, the scope to search in is less now.

[philprime]

It looks like this Podfile does not work:

use_modular_headers!
platform :ios, '12.0'

target 'YourTarget' do
	use_frameworks!
end

pod 'Sentry', :git => 'https://github.com/getsentry/sentry-cocoa.git', :tag => '8.48.0'
pod 'Firebase/Core'
pod 'Firebase/Messaging'

while this does work:

use_modular_headers!
platform :ios, '12.0'

target 'YourTarget' do
	use_frameworks!

  pod 'Sentry', :git => 'https://github.com/getsentry/sentry-cocoa.git', :tag => '8.48.0'
  pod 'Firebase/Core'
  pod 'Firebase/Messaging'
end

Looking at the diff in the Pods folder, it seems like declaring pod outside of a target will create global Pods, causing multiple compilation and generation of tons of additional header files.

After moving the pods into the target I was also able to install the Firebase pods without defining use_modular_headers!.

Can you please test your project setup with the pods declared in the target block, rather than on the global level, and let me know if it resolves the problem for you?

[pquerner]

Thanks for figuring it out. :) I will gladly test out your solution in a bit.
Quick question:

I have multiple targets, and they all share the same libraries. Should only Sentry and Firebase be added to its own "Target" group while leaving out all the other libs?

Like this:

target 'YourTarget' do
	use_frameworks!

  pod 'Sentry', :git => 'https://github.com/getsentry/sentry-cocoa.git', :tag => '8.48.0'
  pod 'Firebase/Core'
  pod 'Firebase/Messaging'
end

target 'AnontherTarget' do
	use_frameworks!

  pod 'Sentry', :git => 'https://github.com/getsentry/sentry-cocoa.git', :tag => '8.48.0'
  pod 'Firebase/Core'
  pod 'Firebase/Messaging'
end

pod 'globalDependencyForAllTargets'

Or should I copy all other dependency into the target group aswell, like this: (and having no "global depency")

target 'YourTarget' do
	use_frameworks!

  pod 'Sentry', :git => 'https://github.com/getsentry/sentry-cocoa.git', :tag => '8.48.0'
  pod 'Firebase/Core'
  pod 'Firebase/Messaging'
pod 'sharedDependency1'
pod 'sharedDependency2'
end

target 'AnontherTarget' do
	use_frameworks!

  pod 'Sentry', :git => 'https://github.com/getsentry/sentry-cocoa.git', :tag => '8.48.0'
  pod 'Firebase/Core'
  pod 'Firebase/Messaging'
pod 'sharedDependency1'
pod 'sharedDependency2'
end

Do you know whats best-practise there?

Thanks!