feat(new study screen): browse command/menu action

it improves the ecosystem compatibility.

It also reduces any kind of complaints related to the new study screen not using a navigation drawer like the old one did

Author: BrayanDSO

AnkiDroid/src/main/java/com/ichi2/anki/preferences/ControlsSettingsFragment.kt

@@ -136,6 +136,13 @@ class ControlsSettingsFragment :
             val key = getString(keyRes)
             findPreference<Preference>(key)?.isVisible = false
         }
+        requirePreference<ControlPreference>(R.string.browse_command_key).apply {
+            title = TR.qtMiscBrowse()
+            isVisible = true
+            if (value == null) {
+                value = ViewerAction.BROWSE.getBindings(sharedPrefs()).toPreferenceString()
+            }
+        }
         requirePreference<ControlPreference>(R.string.statistics_command_key).apply {
             title = TR.statisticsTitle()
             isVisible = true

AnkiDroid/src/main/java/com/ichi2/anki/preferences/reviewer/ViewerAction.kt

@@ -64,6 +64,7 @@ enum class ViewerAction(
     DELETE(R.id.action_delete, R.drawable.ic_delete_white, R.string.menu_delete_note, MENU_ONLY),
 
     // Disabled
+    BROWSE(R.id.action_browse, R.drawable.ic_flashcard_black, R.string.empty_string, DISABLED),
     STATISTICS(R.id.action_statistics, R.drawable.ic_bar_chart_black, R.string.empty_string, DISABLED),
     DECK_OPTIONS(R.id.action_deck_options, R.drawable.ic_tune_white, R.string.menu__deck_options, DISABLED),
     CARD_INFO(R.id.action_card_info, R.drawable.ic_dialog_info, R.string.card_info_title, DISABLED),
@@ -138,6 +139,7 @@ enum class ViewerAction(
             SHOW_ALL_HINTS -> listOf(keycode(KeyEvent.KEYCODE_G))
             RECORD_VOICE -> listOf(keycode(KeyEvent.KEYCODE_V, shift()))
             REPLAY_VOICE -> listOf(keycode(KeyEvent.KEYCODE_V))
+            BROWSE -> listOf(keycode(KeyEvent.KEYCODE_B))
             STATISTICS -> listOf(keycode(KeyEvent.KEYCODE_T))
             TOGGLE_FLAG_RED ->
                 listOf(
@@ -239,6 +241,7 @@ enum class ViewerAction(
 
     fun title(context: Context): String =
         when (this) {
+            BROWSE -> TR.qtMiscBrowse()
             STATISTICS -> TR.statisticsTitle()
             RESCHEDULE_NOTE -> TR.actionsSetDueDate().toSentenceCase(context, R.string.sentence_set_due_date)
             else -> context.getString(titleRes)

AnkiDroid/src/main/java/com/ichi2/anki/ui/windows/reviewer/ReviewerViewModel.kt

@@ -26,6 +26,7 @@ import com.ichi2.anki.CollectionManager.withCol
 import com.ichi2.anki.Flag
 import com.ichi2.anki.Reviewer
 import com.ichi2.anki.asyncIO
+import com.ichi2.anki.browser.BrowserDestination
 import com.ichi2.anki.common.time.TimeManager
 import com.ichi2.anki.launchCatchingIO
 import com.ichi2.anki.libanki.Card
@@ -255,6 +256,13 @@ class ReviewerViewModel :
         destinationFlow.emit(destination)
     }
 
+    private suspend fun emitBrowseDestination() {
+        val deckId = withCol { decks.getCurrentId() }
+        val destination = BrowserDestination(deckId)
+        Timber.i("Launching 'browse options' for deck %d", deckId)
+        destinationFlow.emit(destination)
+    }
+
     private suspend fun deleteNote() {
         val cardId = currentCard.await().id
         val noteCount =
@@ -674,6 +682,7 @@ class ReviewerViewModel :
                 ViewerAction.SUSPEND_MENU -> suspendCard()
                 ViewerAction.BURY_MENU -> buryCard()
                 ViewerAction.STATISTICS -> destinationFlow.emit(StatisticsDestination())
+                ViewerAction.BROWSE -> emitBrowseDestination()
                 ViewerAction.FLAG_MENU -> {}
             }
         }

AnkiDroid/src/main/res/values/ids.xml

@@ -41,6 +41,7 @@
     <item type="id" name="action_toggle_auto_advance"/>
     <item type="id" name="action_record_voice"/>
     <item type="id" name="action_set_due_date"/>
+    <item type="id" name="action_browse"/>
     <item type="id" name="action_statistics"/>
 
     <item type="id" name="user_action_1"/>

AnkiDroid/src/main/res/values/preferences.xml

@@ -122,6 +122,7 @@
     <string name="remove_flag_command_key">binding_UNSET_FLAG</string>
     <string name="page_up_command_key">binding_PAGE_UP</string>
     <string name="page_down_command_key">binding_PAGE_DOWN</string>
+    <string name="browse_command_key">binding_BROWSE</string>
     <string name="statistics_command_key">binding_STATISTICS</string>
     <string name="tag_command_key">binding_TAG</string>
     <string name="card_info_command_key">binding_CARD_INFO</string>

AnkiDroid/src/main/res/xml/preferences_reviewer_controls.xml

@@ -148,6 +148,12 @@
             android:title="@string/gesture_page_down"
             android:icon="@drawable/ic_double_arrow_down"
             />
+        <com.ichi2.preferences.ReviewerControlPreference
+            android:key="@string/browse_command_key"
+            android:icon="@drawable/ic_flashcard_black"
+            app:isPreferenceVisible="false"
+            tools:title="Browse"
+            />
         <com.ichi2.preferences.ReviewerControlPreference
             android:key="@string/statistics_command_key"
             android:icon="@drawable/ic_bar_chart_black"