Fixes part of #5345: Implementing Force downloading . (#5949)

Fixes part of #5345 : 
This pull request adds a new "Force Download" feature to the developer
options, allowing developers to manually trigger a download of remote
platform parameters and feature flags, and restart the app to apply
changes. The implementation includes new UI elements, dialog fragments,
presenter logic, and integration with existing controllers and activity
lifecycle.
The actual downloading implementation of platform parameter is not yet
done, and will be done in future. This PR just wires the UI with the
controller which can be verified by logs.

**Feature Addition: Force Download Functionality**
* Added a new `ForceDownloadsButtonClickListener` interface and
integrated it into `DeveloperOptionsActivity`, enabling handling of
force download button clicks.
* Implemented `ForceDownloadDialogFragment` and its presenter to show a
dialog for force downloading parameters, with options to restart the app
or cancel.
* Updated `DeveloperOptionsActivityPresenter` to handle force download
requests and perform a full app restart if needed.

**UI Enhancements**
* Updated `developer_options_override_app_behaviors_view.xml` to add a
force download button, divider, and related layout changes for improved
organization and visibility.
* Bound the button's enabled state to a new LiveData property in the
view model, reflecting whether force download is currently available

**Integration with ViewModels and Controllers**
* Extended `DeveloperOptionsViewModel` and
`DeveloperOptionsOverrideAppBehaviorsViewModel` to support force
download logic and button state, integrating with
`ForceDownloadParametersController`.
* Registered new listener and fragment for dependency injection and
activity lifecycle management.

**Verification via logs**
The downloading behaviour can be verified using the logs:
- When download starts it logs: "Calling Force Download of remote
parameters".
- When download completes successfully: "Download finished
successfully."
- When we cancel download before being finished: "Cancelled ongoing
remote parameter download"
- All the logs can be verified using the TAG :
```
PlatformParameterController
```

### Screenshot
<img width="400" height="1000" alt="image"
src="https://github.com/user-attachments/assets/3a74a3a5-d414-4efd-8a2b-3723c8041d96"
/>

 
## Essential Checklist
<!-- Please tick the relevant boxes by putting an "x" in them. -->
- [x] The PR title and explanation each start with "Fix #bugnum: " (If
this PR fixes part of an issue, prefix the title with "Fix part of
#bugnum: ...".)
- [x] Any changes to
[scripts/assets](https://github.com/oppia/oppia-android/tree/develop/scripts/assets)
files have their rationale included in the PR explanation.
- [x] The PR follows the [style
guide](https://github.com/oppia/oppia-android/wiki/Coding-style-guide).
- [x] The PR does not contain any unnecessary code changes from Android
Studio
([reference](https://github.com/oppia/oppia-android/wiki/Guidance-on-submitting-a-PR#undo-unnecessary-changes)).
- [x] The PR is made from a branch that's **not** called "develop" and
is up-to-date with "develop".
- [x] The PR is **assigned** to the appropriate reviewers
([reference](https://github.com/oppia/oppia-android/wiki/Guidance-on-submitting-a-PR#clarification-regarding-assignees-and-reviewers-section)).

---------

Co-authored-by: theayushyadav11 <[email protected]>
Co-authored-by: Manas <[email protected]>
Co-authored-by: Adhiambo Peres <[email protected]>
Co-authored-by: RD Rama Devi <[email protected]>

Author: 5 people

app/BUILD.bazel

@@ -81,7 +81,9 @@ LISTENERS = [
     "src/main/java/org/oppia/android/app/administratorcontrols/RouteToLearnerAnalyticsListener.kt",
     "src/main/java/org/oppia/android/app/administratorcontrols/RouteToProfileListListener.kt",
     "src/main/java/org/oppia/android/app/administratorcontrols/ShowLogoutDialogListener.kt",
+    "src/main/java/org/oppia/android/app/devoptions/AppRestartListener.kt",
     "src/main/java/org/oppia/android/app/devoptions/ForceCrashButtonClickListener.kt",
+    "src/main/java/org/oppia/android/app/devoptions/ForceDownloadRemoteParametersButtonClickListener.kt",
     "src/main/java/org/oppia/android/app/devoptions/RouteToFeatureFlagsListener.kt",
     "src/main/java/org/oppia/android/app/devoptions/RouteToForceNetworkTypeListener.kt",
     "src/main/java/org/oppia/android/app/devoptions/RouteToMarkChaptersCompletedListener.kt",

app/src/main/java/org/oppia/android/app/devoptions/AppRestartListener.kt

@@ -0,0 +1,7 @@
+package org.oppia.android.app.devoptions
+
+/** Listener interface for handling application restart requests. */
+interface AppRestartListener {
+  /** Triggers a restart of the application. */
+  fun restartApp()
+}

app/src/main/java/org/oppia/android/app/devoptions/DeveloperOptionsActivity.kt

@@ -26,14 +26,16 @@ import javax.inject.Inject
 class DeveloperOptionsActivity :
   InjectableAutoLocalizedAppCompatActivity(),
   ForceCrashButtonClickListener,
+  ForceDownloadRemoteParametersButtonClickListener,
   RouteToMarkChaptersCompletedListener,
   RouteToMarkStoriesCompletedListener,
   RouteToMarkTopicsCompletedListener,
   RouteToViewEventLogsListener,
   RouteToForceNetworkTypeListener,
   RouteToMathExpressionParserTestListener,
   RouteToFeatureFlagsListener,
-  RouteToPlatformParametersListener {
+  RouteToPlatformParametersListener,
+  AppRestartListener {
 
   @Inject
   lateinit var developerOptionsActivityPresenter: DeveloperOptionsActivityPresenter
@@ -112,4 +114,12 @@ class DeveloperOptionsActivity :
   override fun forceCrash() {
     developerOptionsActivityPresenter.forceCrash()
   }
+
+  override fun forceDownloadRemoteParameters() {
+    developerOptionsActivityPresenter.forceDownloadRemoteParameters()
+  }
+
+  override fun restartApp() {
+    developerOptionsActivityPresenter.restartApp()
+  }
 }

app/src/main/java/org/oppia/android/app/devoptions/DeveloperOptionsActivityPresenter.kt

@@ -1,12 +1,18 @@
 package org.oppia.android.app.devoptions
 
+import android.content.Intent
 import androidx.appcompat.app.AppCompatActivity
 import androidx.databinding.DataBindingUtil
 import org.oppia.android.app.activity.ActivityScope
 import org.oppia.android.app.databinding.databinding.DeveloperOptionsActivityBinding
 import org.oppia.android.app.drawer.NavigationDrawerFragment
+import org.oppia.android.app.splash.SplashActivity
 import org.oppia.android.app.ui.R
 import javax.inject.Inject
+import kotlin.system.exitProcess
+
+/** Tag for displaying [ForceDownloadRemoteParametersDialogFragment]. */
+const val TAG_FORCE_DOWNLOAD_DIALOG = "FORCE_DOWNLOAD_DIALOG_TAG"
 
 /** The presenter for [DeveloperOptionsActivity]. */
 @ActivityScope
@@ -58,4 +64,23 @@ class DeveloperOptionsActivityPresenter @Inject constructor(
   fun forceCrash(): Nothing {
     throw RuntimeException("Force crash occurred")
   }
+
+  /** Opens a dialog to force download remote parameters. */
+  fun forceDownloadRemoteParameters() {
+    val dialog = ForceDownloadRemoteParametersDialogFragment.newInstance()
+    dialog.showNow(activity.supportFragmentManager, TAG_FORCE_DOWNLOAD_DIALOG)
+  }
+
+  /** Called when restart is triggered by [ForceDownloadRemoteParametersDialogFragment]. */
+  fun restartApp() {
+    val intent = Intent(activity, SplashActivity::class.java).also {
+      it.action = Intent.ACTION_MAIN
+      it.addCategory(Intent.CATEGORY_LAUNCHER)
+    }
+    activity.finishAffinity()
+    activity.startActivity(intent)
+    // App is terminated to ensure a fresh restart and kill all the current process
+    // so that ProcessState can be reinitialised on the fresh restart.
+    exitProcess(0)
+  }
 }

app/src/main/java/org/oppia/android/app/devoptions/DeveloperOptionsViewModel.kt

@@ -21,6 +21,8 @@ class DeveloperOptionsViewModel @Inject constructor(
   private val showAllHintsAndSolutionController: ShowAllHintsAndSolutionController
 ) {
   private val forceCrashButtonClickListener = activity as ForceCrashButtonClickListener
+  private val forceDownloadRemoteParametersButtonClickListener =
+    activity as ForceDownloadRemoteParametersButtonClickListener
   private val routeToMarkChaptersCompletedListener =
     activity as RouteToMarkChaptersCompletedListener
   private val routeToMarkStoriesCompletedListener =
@@ -52,6 +54,7 @@ class DeveloperOptionsViewModel @Inject constructor(
       DeveloperOptionsViewLogsViewModel(routeToViewEventLogsListener),
       DeveloperOptionsOverrideAppBehaviorsViewModel(
         forceCrashButtonClickListener,
+        forceDownloadRemoteParametersButtonClickListener,
         routeToForceNetworkTypeListener,
         showAllHintsAndSolutionController,
         routeToFeatureFlagsListener,

app/src/main/java/org/oppia/android/app/devoptions/ForceDownloadRemoteParametersButtonClickListener.kt

@@ -0,0 +1,8 @@
+package org.oppia.android.app.devoptions
+
+/** Listener for handling clicks on the force download button. */
+interface ForceDownloadRemoteParametersButtonClickListener {
+
+  /** Listener for handling clicks on the force download remote parameters button. */
+  fun forceDownloadRemoteParameters()
+}

app/src/main/java/org/oppia/android/app/devoptions/ForceDownloadRemoteParametersDialogFragment.kt

@@ -0,0 +1,30 @@
+package org.oppia.android.app.devoptions
+
+import android.app.Dialog
+import android.content.Context
+import android.os.Bundle
+import org.oppia.android.app.fragment.FragmentComponentImpl
+import org.oppia.android.app.fragment.InjectableDialogFragment
+import javax.inject.Inject
+
+/** Dialog fragment shown for force downloading remote parameters. */
+class ForceDownloadRemoteParametersDialogFragment : InjectableDialogFragment() {
+  @Inject
+  lateinit var forceDownloadRemoteParametersDialogFragmentPresenter:
+    ForceDownloadRemoteParametersDialogFragmentPresenter
+
+  companion object {
+    /** Returns a new instance of [ForceDownloadRemoteParametersDialogFragment]. */
+    fun newInstance(): ForceDownloadRemoteParametersDialogFragment =
+      ForceDownloadRemoteParametersDialogFragment()
+  }
+
+  override fun onAttach(context: Context) {
+    super.onAttach(context)
+    (fragmentComponent as FragmentComponentImpl).inject(this)
+  }
+
+  override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
+    return forceDownloadRemoteParametersDialogFragmentPresenter.handleOnCreateDialog()
+  }
+}

app/src/main/java/org/oppia/android/app/devoptions/ForceDownloadRemoteParametersDialogFragmentPresenter.kt

@@ -0,0 +1,84 @@
+package org.oppia.android.app.devoptions
+
+import android.app.AlertDialog
+import android.app.Dialog
+import android.view.View
+import androidx.appcompat.app.AppCompatActivity
+import androidx.core.content.ContextCompat
+import androidx.fragment.app.Fragment
+import org.oppia.android.app.databinding.databinding.ForceDownloadRemoteParametersDialogFragmentBinding
+import org.oppia.android.app.translation.AppLanguageResourceHandler
+import org.oppia.android.app.ui.R
+import org.oppia.android.domain.devoptions.ForceDownloadRemoteParametersController
+import org.oppia.android.domain.oppialogger.OppiaLogger
+import org.oppia.android.util.data.AsyncResult
+import org.oppia.android.util.data.DataProviders.Companion.toLiveData
+import javax.inject.Inject
+
+/** Presenter for the [ForceDownloadRemoteParametersDialogFragment]. */
+class ForceDownloadRemoteParametersDialogFragmentPresenter @Inject constructor(
+  private val fragment: Fragment,
+  private val activity: AppCompatActivity,
+  private val oppiaLogger: OppiaLogger,
+  private val resourceHandler: AppLanguageResourceHandler,
+  private val forceDownloadRemoteParametersParametersController:
+    ForceDownloadRemoteParametersController
+) {
+  /**
+   *  Creates a dialog to display the status of the ongoing remote parameters download and then
+   *  restart.
+   */
+  fun handleOnCreateDialog(): Dialog {
+    val binding = ForceDownloadRemoteParametersDialogFragmentBinding.inflate(
+      activity.layoutInflater,
+      /* parent= */ null,
+      /* attachToRoot= */ false
+    )
+    binding.lifecycleOwner = fragment
+    val appRestartInterface = activity as AppRestartListener
+
+    forceDownloadRemoteParametersParametersController
+      .downloadRemoteParameters().toLiveData().observe(fragment) {
+        if (it is AsyncResult.Success) {
+          oppiaLogger.d(
+            "ForceDownloadRemoteParametersDialog",
+            "Remote parameters downloaded successfully."
+          )
+          handleDownloadComplete(binding)
+        }
+      }
+
+    val dialog = AlertDialog.Builder(activity, R.style.OppiaAlertDialogTheme)
+      .setView(binding.root)
+      .create()
+    dialog.setCanceledOnTouchOutside(false)
+
+    binding.restartButton.setOnClickListener {
+      appRestartInterface.restartApp()
+      dialog.dismiss()
+    }
+
+    binding.cancelButton.setOnClickListener {
+      forceDownloadRemoteParametersParametersController.cancelRemoteParameterDownload()
+      dialog.dismiss()
+    }
+    return dialog
+  }
+
+  private fun handleDownloadComplete(binding: ForceDownloadRemoteParametersDialogFragmentBinding) {
+    binding.cancelButton.visibility = View.GONE
+    binding.forceDownloadMessage.text = resourceHandler
+      .getStringInLocale(R.string.force_download_dialog_successfully_downloaded_message_text)
+    binding.forceDownloadRestartMessage.visibility = View.VISIBLE
+    binding.restartButton.apply {
+      isEnabled = true
+      setTextColor(
+        ContextCompat.getColor(
+          fragment.requireContext(),
+          R.color.component_color_shared_secondary_4_text_color
+        )
+      )
+      setBackgroundResource(R.drawable.state_button_primary_background)
+    }
+  }
+}

app/src/main/java/org/oppia/android/app/devoptions/devoptionsitemviewmodel/DeveloperOptionsOverrideAppBehaviorsViewModel.kt

@@ -2,6 +2,7 @@ package org.oppia.android.app.devoptions.devoptionsitemviewmodel
 
 import androidx.databinding.ObservableField
 import org.oppia.android.app.devoptions.ForceCrashButtonClickListener
+import org.oppia.android.app.devoptions.ForceDownloadRemoteParametersButtonClickListener
 import org.oppia.android.app.devoptions.RouteToFeatureFlagsListener
 import org.oppia.android.app.devoptions.RouteToForceNetworkTypeListener
 import org.oppia.android.app.devoptions.RouteToPlatformParametersListener
@@ -13,6 +14,8 @@ import org.oppia.android.domain.devoptions.ShowAllHintsAndSolutionController
  */
 class DeveloperOptionsOverrideAppBehaviorsViewModel(
   private val forceCrashButtonClickListener: ForceCrashButtonClickListener,
+  private val forceDownloadRemoteParametersButtonClickListener:
+    ForceDownloadRemoteParametersButtonClickListener,
   private val forceNetworkTypeListener: RouteToForceNetworkTypeListener,
   private val showAllHintsAndSolutionController: ShowAllHintsAndSolutionController,
   private val featureFlagsListener: RouteToFeatureFlagsListener,
@@ -43,6 +46,14 @@ class DeveloperOptionsOverrideAppBehaviorsViewModel(
     platformParametersListener.routeToPlatformParameters()
   }
 
+  /**
+   * Initiates a request to download the remote parameters from the web server when the download
+   * button is clicked.
+   */
+  fun onForceDownloadRemoteParametersButtonClicked() {
+    forceDownloadRemoteParametersButtonClickListener.forceDownloadRemoteParameters()
+  }
+
   /**
    * Called when the state of 'show all hints/solution' switch is changed by the user.
    * Enables or disables the feature to show all hints and solution.

app/src/main/java/org/oppia/android/app/devoptions/featureflags/FeatureFlagItemViewModel.kt

@@ -58,6 +58,7 @@ class FeatureFlagItemViewModel(
       SyncStatus.LOCAL_OVERRIDE ->
         resourceHandler.getStringInLocale(R.string.platform_parameter_currently_overridden_message)
       SyncStatus.SYNCED_FROM_SERVER ->
+        // TODO(#5951): Replace this placeholder message with the actual server last-synced timestamps.
         resourceHandler.getStringInLocale(R.string.platform_parameter_synced_from_server_message)
       else ->
         resourceHandler.getStringInLocale(R.string.platform_parameter_never_synced_message)