Debug log: prepare database for persisting across app restarts

Author: UweTrottmann

app/schemas/com.battlelancer.seriesguide.diagnostics.DebugLogDatabase/1.json

@@ -0,0 +1,51 @@
+{
+  "formatVersion": 1,
+  "database": {
+    "version": 1,
+    "identityHash": "21481ab4ef726d3a2527dbc9c9835889",
+    "entities": [
+      {
+        "tableName": "debug_log",
+        "createSql": "CREATE TABLE IF NOT EXISTS `${TABLE_NAME}` (`id` INTEGER NOT NULL, `priority` INTEGER, `tag` TEXT, `message` TEXT, `timestamp` INTEGER, PRIMARY KEY(`id`))",
+        "fields": [
+          {
+            "fieldPath": "id",
+            "columnName": "id",
+            "affinity": "INTEGER",
+            "notNull": true
+          },
+          {
+            "fieldPath": "priority",
+            "columnName": "priority",
+            "affinity": "INTEGER"
+          },
+          {
+            "fieldPath": "tag",
+            "columnName": "tag",
+            "affinity": "TEXT"
+          },
+          {
+            "fieldPath": "message",
+            "columnName": "message",
+            "affinity": "TEXT"
+          },
+          {
+            "fieldPath": "timestamp",
+            "columnName": "timestamp",
+            "affinity": "INTEGER"
+          }
+        ],
+        "primaryKey": {
+          "autoGenerate": false,
+          "columnNames": [
+            "id"
+          ]
+        }
+      }
+    ],
+    "setupQueries": [
+      "CREATE TABLE IF NOT EXISTS room_master_table (id INTEGER PRIMARY KEY,identity_hash TEXT)",
+      "INSERT OR REPLACE INTO room_master_table (id,identity_hash) VALUES(42, '21481ab4ef726d3a2527dbc9c9835889')"
+    ]
+  }
+}

app/src/main/java/com/battlelancer/seriesguide/diagnostics/DebugLogDatabase.kt

@@ -0,0 +1,57 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright © 2025 Uwe Trottmann <[email protected]>
+
+package com.battlelancer.seriesguide.diagnostics
+
+import android.content.Context
+import androidx.room.ColumnInfo
+import androidx.room.Dao
+import androidx.room.Database
+import androidx.room.Entity
+import androidx.room.Insert
+import androidx.room.PrimaryKey
+import androidx.room.Query
+import androidx.room.Room
+import androidx.room.RoomDatabase
+
+@Database(
+    entities = [DbDebugLogEntry::class],
+    version = 1
+)
+abstract class DebugLogDatabase : RoomDatabase() {
+    abstract fun debugLogHelper(): DebugLogHelper
+
+    companion object {
+
+        private const val DATABASE_NAME = "debug-log.db"
+
+        fun build(context: Context): DebugLogDatabase {
+            return Room
+                .databaseBuilder(context, DebugLogDatabase::class.java, DATABASE_NAME)
+                .build()
+        }
+    }
+}
+
+@Entity(tableName = "debug_log")
+data class DbDebugLogEntry(
+    @PrimaryKey val id: Int,
+    @ColumnInfo(name = "priority") val priority: Int?,
+    @ColumnInfo(name = "tag") val tag: String?,
+    @ColumnInfo(name = "message") val message: String?,
+    @ColumnInfo(name = "timestamp") val timestamp: Long?
+)
+
+@Dao
+interface DebugLogHelper {
+
+    @Insert
+    suspend fun insert(entry: DbDebugLogEntry)
+
+    @Query("SELECT * FROM debug_log")
+    suspend fun getAll(): List<DbDebugLogEntry>
+
+    @Query("DELETE FROM debug_log WHERE timestamp < :deleteIfOlderThan")
+    suspend fun deleteOld(deleteIfOlderThan: Long)
+
+}