showUpdateDialog method

void showUpdateDialog({ required BuildContext context, required VersionStatus versionStatus, String dialogTitle = 'Update Available', String? dialogText, String updateButtonText = 'Update', bool allowDismissal = true, String dismissButtonText = 'Maybe Later', VoidCallback? dismissAction, })

Android info is fetched by parsing the html of the app store page. Shows the user a platform-specific alert about the app update. The user can dismiss the alert or proceed to the app store.

To change the appearance and behavior of the update dialog, you can optionally provide dialogTitle, dialogText, updateButtonText, dismissButtonText, and dismissAction parameters.

Implementation

/// Shows the user a platform-specific alert about the app update. The user
/// can dismiss the alert or proceed to the app store.
///
/// To change the appearance and behavior of the update dialog, you can
/// optionally provide [dialogTitle], [dialogText], [updateButtonText],
/// [dismissButtonText], and [dismissAction] parameters.
void showUpdateDialog({
  required BuildContext context,
  required VersionStatus versionStatus,
  String dialogTitle = 'Update Available',
  String? dialogText,
  String updateButtonText = 'Update',
  bool allowDismissal = true,
  String dismissButtonText = 'Maybe Later',
  VoidCallback? dismissAction,
}) async {
  final dialogTitleWidget = Text(dialogTitle);
  final dialogTextWidget = Text(
    dialogText ??
        'You can now update this app from ${versionStatus.localVersion} to ${versionStatus.storeVersion}',
  );

  final updateButtonTextWidget = Text(updateButtonText);
  final updateAction = () {
    launchAppStore(versionStatus.appStoreLink);
    if (allowDismissal) {
      Navigator.of(context, rootNavigator: true).pop();
    }
  };

  List<Widget> actions = [
    Platform.isAndroid
        ? TextButton(
            child: updateButtonTextWidget,
            onPressed: updateAction,
          )
        : CupertinoDialogAction(
            child: updateButtonTextWidget,
            onPressed: updateAction,
          ),
  ];

  if (allowDismissal) {
    final dismissButtonTextWidget = Text(dismissButtonText);
    dismissAction = dismissAction ??
        () => Navigator.of(context, rootNavigator: true).pop();
    actions.add(
      Platform.isAndroid
          ? TextButton(
              child: dismissButtonTextWidget,
              onPressed: dismissAction,
            )
          : CupertinoDialogAction(
              child: dismissButtonTextWidget,
              onPressed: dismissAction,
            ),
    );
  }

  await showDialog(
    context: context,
    barrierDismissible: allowDismissal,
    builder: (BuildContext context) {
      return WillPopScope(
          child: Platform.isAndroid
              ? AlertDialog(
                  title: dialogTitleWidget,
                  content: dialogTextWidget,
                  actions: actions,
                )
              : CupertinoAlertDialog(
                  title: dialogTitleWidget,
                  content: dialogTextWidget,
                  actions: actions,
                ),
          onWillPop: () => Future.value(allowDismissal));
    },
  );
}