Show Toast

Summary

• Internal name: ShowToast
• Category: Notifications
• Purpose: Display a short, transient toast message on screen.
• Task type: Normal

---

Compatibility

• Minimum AndroMate version: 1.1.0

• Maximum AndroMate version: 1.1.0

• Minimum Android: Android 13 (API 33)

• Maximum Android tested: Android 16 (API 36)

• Required permissions: None

---

Detailed description

The Show Toast task displays a short text toast. It uses Toast.makeText (a plain text toast), which is allowed from the background on all supported Android versions.

Because workflows run on a background worker thread, the toast is automatically dispatched to the main thread internally - otherwise Android would throw "Can't toast on a thread that has not called Looper.prepare()".

---

Input parameters

Parameter	Type	Required	Possible values / Rules	Android Compatibility	AndroMate Compatibility	Default
message	String	Yes	Toast text (supports interpolation)	Android 13 (API 33) -> Android 16 (API 36)	1.1.0 -> 1.1.0	""
duration	Enum / String	No	Short (~2s) or Long (~3.5s)	Android 13 (API 33) -> Android 16 (API 36)	1.1.0 -> 1.1.0	Short

---

Output parameters

This task produces no output variable. It returns a VoidResult.

---

Exceptions

This task does not throw exceptions.

---

Execution flowchart

flowchart TD
    Start([ShowToast]) --> Resolve[Resolve message]

    Resolve --> Length[Map duration\nShort / Long]

    Length --> Main[Dispatch to 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

How it works:

1. Resolve: message is resolved against the AndroMate context
2. Duration: duration is mapped to Toast.LENGTH_SHORT / LENGTH_LONG
3. Main thread: the toast call is posted to the main thread
4. Show: the toast is displayed
5. Result: returns VoidResult

---

Code examples

Example 1 - Short toast

{
  "ShowToast": [
    {
      "id": "1",
      "title": "Quick toast",
      "message": "Step done",
      "duration": "Short"
    }
  ]
}

---

Example 2 - Long toast with a variable

{
  "ShowToast": [
    {
      "id": "2",
      "title": "Result toast",
      "message": "Speed = $speed_kmh km/h",
      "duration": "Long"
    }
  ]
}

---

Input parameter details

message - Toast text

The text shown in the toast. Supports $variable and ${SPECIAL_VAR} interpolation.

duration - Display duration

• Short -> ~2 seconds (Toast.LENGTH_SHORT)
• Long -> ~3.5 seconds (Toast.LENGTH_LONG)

Any unrecognized value falls back to Short.

---

Output parameter details

This task produces no output variable.

---

Complete JSON example

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