Implemention of Deck Picker Widget !Add Deck Picker Widget to display…

… deck statistics

This commit introduces the Deck Picker Widget, which displays a list of decks along with the number of cards that are new, in learning, and due for review. It is a display-only widget.

Features:
- Displays deck names and statistics (new, learning, and review counts).
- Retrieves selected decks from shared preferences.
- Can be reconfigured by holding the widget.

This widget provides users with a quick overview of their decks without needing to open the app.

AnkiDroid/src/main/AndroidManifest.xml

@@ -520,6 +520,33 @@
                 />
         </receiver>
 
+        <!-- A widget that displays a few decks's name and number of cards to review on the Android home screen.
+             The way to add it depends on the phone. It usually consists in a long press on the screen, followed by finding a "widget" button"-->
+        <receiver
+            android:name="com.ichi2.widget.DeckPickerWidget"
+            android:label="@string/deck_picker_widget_description"
+            android:exported="false"
+            >
+            <intent-filter>
+                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+            </intent-filter>
+
+            <meta-data
+                android:name="android.appwidget.provider"
+                android:resource="@xml/widget_provider_deck_picker" />
+        </receiver>
+
+        <!-- Configuration view for the DeckPickerWidget above.
+             It is opened when adding a new deck picker widget and
+             by configuration button which appears when the widget is hold or resized.-->
+        <activity
+            android:name="com.ichi2.widget.DeckPickerWidgetConfig"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE" />
+            </intent-filter>
+        </activity>
+
         <receiver android:name="com.ichi2.widget.WidgetPermissionReceiver"
             android:exported="true">
             <intent-filter>

AnkiDroid/src/main/java/com/ichi2/anki/snackbar/Snackbars.kt

@@ -70,10 +70,11 @@ interface BaseSnackbarBuilderProvider {
 fun Activity.showSnackbar(
     @StringRes textResource: Int,
     duration: Int = Snackbar.LENGTH_LONG,
+    anchorView: View? = null,
     snackbarBuilder: SnackbarBuilder? = null
 ) {
     val text = getText(textResource)
-    showSnackbar(text, duration, snackbarBuilder)
+    showSnackbar(text, duration, anchorView, snackbarBuilder)
 }
 
 /**
@@ -104,13 +105,14 @@ fun Activity.showSnackbar(
 fun Activity.showSnackbar(
     text: CharSequence,
     duration: Int = Snackbar.LENGTH_LONG,
+    anchorView: View? = null,
     snackbarBuilder: SnackbarBuilder? = null
 ) {
     val view: View? = findViewById(R.id.root_layout) as? CoordinatorLayout
 
     if (view != null) {
         val baseSnackbarBuilder = (this as? BaseSnackbarBuilderProvider)?.baseSnackbarBuilder
-        view.showSnackbar(text, duration) {
+        view.showSnackbar(text, duration, anchorView = anchorView) {
             baseSnackbarBuilder?.invoke(this)
             snackbarBuilder?.invoke(this)
             Timber.d("displayed snackbar: '%s'", text)
@@ -157,10 +159,11 @@ fun Activity.showSnackbar(
 fun View.showSnackbar(
     @StringRes textResource: Int,
     duration: Int = Snackbar.LENGTH_LONG,
+    anchorView: View? = null,
     snackbarBuilder: SnackbarBuilder? = null
 ) {
     val text = resources.getText(textResource)
-    showSnackbar(text, duration, snackbarBuilder)
+    showSnackbar(text, duration, anchorView, snackbarBuilder)
 }
 
 /**
@@ -192,19 +195,24 @@ fun View.showSnackbar(
 fun View.showSnackbar(
     text: CharSequence,
     duration: Int = Snackbar.LENGTH_LONG,
+    anchorView: View? = null,
     snackbarBuilder: SnackbarBuilder? = null
 ) {
-    val snackbar = Snackbar.make(this, text, duration)
-    snackbar.setMaxLines(4)
-    snackbar.behavior = SwipeDismissBehaviorFix()
+    Snackbar.make(this, text, duration).apply {
+        this.anchorView = anchorView
+        setMaxLines(4)
+        behavior = SwipeDismissBehaviorFix()
 
-    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
-        snackbar.fixMarginsWhenInsetsChange()
-    }
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            fixMarginsWhenInsetsChange()
+        }
 
-    if (snackbarBuilder != null) { snackbar.snackbarBuilder() }
+        if (snackbarBuilder != null) {
+            snackbarBuilder()
+        }
 
-    snackbar.show()
+        show()
+    }
 }
 
 /**
@@ -236,10 +244,11 @@ fun View.showSnackbar(
 fun Fragment.showSnackbar(
     text: CharSequence,
     duration: Int = Snackbar.LENGTH_LONG,
+    anchorView: View? = null,
     snackbarBuilder: SnackbarBuilder? = null
 ) {
     val baseSnackbarBuilder = (this as? BaseSnackbarBuilderProvider)?.baseSnackbarBuilder
-    requireActivity().showSnackbar(text, duration) {
+    requireActivity().showSnackbar(text, duration, anchorView = anchorView) {
         baseSnackbarBuilder?.invoke(this)
         snackbarBuilder?.invoke(this)
         Timber.d("displayed snackbar: '%s'", text)
@@ -275,10 +284,11 @@ fun Fragment.showSnackbar(
 fun Fragment.showSnackbar(
     @StringRes textResource: Int,
     duration: Int = Snackbar.LENGTH_LONG,
+    anchorView: View? = null,
     snackbarBuilder: SnackbarBuilder? = null
 ) {
     val text = resources.getText(textResource)
-    showSnackbar(text, duration, snackbarBuilder)
+    showSnackbar(text, duration, anchorView, snackbarBuilder)
 }
 
 /* ********************************************************************************************** */