add warning message for advanced shortcut

Author: SliDeeN

README.md

@@ -78,16 +78,17 @@ L'application communique avec le véhicule via le SDK propriétaire SAIC, en acc
 - **SWI69 / SWI131** : Anti-collision avant (AEB) — On / Off + mode Alerte uniquement / Alerte + Freinage
 - **SWI165** : Désactiver / ACC / TJA + Anti-collision avant (AEB) On/Off + mode Alerte / Alerte+Freinage + avertissement sonore
 
-### Raccourcis volant
+### Raccourcis sur boutons physiques
 
 Deux systèmes coexistent, réglés dans le même écran :
 
 - **Raccourcis classiques** — boutons ★ gauche et droit, en appui simple ou long. Ils reposent sur
   le broadcast émis par le véhicule : si le launcher officiel utilise déjà le bouton, il reste
   prioritaire.
-- **Raccourcis avancés** — n'importe quelle touche du volant, en appui **court, long ou double**,
-  via un **service d'accessibilité** que l'utilisateur active lui-même dans Android. MG4Control
-  voit alors la touche **avant** le launcher et peut la consommer.
+- **Raccourcis avancés** — n'importe quelle touche physique, au volant **comme sur la façade
+  sous l'écran**, en appui **court, long ou double**, via un **service d'accessibilité** que
+  l'utilisateur active lui-même dans Android. MG4Control voit alors la touche **avant** le
+  launcher et peut la consommer.
 
 L'appui long part **dès le seuil de 500 ms atteint**, sans attendre le relâchement : l'action se
 déclenche toujours au même moment, la touche encore enfoncée. Le double appui, lui, a un coût à
@@ -782,15 +783,16 @@ The app communicates with the vehicle through the proprietary SAIC SDK, accessin
 - **SWI69 / SWI131**: Forward Collision Warning (AEB) — On / Off + mode Alert only / Alert + Emergency Braking
 - **SWI165**: Disable / ACC / TJA + Forward Collision Warning (AEB) On/Off + Alert / Alert+Braking mode + audible warning
 
-### Steering Wheel Shortcuts
+### Physical Button Shortcuts
 
 Two systems live side by side, configured from the same screen:
 
 - **Classic shortcuts** — the left and right ★ buttons, short or long press. They rely on the
   broadcast the vehicle emits: if the stock launcher already uses that button, the launcher wins.
-- **Advanced shortcuts** — any steering wheel key, as a **short, long or double** press, through
-  an **accessibility service** the user enables themselves in Android. MG4Control then sees the key
-  **before** the launcher and can consume it.
+- **Advanced shortcuts** — any physical key, on the steering wheel **as well as on the panel
+  below the screen**, as a **short, long or double** press, through an **accessibility service**
+  the user enables themselves in Android. MG4Control then sees the key **before** the launcher and
+  can consume it.
 
 A long press fires **as soon as the 500 ms threshold is reached**, without waiting for the release:
 the action always happens at the same moment, while the key is still held. A double press has a

app/src/main/java/com/mg4/control/ui/ShortcutsFragment.kt

@@ -256,10 +256,35 @@ class ShortcutsFragment : Fragment() {
             refreshAdvancedList(view)
         }
 
+        // ⚠️ L'état est posé AVANT l'écouteur : sinon l'avertissement d'activation ci-dessous
+        // s'afficherait à chaque ouverture de l'écran, sans que l'utilisateur ait rien demandé.
         sw.isChecked = AdvancedShortcuts.isEnabled(requireContext())
         sw.setOnCheckedChangeListener { _, checked ->
-            AdvancedShortcuts.setEnabled(requireContext(), checked)
-            majEtat()
+            // Désactivation : rien à expliquer, les touches sont rendues au système.
+            if (!checked) {
+                AdvancedShortcuts.setEnabled(requireContext(), false)
+                majEtat()
+                return@setOnCheckedChangeListener
+            }
+
+            // Activation : on prévient AVANT d'armer quoi que ce soit. Qu'un bouton du volant
+            // perde sa fonction d'origine ne se devine pas depuis un interrupteur, et se
+            // découvrirait au volant — c'est exactement ce qui est arrivé à un testeur avec la
+            // touche Accueil, qui a cru à un plantage.
+            //
+            // Rien n'est enregistré tant que l'utilisateur n'a pas confirmé : annuler, ou fermer
+            // la boîte de dialogue, remet l'interrupteur sur off — ce qui repasse par ce même
+            // écouteur avec `checked = false`, donc par la désactivation propre ci-dessus.
+            AlertDialog.Builder(requireContext())
+                .setTitle(R.string.adv_sc_enable_warn_title)
+                .setMessage(R.string.adv_sc_enable_warn_msg)
+                .setPositiveButton(R.string.adv_sc_enable_warn_ok) { _, _ ->
+                    AdvancedShortcuts.setEnabled(requireContext(), true)
+                    majEtat()
+                }
+                .setNegativeButton(android.R.string.cancel) { _, _ -> sw.isChecked = false }
+                .setOnCancelListener { _ -> sw.isChecked = false }
+                .show()
         }
 
         btnAcc.setOnClickListener {

app/src/main/res/values-de/strings.xml

@@ -458,4 +458,9 @@
     <string name="adv_sc_replace_msg">%1$s bei %2$s löst bereits aus: %3$s.\n\nDurch die neue Funktion ersetzen?</string>
     <string name="adv_sc_replace_ok">Ersetzen</string>
     <string name="adv_sc_press_double">Doppelter Druck</string>
+
+    <!-- Avertissement a l'activation des raccourcis avances -->
+    <string name="adv_sc_enable_warn_title">Belegte Taste ändert ihre Rolle</string>
+    <string name="adv_sc_enable_warn_msg">Eine belegte Taste verliert ihre ursprüngliche Funktion: MG4Control fängt die Taste vor dem Launcher ab, der sie gar nicht mehr sieht.\n\nBeispiel: Wird die Home-Taste belegt, führt sie nicht mehr zum MG-Launcher zurück. Um das wiederherzustellen, weisen Sie ihr die Aktion App starten zu und wählen Sie den Launcher.\n\nDie Taste wird komplett beansprucht: Wird nur der lange Druck belegt, sind auch kurzer und doppelter Druck wirkungslos.\n\nAlles wird wieder normal, sobald die Verknüpfung in der Kürzelliste gelöscht wird.</string>
+    <string name="adv_sc_enable_warn_ok">Aktivieren</string>
 </resources>

app/src/main/res/values-en/strings.xml

@@ -458,4 +458,9 @@
     <string name="adv_sc_replace_msg">%1$s on %2$s already runs: %3$s.\n\nReplace it with the new action?</string>
     <string name="adv_sc_replace_ok">Replace</string>
     <string name="adv_sc_press_double">Double press</string>
+
+    <!-- Avertissement a l'activation des raccourcis avances -->
+    <string name="adv_sc_enable_warn_title">Assigned buttons change role</string>
+    <string name="adv_sc_enable_warn_msg">A button assigned to an advanced shortcut loses its original function: MG4Control intercepts the key before the launcher, which no longer sees it at all.\n\nExample: assign the Home button and it no longer returns to the MG launcher. To get that back, give it the Launch an app action and pick the launcher.\n\nThe key is claimed as a whole: assigning only the long press also neutralises the short press and the double press.\n\nEverything returns to normal once the shortcut is deleted from Shortcut list.</string>
+    <string name="adv_sc_enable_warn_ok">Enable</string>
 </resources>

app/src/main/res/values-es/strings.xml

@@ -458,4 +458,9 @@
     <string name="adv_sc_replace_msg">%1$s en %2$s ya ejecuta: %3$s.\n\n¿Reemplazar por la nueva función?</string>
     <string name="adv_sc_replace_ok">Reemplazar</string>
     <string name="adv_sc_press_double">Doble pulsación</string>
+
+    <!-- Avertissement a l'activation des raccourcis avances -->
+    <string name="adv_sc_enable_warn_title">El botón asignado cambia de función</string>
+    <string name="adv_sc_enable_warn_msg">Un botón asignado a un atajo avanzado pierde su función original: MG4Control intercepta la tecla antes que el launcher, que ya no la recibe.\n\nEjemplo: si asigna el botón Inicio, dejará de volver al launcher de MG. Para recuperarlo, asígnele la acción « Iniciar una app » y elija el launcher.\n\nLa tecla se reserva por completo: asignar solo la pulsación larga anula también la corta y la doble.\n\nTodo vuelve a la normalidad al eliminar el atajo en « Lista de atajos ».</string>
+    <string name="adv_sc_enable_warn_ok">Activar</string>
 </resources>

app/src/main/res/values-it/strings.xml

@@ -458,4 +458,9 @@
     <string name="adv_sc_replace_msg">%1$s con %2$s esegue già: %3$s.\n\nSostituire con la nuova funzione?</string>
     <string name="adv_sc_replace_ok">Sostituisci</string>
     <string name="adv_sc_press_double">Doppia pressione</string>
+
+    <!-- Avertissement a l'activation des raccourcis avances -->
+    <string name="adv_sc_enable_warn_title">Il pulsante assegnato cambia ruolo</string>
+    <string name="adv_sc_enable_warn_msg">Un pulsante assegnato a una scorciatoia avanzata perde la sua funzione originale: MG4Control intercetta il tasto prima del launcher, che non lo riceve più.\n\nEsempio: se assegni il pulsante Home, non riporterà più al launcher MG. Per recuperarlo, assegnagli l\'azione « Avvia un\'app » e scegli il launcher.\n\nIl tasto è riservato per intero: assegnare solo la pressione lunga annulla anche quella breve e quella doppia.\n\nTutto torna normale eliminando la scorciatoia in « Elenco scorciatoie ».</string>
+    <string name="adv_sc_enable_warn_ok">Attiva</string>
 </resources>

app/src/main/res/values-pt/strings.xml

@@ -458,4 +458,9 @@
     <string name="adv_sc_replace_msg">%1$s em %2$s já executa: %3$s.\n\nSubstituir pela nova função?</string>
     <string name="adv_sc_replace_ok">Substituir</string>
     <string name="adv_sc_press_double">Pressão dupla</string>
+
+    <!-- Avertissement a l'activation des raccourcis avances -->
+    <string name="adv_sc_enable_warn_title">O botão atribuído muda de função</string>
+    <string name="adv_sc_enable_warn_msg">Um botão atribuído a um atalho avançado perde a sua função original: o MG4Control intercepta a tecla antes do launcher, que deixa de a receber.\n\nExemplo: se atribuir o botão Início, deixará de voltar ao launcher MG. Para o recuperar, atribua-lhe a ação « Iniciar um app » e escolha o launcher.\n\nA tecla é reservada por completo: atribuir apenas a pressão longa anula também a curta e a dupla.\n\nTudo volta ao normal ao eliminar o atalho em « Lista de atalhos ».</string>
+    <string name="adv_sc_enable_warn_ok">Ativar</string>
 </resources>

app/src/main/res/values/strings.xml

@@ -460,4 +460,9 @@
     <string name="adv_sc_replace_msg">%1$s en %2$s déclenche déjà : %3$s.\n\nRemplacer par la nouvelle fonction ?</string>
     <string name="adv_sc_replace_ok">Remplacer</string>
     <string name="adv_sc_press_double">Double appui</string>
+
+    <!-- Avertissement a l'activation des raccourcis avances -->
+    <string name="adv_sc_enable_warn_title">Le bouton attribué change de rôle</string>
+    <string name="adv_sc_enable_warn_msg">Un bouton attribué à un raccourci avancé perd sa fonction d\'origine : MG4Control intercepte la touche avant le launcher, qui ne la voit plus du tout.\n\nExemple : si vous attribuez le bouton Accueil, il ne ramènera plus au launcher MG. Pour retrouver ce comportement, donnez-lui l\'action « Lancer une application » et choisissez le launcher.\n\nLa touche est réclamée en entier : n\'attribuer que l\'appui long neutralise aussi l\'appui court et le double appui.\n\nTout redevient normal en supprimant le raccourci dans « Liste des raccourcis ».</string>
+    <string name="adv_sc_enable_warn_ok">Activer</string>
 </resources>