feat: Add onboarding tour triggered after first patch (#611)

Author: MarcaDian

app/src/main/java/app/morphe/manager/MainActivity.kt

@@ -22,16 +22,15 @@ import app.morphe.manager.R
 import app.morphe.manager.domain.manager.PreferencesManager
 import app.morphe.manager.domain.repository.PatchBundleRepository
 import app.morphe.manager.ui.model.HomeAppItem
-import app.morphe.manager.ui.screen.home.Android11Dialog
-import app.morphe.manager.ui.screen.home.HomeDialogs
-import app.morphe.manager.ui.screen.home.ManagerUpdateDetailsDialog
-import app.morphe.manager.ui.screen.home.SectionsLayout
+import app.morphe.manager.ui.screen.home.*
 import app.morphe.manager.ui.screen.settings.system.PrePatchInstallerDialog
 import app.morphe.manager.ui.viewmodel.HomeAndPatcherMessages
 import app.morphe.manager.ui.viewmodel.HomeViewModel
 import app.morphe.manager.ui.viewmodel.QuickPatchParams
 import app.morphe.manager.ui.viewmodel.UpdateViewModel
 import app.morphe.manager.util.*
+import kotlinx.coroutines.delay
+import kotlinx.coroutines.launch
 import org.koin.androidx.compose.koinViewModel
 import org.koin.compose.koinInject
 import org.koin.core.parameter.parametersOf
@@ -49,11 +48,14 @@ fun HomeScreen(
     prefs: PreferencesManager = koinInject(),
     usingMountInstallState: MutableState<Boolean>,
     bundleUpdateProgress: PatchBundleRepository.BundleUpdateProgress?,
+    onboardingState: OnboardingState? = null,
+    globalOnboardingState: GlobalOnboardingState? = null,
     patchTriggerPackage: String? = null,
     onPatchTriggerHandled: () -> Unit = {}
 ) {
     val context = LocalContext.current
     val view = LocalView.current
+    val scope = rememberCoroutineScope()
 
     // Dialog states
     val showUpdateDetailsDialog = remember { mutableStateOf(false) }
@@ -168,7 +170,8 @@ fun HomeScreen(
         homeViewModel = homeViewModel,
         storagePickerLauncher = { openApkPicker() },
         openBundlePicker = { openBundlePicker() },
-        patchesItem = patchesSheetItem
+        patchesItem = patchesSheetItem,
+        globalOnboardingState = globalOnboardingState
     )
 
     // Pre-patching installer selection dialog for root-capable devices.
@@ -223,7 +226,15 @@ fun HomeScreen(
                 onUnhideApp = { packageName -> homeViewModel.unhideApp(packageName) },
                 onShowPatches = { item -> patchesSheetItem.value = item },
                 showGestureHint = showGestureHint,
-                onGestureHintShown = { homeViewModel.markSwipeGestureHintShown() },
+                onGestureHintShown = {
+                    homeViewModel.markSwipeGestureHintShown()
+                    if (onboardingState != null && onboardingState.swipeActive) {
+                        scope.launch {
+                            delay(600)
+                            if (onboardingState.swipeActive) homeViewModel.triggerSwipeGestureHint()
+                        }
+                    }
+                },
                 hiddenAppItems = hiddenAppItems,
                 installedAppsLoading = bundlePipelineLoading || homeViewModel.installedAppsLoading,
 
@@ -248,7 +259,10 @@ fun HomeScreen(
                 onSettingsClick = onSettingsClick,
 
                 // Expert mode
-                isExpertModeEnabled = useExpertMode
+                isExpertModeEnabled = useExpertMode,
+
+                // Onboarding
+                onboardingState = onboardingState
             )
         }
     }

app/src/main/java/app/morphe/manager/ui/screen/HomeScreen.kt

@@ -19,18 +19,17 @@ import androidx.compose.animation.core.animateFloatAsState
 import androidx.compose.animation.core.tween
 import androidx.compose.foundation.layout.Column
 import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.statusBarsPadding
-import androidx.compose.material3.AlertDialog
-import androidx.compose.material3.ExperimentalMaterial3Api
-import androidx.compose.material3.Text
-import androidx.compose.material3.TextButton
+import androidx.compose.material3.*
 import androidx.compose.runtime.*
 import androidx.compose.runtime.livedata.observeAsState
 import androidx.compose.runtime.saveable.rememberSaveable
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.platform.LocalView
 import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.text.style.TextAlign
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import app.morphe.manager.R
 import app.morphe.manager.domain.installer.InstallerManager
@@ -41,7 +40,10 @@ import app.morphe.manager.ui.screen.patcher.*
 import app.morphe.manager.ui.screen.patcher.game.MiniGameState
 import app.morphe.manager.ui.screen.settings.advanced.NotificationPermissionDialog
 import app.morphe.manager.ui.screen.settings.system.InstallerSelectionDialog
+import app.morphe.manager.ui.screen.shared.LocalDialogSecondaryTextColor
 import app.morphe.manager.ui.screen.shared.MorpheAnimations
+import app.morphe.manager.ui.screen.shared.MorpheDialog
+import app.morphe.manager.ui.screen.shared.MorpheDialogButtonRow
 import app.morphe.manager.ui.viewmodel.InstallViewModel
 import app.morphe.manager.ui.viewmodel.PatcherViewModel
 import app.morphe.manager.util.APK_MIMETYPE
@@ -72,7 +74,9 @@ fun PatcherScreen(
     installViewModel: InstallViewModel = koinViewModel(),
     prefs: PreferencesManager = koinInject(),
     onBackgroundSpeedChange: (Float) -> Unit = {},
-    onPatchingCompleted: () -> Unit = {}
+    onPatchingCompleted: () -> Unit = {},
+    onStartTour: () -> Unit = {},
+    onDeclineTour: () -> Unit = {}
 ) {
     val context = LocalContext.current
     val view = LocalView.current
@@ -281,10 +285,11 @@ fun PatcherScreen(
     val errorMessage by remember { derivedStateOf { (installViewModel.installState as? InstallViewModel.InstallState.Error)?.message } }
 
     val showInstalledSourceConflictDialog = remember { mutableStateOf(false) }
+    val shouldPromptTour by patcherViewModel.shouldPromptTour.collectAsStateWithLifecycle()
 
     LaunchedEffect(installState) {
         if (installState is InstallViewModel.InstallState.Installed) {
-            patcherViewModel.triggerNotificationPromptIfNeeded()
+            patcherViewModel.triggerPostInstallPromptsIfNeeded()
         }
         if (installState is InstallViewModel.InstallState.Conflict && autoHandleConflict) {
             showInstalledSourceConflictDialog.value = true
@@ -325,6 +330,41 @@ fun PatcherScreen(
         )
     }
 
+    // Tour prompt dialog shown after first successful install
+    if (shouldPromptTour) {
+        MorpheDialog(
+            onDismissRequest = {
+                patcherViewModel.consumeTourPrompt()
+                onDeclineTour()
+            },
+            title = stringResource(R.string.tour_prompt_title),
+            footer = {
+                MorpheDialogButtonRow(
+                    primaryText = stringResource(R.string.tour_prompt_confirm),
+                    onPrimaryClick = {
+                        patcherViewModel.consumeTourPrompt()
+                        onStartTour()
+                        onBackClick()
+                    },
+                    secondaryText = stringResource(R.string.skip),
+                    onSecondaryClick = {
+                        patcherViewModel.consumeTourPrompt()
+                        onDeclineTour()
+                        onBackClick()
+                    }
+                )
+            }
+        ) {
+            Text(
+                text = stringResource(R.string.tour_prompt_desc),
+                style = MaterialTheme.typography.bodyLarge,
+                color = LocalDialogSecondaryTextColor.current,
+                textAlign = TextAlign.Center,
+                modifier = Modifier.fillMaxWidth()
+            )
+        }
+    }
+
     // Activity launcher for handling plugin activities or external installs
     val activityLauncher = rememberLauncherForActivityResult(
         contract = ActivityResultContracts.StartActivityForResult(),