Prompt Update (Manual Trigger)

Goal

Prompt the user to update from a settings/help screen.

Actions Required

Action	Purpose
AppUpdaterPromptUpdate	Show native update prompt/flow
AppUpdaterGetPromptUpdateError	Read cached error after failure (optional)
AppUpdaterGetPromptUpdateProgress	Read cached progress (Android only, optional)

Variables Needed

• progress (Float) (Android only, optional)

Implementation Steps

1. UserPressedUpdateButton (Entry State)

From your Settings screen, when user presses “Check for Updates” / “Update App”:

• Go to PromptUpdate

2. PromptUpdate

Action: AppUpdaterPromptUpdate

• Inputs:

  • isForceUpdate: false

  • promptTitle / promptMessage: optional

• Events:

  • successEvent → Done

  • failureEvent → (Optional) ReadPromptError

  • progressUpdateEvent → (Optional) UpdateProgressUI (Android only)

3. (Optional) UpdateProgressUI

Action: AppUpdaterGetPromptUpdateProgress

• Outputs:

  • progress → progress

4. (Optional) ReadPromptError

Action: AppUpdaterGetPromptUpdateError

• Outputs: errorCode, errorDescription

Common Issues

• App backgrounding: App may go to background during the update flow

• Platform support: PromptUpdate behavior differs between iOS/Android

Platform Differences

• iOS: Typically opens App Store / update prompt UI

• Android: Uses Play Core update flow (progressUpdateEvent supported)

Use When

• User-initiated “Update App” action

• Support/help flows directing users to update