Skip to main content

​
Integration Issues

Issue: Compilation errors occur after integrating with SPM.Solutions:
  1. Check if Xcode version meets requirements (Xcode 16.0+)
  2. Clean project cache: Product → Clean Build Folder
  3. Delete DerivedData folder
  4. Re-fetch dependency packages
Preventive Measures:
  • Use the latest stable version of Xcode
  • Update dependency packages regularly
  • Use the same Xcode version in CI/CD
Issue: Application crashes on startup after integrating with CocoaPods.Solutions:
  1. Check iOS version setting in Podfile
  2. Ensure use_frameworks! is added
  3. Run pod deintegrate then pod install again
  4. Check architecture settings in Build Settings
Common Configuration:
platform :ios, '16.0'
use_frameworks!

target 'YourApp' do
  pod 'SPAvatarKit', '~> 1.0.0'
end
Issue: “No matching architecture” error occurs during compilation.Solutions:
  1. Check Build Settings → Architectures settings
  2. Ensure Valid Architectures includes arm64
  3. Check Excluded Architectures settings
  4. Clean project and recompile

​
Performance Issues

Issue: Avatar rendering frame rate is lower than expected, affecting user experience.Possible Causes:
  1. Insufficient device performance
  2. Model complexity too high
  3. Insufficient memory
  4. Background process interference
Optimization Suggestions:
  1. Use models suitable for the device
  2. Lower rendering resolution
  3. Close unnecessary background processes
  4. Use performance monitoring tools
Issue: Application memory usage is too high, potentially causing crashes.Solutions:
  1. Release unnecessary renderer instances promptly
  2. Use deinit to clean up resources
  3. Monitor memory usage
  4. Implement memory warning handling
Issue: Application startup time is too long, affecting user experience.Optimization Suggestions:
  1. Delay SDK initialization
  2. Use background threads for initialization
  3. Preload commonly used resources
  4. Optimize model file size

​
Network Issues

Issue: Unstable network connection causes functionality issues.Solutions:
  1. Implement network status monitoring
  2. Add retry mechanism
  3. Provide offline mode
  4. Cache important resources
Issue: HTTPS certificate verification fails.Solutions:
  1. Check if server certificate is valid
  2. Confirm network security configuration in Info.plist
  3. Use NSAllowsArbitraryLoads in development environment
  4. Use valid SSL certificate in production environment

​
Debugging Tips

Troubleshooting Steps:
  1. Enable crash log collection
  2. Use Xcode debugger
  3. Check memory usage
  4. Verify thread safety

​
Version Compatibility

Supported iOS Versions: 16.0+Notes:
  • Some new features may only be available in higher versions
  • Testing on multiple iOS versions is recommended
Minimum Requirement: Xcode 16.0+Recommended Version: Xcode 17.0+Notes:
  • Using newer versions of Xcode can provide better performance
  • Some compilation optimizations are only available in newer versions