iOS SDK Compatibility

Supported Versions

Flashcat RUM iOS SDK supports the following operating system versions:

Platform	Support Status	Version	Notes
iOS	✅	12.0+
iPadOS	✅	12.0+
tvOS	✅	12.0+
macOS (Designed for iPad)	✅	11.0+
macOS (Catalyst)	⚠️ Partial Support	10.14+	Catalyst build mode is supported, but some SDK features may not work fully on macOS targets
macOS	⚠️ Partial Support	10.14+	Flashcat SDK does not officially support macOS, some features may not work fully
visionOS	⚠️ Partial Support	1.0+	Flashcat SDK does not officially support visionOS, some features may not work fully
watchOS	❌ Not Supported	-	watchOS platform is currently not supported

Supported Platform Features

Development Tools

Xcode

The SDK is built with the latest version of Xcode but always maintains backward compatibility with the minimum Xcode version required for App Store submissions.

Recommended version: Xcode 14.0 and above

Dependency Management Tools

Flashcat iOS SDK currently supports integration with the following dependency management tools:

Tool	Support Status	Notes
Swift Package Manager	✅	Recommended
CocoaPods	🚧 Planned	Coming soon
Carthage	🚧 Planned	Coming soon

Programming Languages

Language	Version	Support Status
Swift	5.0+	✅
Objective-C	2.0	✅

UI Framework Compatibility

Framework	Auto-tracking	Manual Tracking	Notes
UIKit	✅	✅	Supports automatic tracking of UIViewController and user interactions
SwiftUI	⚠️	✅	Requires `.trackRUMView()` and `.trackRUMTapAction()` modifiers

Network Framework Compatibility

Framework/Library	Auto-tracking	Manual Tracking	Notes
URLSession	✅	✅	Requires enabling `URLSessionInstrumentation`
Alamofire	❌	✅	Manual tracking via custom interceptors
Apollo GraphQL	❌	✅	Manual tracking via custom interceptors
AFNetworking	❌	⚠️	Not recommended, suggest migration to URLSession

WebView Support

Type	Support Status	Notes
WKWebView	✅	Requires `FlashcatWebView` module integration
UIWebView	❌	Deprecated by Apple, not supported

SDK Module Overview

Flashcat iOS SDK consists of the following modules:

Module Name	Functionality	Platform Support
FlashcatCore	Core SDK providing basic features	iOS, iPadOS, tvOS, macOS
FlashcatRUM	RUM data collection and reporting	iOS, iPadOS, tvOS
FlashcatWebView	WebView integration support	iOS, iPadOS
FlashcatCrash	Crash reporting (integrates PLCrashReporter)	iOS, iPadOS, tvOS

Third-Party Dependencies

Flashcat iOS SDK depends on the following third-party libraries:

Library Name	Version	Purpose
PLCrashReporter	1.12.0	Crash report collection

Known Limitations

SwiftUI

SwiftUI views need manual addition of .trackRUMView() modifier to be tracked

Using .trackRUMTapAction() within List may affect default gesture behavior

For List elements, custom action API is recommended

macOS and visionOS

macOS and visionOS are not officially supported platforms

Some UIKit-dependent features may not work properly on these platforms

Future version compatibility is not guaranteed

Catalyst

Catalyst mode only supports builds, some features may be limited at runtime

Thorough testing is recommended before actual use

Minimum Deployment Requirements

To ensure SDK works properly, please verify:

Minimum OS version: iOS 12.0 / iPadOS 12.0 / tvOS 12.0

Minimum Xcode version: Xcode 14.0

Minimum Swift version: Swift 5.0

Network permissions: App needs network access permission to report data

Storage space: SDK requires small amount of local storage for caching offline data

Performance Impact

Flashcat iOS SDK is designed to be lightweight with minimal impact on app performance:

CPU usage: < 1%

Memory usage: < 10 MB

Package size increase: Approximately 2-3 MB (depending on integrated modules)

Startup time impact: < 100ms

Update Strategy

Major version updates: May contain incompatible changes requiring code adjustments

Minor version updates: New features, backward compatible

Patch version updates: Bug fixes, fully backward compatible

Regular updates to the latest stable SDK version are recommended for optimal performance and security.

iOS SDK Integration Guide: Learn how to integrate the SDK

iOS SDK Advanced Configuration: Learn about SDK advanced configuration options

iOS SDK Data Collection: Learn what data the SDK collects

Compatibility

Supported Versions#

Supported Platform Features#

Development Tools#

Xcode#

Dependency Management Tools#

Programming Languages#

UI Framework Compatibility#

Network Framework Compatibility#

WebView Support#

SDK Module Overview#

Third-Party Dependencies#

Known Limitations#

SwiftUI#

macOS and visionOS#

Catalyst#

Minimum Deployment Requirements#

Performance Impact#

Update Strategy#

Related Documentation#