Feat/100 set up firebase crashlytics

.github/workflows/CI.yml

@@ -17,6 +17,9 @@ jobs:
     - name: Checkout code
       uses: actions/checkout@v4
 
+    - name: Write google-services.json
+      run: echo '${{ secrets.GOOGLE_SERVICES_JSON }}' > app/google-services.json
+
     - name: Set up JDK 17
       uses: actions/setup-java@v4
       with:

app/build.gradle.kts

@@ -4,14 +4,16 @@ plugins {
     alias(libs.plugins.compose.compiler)
     alias(libs.plugins.google.devtools.ksp)
     alias(libs.plugins.hilt.android)
+    alias(libs.plugins.google.services)
+    alias(libs.plugins.firebase.crashlytics)
 }
 
 android {
-    namespace = "eu.project.sayitagain"
+    namespace = "eu.project.sia"
     compileSdk = 36
 
     defaultConfig {
-        applicationId = "eu.project.sayitagain"
+        applicationId = "eu.project.sia"
         minSdk = 26
         targetSdk = 34
         versionCode = 1
@@ -70,6 +72,13 @@ dependencies {
 //  Splash screen
     implementation(libs.androidx.core.splashscreen)
 
+//  Firebase
+    implementation(platform(libs.firebase.bom))
+
+//  Crashlytics
+    implementation(libs.firebase.crashlytics)
+    implementation(libs.firebase.analytics)
+
     implementation(project(":common"))
     implementation(project(":scaffold"))
     implementation(project(":localData"))

app/src/main/java/eu/project/sayitagain/ApplicationClass.kt → app/src/main/java/eu/project/sia/ApplicationClass.kt

@@ -1,4 +1,4 @@
-package eu.project.sayitagain
+package eu.project.sia
 
 import android.app.Application
 import dagger.hilt.android.HiltAndroidApp

app/src/main/java/eu/project/sayitagain/MainActivity.kt → app/src/main/java/eu/project/sia/MainActivity.kt

@@ -1,4 +1,4 @@
-package eu.project.sayitagain
+package eu.project.sia
 
 import android.net.Uri
 import android.os.Bundle

app/src/main/java/eu/project/sayitagain/SaveFileContract.kt → app/src/main/java/eu/project/sia/SaveFileContract.kt

@@ -1,4 +1,4 @@
-package eu.project.sayitagain
+package eu.project.sia
 
 import android.app.Activity
 import android.content.Context

build.gradle.kts

@@ -6,4 +6,6 @@ plugins {
     alias(libs.plugins.compose.compiler) apply false
     alias(libs.plugins.google.devtools.ksp) apply false
     alias(libs.plugins.hilt.android) apply false
+    alias(libs.plugins.google.services) apply false
+    alias(libs.plugins.firebase.crashlytics) apply false
 }

common/build.gradle.kts

@@ -54,5 +54,12 @@ dependencies {
     // Serialization
     implementation(libs.kotlinx.serialization.json)
 
+    //  Firebase
+    implementation(platform(libs.firebase.bom))
+
+    //  Crashlytics
+    implementation(libs.firebase.crashlytics)
+    implementation(libs.firebase.analytics)
+
     implementation(libs.navigation.compose)
 }

common/src/main/java/eu/project/common/crashlytics/CrashlyticsManager.kt

@@ -0,0 +1,23 @@
+package eu.project.common.crashlytics
+
+/**
+ * Abstraction over the crash reporting SDK.
+ */
+interface CrashlyticsManager {
+
+    /**
+     * Appends a message to the in-memory breadcrumb buffer.
+     */
+    fun logBreadcrumb(message: String)
+
+    /**
+     * Records a non-fatal exception and flushes the breadcrumb buffer
+     * into the report.
+     */
+    fun recordException(throwable: Throwable, extras: Map<String, String> = emptyMap())
+
+    /**
+     * Associates subsequent reports with a specific user.
+     */
+    fun setUserContext(userId: String, email: String)
+}

common/src/main/java/eu/project/common/crashlytics/CrashlyticsManagerImpl.kt

@@ -0,0 +1,22 @@
+package eu.project.common.crashlytics
+
+import com.google.firebase.crashlytics.FirebaseCrashlytics
+import jakarta.inject.Inject
+
+class CrashlyticsManagerImpl @Inject constructor(): CrashlyticsManager {
+
+    private val crashlytics = FirebaseCrashlytics.getInstance()
+
+    override fun logBreadcrumb(message: String) {
+        crashlytics.log(message)
+    }
+
+    override fun recordException(throwable: Throwable, extras: Map<String, String>) {
+        extras.forEach { (k, v) -> crashlytics.setCustomKey(k, v) }
+        crashlytics.recordException(throwable)
+    }
+
+    override fun setUserContext(userId: String, email: String) {
+        crashlytics.setUserId(userId)
+    }
+}

common/src/main/java/eu/project/common/crashlytics/CrashlyticsManagerModule.kt

@@ -0,0 +1,17 @@
+package eu.project.common.crashlytics
+
+import dagger.Module
+import dagger.Provides
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+import javax.inject.Singleton
+
+@Module
+@InstallIn(SingletonComponent::class)
+class CrashlyticsManagerModule {
+
+    @Provides
+    @Singleton
+    fun provideCrashlyticsManager(): CrashlyticsManager =
+        CrashlyticsManagerImpl()
+}

gradle/libs.versions.toml

@@ -1,12 +1,15 @@
 [versions]
 converterGsonVersion = "3.0.0"
 coreSplashscreenVersion = "1.2.0"
+firebaseBomVersion = "34.11.0"
 hiltNavigationComposeVersion = "1.2.0"
 activityComposeVersion = "1.10.1"
 composeBom = "2026.03.00"
 coreKtx = "1.16.0"
 hiltAndroidCompilerVersion = "2.56.2"
 hiltAndroidVersion = "2.56.2"
+googleServices = "4.4.4"
+firebaseCrashlytics = "3.0.6"
 junit = "4.13.2"
 junitVersion = "1.2.1"
 espressoCore = "3.6.1"
@@ -55,6 +58,9 @@ androidx-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
 androidx-ui-test-junit4 = { module = "androidx.compose.ui:ui-test-junit4" }
 androidx-ui-tooling-preview = { module = "androidx.compose.ui:ui-tooling-preview" }
 converter-gson = { module = "com.squareup.retrofit2:converter-gson", version.ref = "converterGsonVersion" }
+firebase-analytics = { module = "com.google.firebase:firebase-analytics" }
+firebase-bom = { module = "com.google.firebase:firebase-bom", version.ref = "firebaseBomVersion" }
+firebase-crashlytics = { module = "com.google.firebase:firebase-crashlytics" }
 hilt-android = { module = "com.google.dagger:hilt-android", version.ref = "hiltAndroidVersion" }
 hilt-android-compiler = { module = "com.google.dagger:hilt-android-compiler", version.ref = "hiltAndroidCompilerVersion" }
 junit = { module = "junit:junit", version.ref = "junit" }
@@ -83,4 +89,6 @@ kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", versi
 android-application = { id = "com.android.application", version.ref = "agpVersion" }
 kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlinVersion" }
 google-devtools-ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
-hilt-android = { id = "com.google.dagger.hilt.android", version.ref = "hiltAndroidVersion" }
+hilt-android = { id = "com.google.dagger.hilt.android", version.ref = "hiltAndroidVersion" }
+google-services = { id = "com.google.gms.google-services", version.ref = "googleServices" }
+firebase-crashlytics = { id = "com.google.firebase.crashlytics", version.ref = "firebaseCrashlytics" }