Common Issues

Fix build errors, missing network capture, and Apple Silicon compatibility problems.

Apple Silicon build errors

If you see unsupported Swift architecture or x86_64-only simulator slice errors, update to the latest DebugSwift release or switch to the XCFramework distribution.

pod 'DebugSwift', :http => 'https://github.com/DebugSwift/DebugSwift/releases/latest/download/DebugSwift.xcframework.zip'

Remove architecture exclusions

Delete EXCLUDED_ARCHS[sdk=iphonesimulator*] = arm64 from your Podfile. DebugSwift ships native arm64 simulator support.

Network not capturing

  • Confirm setup() runs before the first URLSession request
  • Check ignoredURLs and onlyURLs filters
  • Inject manually if URLSessionConfiguration is created early
  • Verify you are in a DEBUG build
Troubleshooting — network capture verification

Clean build

Product → Clean Build Folder (⌘⇧K), then delete DerivedData if issues persist.

More help

See the FAQ page or open a GitHub issue with your Xcode version, distribution method (SPM/CocoaPods/XCFramework), and steps to reproduce.