Refactor: Refactored background persistence behavior (SessionKeepAliveService), NotificationHelper, and LogManager.

app/build.gradle

@@ -8,6 +8,8 @@ plugins {
     alias(libs.plugins.spotless)
 }
 
+apply from: rootProject.file('gradle/collectLogTags.gradle')
+
 /*
 abstract class InstallVulkanValidationLayerTask extends DefaultTask {
     @Input
@@ -59,6 +61,10 @@ task checkSubmodules {
 
 preBuild.dependsOn(checkSubmodules)
 
+tasks.named('preBuild') {
+    dependsOn 'collectLogTags'
+}
+
 /*
 def installVulkanValidationLayer = tasks.register("installVulkanValidationLayer", InstallVulkanValidationLayerTask) {
     layerVersion.set("1.4.341.0")
@@ -200,11 +206,13 @@ android {
     sourceSets {
         main {
             java.srcDirs = [
+//                    'src/main/java',  // Needed for Android Studio
                     'src/main/app',
                     'src/main/feature',
                     'src/main/sharedmemory',
                     'src/main/runtime',
-                    'src/main/shared'
+                    'src/main/shared',
+                    'build/generated/source/logtags'    // Generated by collectLogTags.gradle
             ]
         }
     }
@@ -224,7 +232,7 @@ android {
 }
 
 dependencies {
-    // debugImplementation "com.squareup.leakcanary:leakcanary-android:2.14"
+//    debugImplementation "com.squareup.leakcanary:leakcanary-android:2.14"
 
     implementation libs.okhttp
     implementation libs.okhttpDnsOverHttps
@@ -272,6 +280,7 @@ dependencies {
     implementation files('libs/MidiSynth/MidiSynth.jar')
     implementation libs.recyclerview
     implementation libs.coreKtx
+    implementation("androidx.lifecycle:lifecycle-process:2.9.0")    // New = compilation errors / gradle plugin update requirement.
 
 
     implementation 'com.android.ndk.thirdparty:openssl:1.1.1q-beta-1'

app/src/main/AndroidManifest.xml

@@ -36,6 +36,7 @@
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE" />
     <uses-permission android:name="android.permission.WAKE_LOCK" />
+    <uses-permission android:name="android.permission.READ_LOGS"/>
     <uses-permission
         android:name="android.permission.WRITE_SECURE_SETTINGS"
         tools:ignore="ProtectedPermissions" />

app/src/main/app/shell/UnifiedActivity.kt

@@ -237,12 +237,14 @@ import com.winlator.cmod.shared.theme.WinNativeTheme
 import dagger.hilt.android.AndroidEntryPoint
 import dagger.Lazy
 import com.winlator.cmod.feature.stores.steam.enums.EPersonaState
+import com.winlator.cmod.runtime.system.LogManager
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.async
 import kotlinx.coroutines.awaitAll
 import kotlinx.coroutines.delay
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
+import timber.log.Timber
 import javax.inject.Inject
 import kotlin.math.abs
 import kotlin.math.roundToInt
@@ -1511,6 +1513,17 @@ class UnifiedActivity :
     override fun onCreate(savedInstanceState: Bundle?) {
         instance = this
         super.onCreate(savedInstanceState)
+
+        // Initialize Timber in debug builds for logging.
+        // If 'BuildConfig' give error, ignore it.
+        // The file needed will be autogenerated when building the apk.
+        if (com.winlator.cmod.BuildConfig.DEBUG) {
+            Timber.plant(Timber.DebugTree());
+        }
+
+        // Initialize the LogManager context in case a fallback is needed.
+        LogManager.init(this)
+
         if (!SetupWizardActivity.isSetupComplete(this) || !ImageFs.find(this).isUpToDate) {
             startActivity(
                 Intent(this, SetupWizardActivity::class.java)

app/src/main/feature/settings/debug/DebugFragment.kt

@@ -8,11 +8,11 @@ import android.os.Looper
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
-import androidx.compose.material3.MaterialTheme
 import androidx.compose.material3.darkColorScheme
 import androidx.compose.runtime.CompositionLocalProvider
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
 import androidx.compose.runtime.setValue
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.platform.ComposeView
@@ -25,6 +25,8 @@ import androidx.fragment.app.Fragment
 import androidx.preference.PreferenceManager
 import com.winlator.cmod.R
 import com.winlator.cmod.app.config.SettingsConfig
+import com.winlator.cmod.runtime.system.GeneratedLogTags
+import com.winlator.cmod.runtime.system.LogManager
 import com.winlator.cmod.app.shell.UnifiedActivity
 import com.winlator.cmod.shared.io.AssetPaths
 import com.winlator.cmod.shared.io.FileUtils
@@ -82,9 +84,41 @@ class DebugFragment : Fragment() {
                                         .stopAppLogging()
                                     com.winlator.cmod.runtime.system.LogManager
                                         .updateLoggingState(ctx)
+                                    com.winlator.cmod.runtime.system.LogManager
+                                        .clearManualTextFilter()
+                                }
+                                refresh()
+                            },
+                            onExitReasonLogChanged = { checked ->
+                                preferences.edit { putBoolean("enable_exit_reason_log", checked) }
+                                if (checked) {
+                                    // Capture previous exit reasons, so the user doesn't need
+                                    // to restart the app to check previous reasons.
+                                    com.winlator.cmod.runtime.system.LogManager
+                                        .logLastExitReasons(ctx)
+                                }
+                                refresh()
+                            },
+                            onCrashLogChanged = { checked ->
+                                preferences.edit { putBoolean("enable_crash_log", checked) }
+                                if (checked) {
+                                    // Capture previous crashes, so the user doesn't need
+                                    // to restart to check previous reasons.
+                                    com.winlator.cmod.runtime.system.LogManager
+                                        .logLastExitReasons(ctx)
                                 }
                                 refresh()
                             },
+                            onEventWatchLogChanged = { checked ->
+                                preferences.edit { putBoolean("enable_event_watch_log", checked) }
+                                refresh()
+                            },
+                            onTagFilterModeChanged = { mode -> LogManager.setTagFilterMode(requireContext(), mode); refresh() },
+                            onSelectedTagsChanged = { tags -> LogManager.setSelectedTags(requireContext(), tags.toSet()); refresh() },
+                            onAddCustomTag = { tag -> LogManager.addCustomTag(requireContext(), tag); refresh() },
+                            onRemoveCustomTag = { tag -> LogManager.removeCustomTag(requireContext(), tag); refresh() },
+                            onManualTextFilterChanged = { text -> LogManager.setManualTextFilter(text) }, // no persistence, no refreshState needed
+                            allLogTagOptions = remember { LogManager.getAllKnownTags() },
                             onWineDebugChanged = { checked ->
                                 preferences.edit { putBoolean("enable_wine_debug", checked) }
                                 com.winlator.cmod.runtime.system.LogManager
@@ -206,6 +240,13 @@ class DebugFragment : Fragment() {
         debugState =
             DebugState(
                 appDebug = preferences.getBoolean("enable_app_debug", false),
+                exitReasonLog = preferences.getBoolean("enable_exit_reason_log", false),
+                crashLog = preferences.getBoolean("enable_crash_log", false),
+                eventWatchLog = preferences.getBoolean("enable_event_watch_log", false),
+                tagFilterMode = LogManager.getTagFilterMode(),
+                selectedTags = LogManager.getSelectedTags().toList(),
+                customTags = LogManager.getAllKnownTags().filterNot { it in GeneratedLogTags.TAGS },
+
                 wineDebug = preferences.getBoolean("enable_wine_debug", false),
                 wineChannels = channels,
                 wineClasses = classes,