ExzileGames.AndroidCrashlyticsBridge 1.0.24

AndroidCrashlyticsBridge

A Java bridge + C# interop library for Firebase Crashlytics on .NET Android. Records C# exceptions with proper type grouping so that Crashlytics groups crashes by exception type rather than lumping them all under "recorded exception".

Problem

When you call FirebaseCrashlytics.getInstance().recordException(throwable) from C# via the Xamarin binding, all recorded exceptions appear under the same generic bucket in the Crashlytics dashboard. There is no way to pass a meaningful type name through the raw binding, so NullReferenceException, InvalidOperationException, and every other C# exception look identical.

Solution

This library compiles a Java bridge class directly into your Android project. The Java class constructs a real Throwable subclass whose toString() returns the original C# type name. Crashlytics uses toString() for grouping, so each distinct C# exception type gets its own issue in the dashboard. The C# stack trace is also parsed and mapped to StackTraceElement objects so frames are readable in the Crashlytics UI.

APIs Exposed

Requirements

• google-services.json must be present in your Android app project and the GoogleServicesJson build action must be set. Firebase Crashlytics will not initialise without it.
• Firebase is initialised automatically via FirebaseInitProvider — no explicit FirebaseApp.InitializeApp call is required.

Setup

1. Add project reference

<ProjectReference Include="..\AndroidCrashlyticsBridge\AndroidCrashlyticsBridge.csproj" />

2. Add google-services.json

Place your google-services.json in the Android app project root and set its build action:

<GoogleServicesJson Include="google-services.json" />

3. Initialize in your Activity

using AndroidCrashlyticsBridge.Interop;

protected override void OnCreate(Bundle? savedInstanceState)
{
    base.OnCreate(savedInstanceState);

    var crashlytics = new AndroidCrashlyticsBridgeImpl(this);
    CrashlyticsBridgeManager.SetImplementation(crashlytics);
}

4. Use from shared code

using AndroidCrashlyticsBridge.Interop;

// Record a caught exception (grouped by type in the dashboard)
try
{
    DoSomethingRisky();
}
catch (Exception ex)
{
    CrashlyticsBridgeManager.RecordException(ex);
}

// Attach contextual information
CrashlyticsBridgeManager.SetUserId("player-12345");
CrashlyticsBridgeManager.SetCustomKey("level", 7);
CrashlyticsBridgeManager.SetCustomKey("scene", "MainMenu");

// Write a breadcrumb log
CrashlyticsBridgeManager.Log("Player entered the shop");

// Check if the previous session crashed
if (CrashlyticsBridgeManager.DidCrashOnPreviousExecution)
    ShowCrashRecoveryDialog();

License

MIT