Show confirmations on Wear

Confirmation animations give users visual feedback when they complete an action. They cover the entire screen to ensure that users can see these confirmations at a glance.

In most cases, you won't need to use a separate confirmation animation. Review Design principles for more information.

The Jetpack Wearable UI Library provides ConfirmationActivity to display a confirmation animation in your apps.

Show confirmation animations

ConfirmationActivity is used to display confirmation animations after the user completes an action on the wearable.

There are three types of confirmations:

• Success: the action was completed successfully on the wearable.
• Failure: the action failed to complete.
• Open on Phone: the action has caused something to display on the phone, or in order to complete the action, the user needs to go to their phone to continue.

To show a confirmation animation when users complete an action in your app, create an intent that starts ConfirmationActivity from one of your activities. Set the EXTRA_ANIMATION_TYPE to one of the following values:

• SUCCESS_ANIMATION
• FAILURE_ANIMATION
• OPEN_ON_PHONE_ANIMATION

To use ConfirmationActivity in your app, first declare this activity in your manifest file, as shown in the following example:

<manifest>
  <application>
    ...
    <activity
        android:name="androidx.wear.activity.ConfirmationActivity">
    </activity>
  </application>
</manifest>

Determine the result of the user action, start the activity with an intent, and add a message that appears under the confirmation icon, as shown in the following example:

val intent = Intent(this, ConfirmationActivity::class.java).apply {
    putExtra(ConfirmationActivity.EXTRA_ANIMATION_TYPE, ConfirmationActivity.SUCCESS_ANIMATION)
    putExtra(ConfirmationActivity.EXTRA_MESSAGE, getString(R.string.msg_sent))
}
startActivity(intent)

After showing the confirmation animation, the ConfirmationActivity finishes and your activity resumes.