Crash Reporter Module

Requirements

• Tealium for Android (5.0.0+)

Install

Install the Crash Reporter module with Maven or manually.

Maven

To install the Crash Reporter module with Maven:

1. In your project’s top-level build.gradle file, add the following Maven repository:

   // Top-level build file where you add configuration options common to all sub-projects/modules.
   allprojects {
         repositories {
           mavenCentral()
           // Tealium Maven repo directive
           maven {
               url "https://maven.tealiumiq.com/android/releases/"
           }
         }
     }
   

2. In your project module’s build.gradle file, add the following Maven dependency:

   dependencies {
         // only add if not already present
         implementation 'com.tealium:library:5.8.0'
         // add crash reporter to list of dependencies
         implementation 'com.tealium:crashreporter:1.1.0'
   }
   

Manual

To install the Crash Reporter module manually:

1. Download the Tealium Crash Reporter module.

2. Copy the file tealium.crashreporter-1.1.0.aar into your project’s <PROJECT_ROOT>/<MODULE>/libs directory.

3. Add the Tealium library dependency to your project module’s build.gradle file:

   dependencies {
         implementation (name:'tealium.crashreporter-1.1.0', ext:'aar')
   }
   

Initialize

Initialize the Crash Reporter module, as shown in the following example::

  ```java
  Tealium.Config config = Tealium.Config.create(application, "ACCOUNT", "PROFILE", "ENVIRONMENT");

  //Enable Crash Reporter
  CrashReporter.initialize(BuildConfig.TEALIUM_MAIN, config, true);

  //Standard Tealium instance
  Tealium.createInstance("INSTANCE_NAME", config);
  ```

Tracked Events

Once initialized, the Crash Reporter module automatically captures crash data. If a thread abruptly terminates, .uncaughtExceptionHandler() is invoked and the crash information is saved to disk. Upon the next launch, the saved crash information will be dispatched along with your other events.

Crash events are tracked as tealium_event="crash".

Crash Reporter is a singleton instance call. Chaining handlers is not currently supported.

Data Layer

The Crash Reporter module sends the following crash attributes in the event:

Integrations

• New Relic Mobile Crash Tracking Connector

API Reference

For the complete reference of methods for the Crash Reporter module, see the CrashReporter class in the Tealium SDK for Android API.