CONFIRMATION_DIALOG - Ask the user to confirm an action via the UI

When to use it

Use CONFIRMATION_DIALOG before taking a payload action which might take a long time, be intrusive, or otherwise should warn the user and give them a chance to cancel.

Syntax 

  CONFIRMATION_DIALOG ["text prompt"]

text prompt

Arbitrary text prompt to show to the user. The text should be kept short enough to fit on the device display.

An example confirmation dialog

An example confirmation dialog

Results

CONFIRMATION_DIALOG will wait until the user has made a selection, pausing the payload.

CONFIRMATION_DIALOG prints a 1 if the user continues or 0 if the user cancels, and exits with an error code if the command fails.

Examples 

  resp=$(CONFIRMATION_DIALOG "Continue the payload?") || exit 1
if [ "$resp" != "$DUCKYSCRIPT_USER_CONFIRMED" ]; then
    LOG "User cancelled!"
    exit 0
fi