Tâche Show Toast

Résumé

• Nom interne : ShowToast
• Catégorie : Notifications
• Objectif : Afficher un message toast bref et transitoire à l'écran.
• Type de tâche : Normale

---

Compatibilité

• Version AndroMate minimale : 1.1.0

• Version AndroMate maximale : 1.1.0

• Android minimum : Android 13 (API 33)

• Android testé maximum : Android 16 (API 36)

• Permissions requises : Aucune

---

Description détaillée

La tâche Show Toast affiche un toast texte bref. Elle utilise Toast.makeText (toast texte simple), autorisé depuis l'arrière-plan sur toutes les versions Android supportées.

Comme les workflows s'exécutent sur un thread de fond, le toast est automatiquement redirigé en interne vers le main thread — sinon Android lèverait « Can't toast on a thread that has not called Looper.prepare() ».

---

Paramètres d'entrée

Paramètre	Type	Requis	Valeurs possibles / Règles	Compatibilité Android	Compatibilité AndroMate	Défaut
message	String	Oui	Texte du toast (interpolation supportée)	Android 13 (API 33) → Android 16 (API 36)	1.1.0 → 1.1.0	""
duration	Enum / String	Non	Short (~2s) ou Long (~3.5s)	Android 13 (API 33) → Android 16 (API 36)	1.1.0 → 1.1.0	Short

---

Paramètres de sortie

Cette tâche ne produit aucune variable de sortie. Elle retourne un VoidResult.

---

Exceptions

Cette tâche ne lève pas d'exceptions.

---

Diagramme d'exécution

flowchart TD
    Start([▶ ShowToast]) --> Resolve[🔧 Résolution message]

    Resolve --> Length[⏱️ Mappage durée\nShort / Long]

    Length --> Main[📲 Redirection main thread]

    Main --> Toast[🍞 Toast.makeText.show]

    Toast --> Success([✅ VoidResult])

    style Start fill:#e3f2fd
    style Success fill:#c8e6c9
    style Length fill:#fff9c4
    style Toast fill:#c8e6c9

Fonctionnement :

1. Résolution : message est résolu avec le contexte AndroMate
2. Durée : duration est mappé vers Toast.LENGTH_SHORT / LENGTH_LONG
3. Main thread : l'appel toast est posté sur le main thread
4. Affichage : le toast est affiché
5. Résultat : retourne VoidResult

---

Exemples de code

Exemple 1 — Toast court

{
  "ShowToast": [
    {
      "id": "1",
      "title": "Toast rapide",
      "message": "Étape terminée",
      "duration": "Short"
    }
  ]
}

---

Exemple 2 — Toast long avec variable

{
  "ShowToast": [
    {
      "id": "2",
      "title": "Toast résultat",
      "message": "Vitesse = $speed_kmh km/h",
      "duration": "Long"
    }
  ]
}

---

Détails des paramètres d'entrée

message — Texte du toast

Le texte affiché dans le toast. Supporte l'interpolation $variable et ${SPECIAL_VAR}.

duration — Durée d'affichage

• Short → ~2 secondes (Toast.LENGTH_SHORT)
• Long → ~3,5 secondes (Toast.LENGTH_LONG)

Toute valeur non reconnue retombe sur Short.

---

Détails des paramètres de sortie

Cette tâche ne produit aucune variable de sortie.

---

Exemple JSON complet

{
  "ShowToast": [
    {
      "id": "1",
      "title": "Show Toast",
      "message": "Bonjour depuis AndroMate",
      "duration": "Short"
    }
  ]
}