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

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.
