firebase_crashlytics_tvos 0.0.3

tvOS (Apple TV) implementation of the firebase_crashlytics Flutter plugin, providing Firebase Crashlytics crash reporting on Apple TV.

firebase_crashlytics_tvos

The tvOS implementation of firebase_crashlytics.

Ported with flutter-tvos plugin port from firebase_crashlytics 5.3.0 (Swift + Pigeon), then finished + verified by hand. See PORTING_REPORT.md.

Usage

Federated plugin implementation — no imports needed from app code; it registers automatically. Apps that already use firebase_crashlytics and target tvOS add:

dependencies:
    firebase_crashlytics: ^5.3.0
    firebase_crashlytics_tvos: ^0.0.3
    firebase_core: ^4.14.0
    firebase_core_tvos: ^0.0.4 # tvOS core (this package depends on it)

Version alignment matters. This package's native code matches the firebase_core_platform_interface 8.1.1 train (firebase_core 4.14.x). Use 0.0.2 with firebase_crashlytics 5.3.0+, 0.0.1 with 5.2.x. Keep your whole Firebase stack on one consistent FlutterFire release, or Dart initializeApp(options:) can crash in CoreFirebaseOptions.fromList at launch (a FirebaseOptions field-count mismatch).

Status

Platform	Implemented	Verified
Apple TV (appletvos)	yes	0.0.1: crash reported to the console. 0.0.2: not yet run
Apple TV simulator (appletvsimulator)	yes	✅ 0.0.2: all calls work, crash detected on relaunch

All firebase_crashlytics Dart APIs work on tvOS. Ordinary crashes are captured (signal + NSException handlers), but tvOS has no alternate signal stack, so stack-overflow crashes may be missed, and the Mach exception server is off. Crashes upload on the next app launch — force a crash, relaunch, then check the console.

Symbolication (dSYM)

Native crash frames need dSYM upload on every Apple platform. iOS wires this automatically; this tvOS port doesn't (the auto step needs a .symlinks path the flutter-tvos layout lacks). dSYMs are still produced (the podspec sets dwarf-with-dsym) — just add a Run Script phase to your app's Runner target that runs "${PODS_ROOT}/FirebaseCrashlytics/run". Dart recordError reports are already symbolicated.

Swift Package Manager

This package ships a tvos/Package.swift. flutter-tvos links a plugin that ships tvos/Package.swift through Swift Package Manager and leaves it out of the Podfile. No manual setup is needed. It depends on firebase_core_tvos 0.0.4, which ships one too, and takes firebase-ios-sdk ~> 12.15.0, as in the podspec.

Needs flutter-tvos 1.3.0 or later, the first release that links plugins through SwiftPM, places them side by side (so ../firebase_core_tvos and ../FlutterFramework resolve) and leaves them out of the Podfile.

License

fluttertv under a BSD-3-Clause license. See LICENSE for the full text.