Google Firebase Crashlytics

Firebase Crashlytics is a real-time crash reporting solution that helps you identify, prioritize, and resolve the most critical issues affecting your app users. This plugin integrates the iOS and Android Firebase Crashlytics SDKs into your app and supports logging of native crashes, WebView console errors, and (on Android) toast errors.

Why use Google Firebase Crashlytics

• App crash events: Native crash reporting.
• WebView console errors: WebView console errors logged to Crashlytics.
• Android toast errors: Android-only (e.g. SSL certificate warnings).
• Runtime control: Enable/disable log collection and set user IDs via the Median JavaScript Bridge.

Prerequisites

• A Median.co app with JavaScript Bridge enabled
• Firebase project with Crashlytics enabled
• GoogleService-Info.plist (iOS) and google-services.json (Android) from Firebase Console
• Plugin purchased and enabled in Median App Studio

👍

Developer Demo

Display our demo page in your app to test during development https://median.dev/crashlytics

When to use this plugin

Firebase Crashlytics is essential for apps that need to:

What You'll Do

Use this section as a fast navigation map into the full setup and implementation details:

1. Enable the plugin in App Studio: Go to Plugin Setup and complete Enable the Plugin.
2. Configure log collection behavior: Review Configuration Options to set requestOptIn, toastErrorLogsEnabled, and webErrorLogsEnabled.
3. Control logging at runtime: Use JavaScript Bridge Functions, especially enable, webErrorLogsEnabled, and toastErrorLogsEnabled.
4. Attach logs to specific users: Implement setUserId and unsetUserId in JavaScript Bridge Functions.
5. Add consent when required: Configure Optional: Request User Consent for Log Collection.

Plugin Setup

Enable the Plugin

1. Navigate to Native Plugins: Open your app in Median's App Studio and go to the Native Plugins section.
2. Enable Firebase Crashlytics: Select Google Firebase Crashlytics from your list of purchased plugins and enable it.
3. Configure log collection: Use the options below to customize which logs are collected.

Configuration Options

Toggle the options as needed, then click Advanced Mode for further configuration.

App Configuration

1. Register your app in the Firebase Console.
2. Download the configuration files:
   1. Android: google-services.json
   2. iOS: GoogleService-Info.plist
3. Upload GoogleService-Info.plist (iOS) and google-services.json (Android) in the Median App Studio under Build & Download > Google Services. You can upload the files from Firebase or copy and paste their contents into App Studio.

For full instructions, refer to the official Firebase setup guides:

• Android Setup
• iOS Setup

Finalizing the App Build

Once the configuration files are uploaded, save the changes and rebuild your app.

Implementation Guide

JavaScript Bridge Functions

The Median JavaScript Bridge allows you to control Crashlytics at runtime.

Enable/Disable logs collection

Enable or disable Crashlytics log collection at runtime.

↔️Median JavaScript Bridge

JavaScript

// Enable/disable Crashlytics
median.firebaseCrashlytics.enable(true);
median.firebaseCrashlytics.enable(false);

// WebView error logging
median.firebaseCrashlytics.webErrorLogsEnabled(true);
median.firebaseCrashlytics.webErrorLogsEnabled(false);

// Toast error logging (Android only)
median.firebaseCrashlytics.toastErrorLogsEnabled(true);
median.firebaseCrashlytics.toastErrorLogsEnabled(false);

Parameters:

Set user id

Assign a custom user ID to track crash logs per user in Firebase. Persists between app launches; cleared on uninstall/reinstall.

↔️Median JavaScript Bridge

median.firebaseCrashlytics.setUserId('user_123');

Unset user id

Remove the previously set user ID.

↔️Median JavaScript Bridge

median.firebaseCrashlytics.unsetUserId();

Optional: Request user consent for log collection

To comply with privacy policies or regulations, you can ask users for permission before collecting logs. Enable the permission prompt by setting requestOptIn to true in the plugin configuration. Users will see a permission dialog on first app launch after installation.

Testing checklist

Use this checklist to verify Crashlytics is configured and logging as expected:

Troubleshooting

📘

Still having trouble?

For Firebase Crashlytics outside Median.co refer to Firebase Crashlytics documentation.