@capgo/capacitor-updater 8.47.0 → 8.47.2

package/android/src/main/java/ee/forgr/capacitor_updater/CapacitorUpdaterPlugin.java

@@ -75,6 +75,13 @@ import org.json.JSONObject;
 @CapacitorPlugin(name = "CapacitorUpdater")
 public class CapacitorUpdaterPlugin extends Plugin {
 
+    private static final String AUTO_UPDATE_MODE_OFF = "off";
+    private static final String AUTO_UPDATE_MODE_BACKGROUND = "atBackground";
+    private static final String AUTO_UPDATE_MODE_INSTALL = "atInstall";
+    private static final String AUTO_UPDATE_MODE_LAUNCH = "onLaunch";
+    private static final String AUTO_UPDATE_MODE_ALWAYS = "always";
+    private static final String AUTO_UPDATE_MODE_ONLY_DOWNLOAD = "onlyDownload";
+
     private Logger logger;
 
     private static final String updateUrlDefault = "https://plugin.capgo.app/updates";
@@ -113,7 +120,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
     static final int APPLICATION_EXIT_REASON_USER_REQUESTED = 10;
     static final int APPLICATION_EXIT_REASON_DEPENDENCY_DIED = 12;
 
-    private final String pluginVersion = "8.47.0";
+    private final String pluginVersion = "8.47.2";
     private static final String DELAY_CONDITION_PREFERENCES = "";
 
     private SharedPreferences.Editor editor;
@@ -127,6 +134,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
     private Boolean autoDeleteFailed = true;
     private Boolean autoDeletePrevious = true;
     private Boolean autoUpdate = false;
+    private String autoUpdateMode = AUTO_UPDATE_MODE_OFF;
     private String updateUrl = "";
     private Version currentVersionNative;
     private String currentBuildVersion;
@@ -357,45 +365,6 @@ public class CapacitorUpdaterPlugin extends Plugin {
             this.implementation.pluginVersion = this.pluginVersion;
             this.implementation.versionCode = this.getVersionCode(pInfo);
             // Removed unused OkHttpClient creation - using shared client in DownloadService instead
-            // Handle directUpdate configuration - support string values and backward compatibility
-            String directUpdateConfig = this.getConfig().getString("directUpdate", null);
-            if (directUpdateConfig != null) {
-                // Handle backward compatibility for boolean true
-                if (directUpdateConfig.equals("true")) {
-                    this.directUpdateMode = "always";
-                    this.implementation.directUpdate = true;
-                } else {
-                    this.directUpdateMode = directUpdateConfig;
-                    this.implementation.directUpdate =
-                        directUpdateConfig.equals("always") ||
-                        directUpdateConfig.equals("atInstall") ||
-                        directUpdateConfig.equals("onLaunch");
-                    // Validate directUpdate value
-                    if (
-                        !directUpdateConfig.equals("false") &&
-                        !directUpdateConfig.equals("always") &&
-                        !directUpdateConfig.equals("atInstall") &&
-                        !directUpdateConfig.equals("onLaunch")
-                    ) {
-                        logger.error(
-                            "Invalid directUpdate value: \"" +
-                                directUpdateConfig +
-                                "\". Supported values are: \"false\", \"true\", \"always\", \"atInstall\", \"onLaunch\". Defaulting to \"false\"."
-                        );
-                        this.directUpdateMode = "false";
-                        this.implementation.directUpdate = false;
-                    }
-                }
-            } else {
-                Boolean directUpdateBool = this.getConfig().getBoolean("directUpdate", false);
-                if (directUpdateBool) {
-                    this.directUpdateMode = "always"; // backward compatibility: true = always
-                    this.implementation.directUpdate = true;
-                } else {
-                    this.directUpdateMode = "false";
-                    this.implementation.directUpdate = false;
-                }
-            }
             this.currentVersionNative = new Version(this.getConfig().getString("version", pInfo.versionName));
             this.currentBuildVersion = this.getVersionCode(pInfo);
             this.delayUpdateUtils = new DelayUpdateUtils(this.prefs, this.editor, this.currentVersionNative, logger);
@@ -508,7 +477,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
                 }
             }
         }
-        this.autoUpdate = this.getConfig().getBoolean("autoUpdate", true);
+        this.configureAutoUpdateModeFromConfig();
         this.appReadyTimeout = Math.max(1000, this.getConfig().getInt("appReadyTimeout", 10000)); // Minimum 1 second
         this.keepUrlPathAfterReload = this.getConfig().getBoolean("keepUrlPathAfterReload", false);
         this.syncKeepUrlPathFlag(this.keepUrlPathAfterReload);
@@ -1301,6 +1270,9 @@ public class CapacitorUpdaterPlugin extends Plugin {
     }
 
     private boolean shouldUseDirectUpdate() {
+        if (!Boolean.TRUE.equals(this.autoUpdate) || AUTO_UPDATE_MODE_ONLY_DOWNLOAD.equals(this.autoUpdateMode)) {
+            return false;
+        }
         if (Boolean.TRUE.equals(this.autoSplashscreenTimedOut)) {
             return false;
         }
@@ -1331,6 +1303,115 @@ public class CapacitorUpdaterPlugin extends Plugin {
         }
     }
 
+    private void configureAutoUpdateModeFromConfig() {
+        final String configuredMode = this.getConfig().getString("autoUpdate", null);
+        if (configuredMode != null && !configuredMode.isEmpty() && !"true".equals(configuredMode) && !"false".equals(configuredMode)) {
+            this.autoUpdateMode = normalizedAutoUpdateMode(configuredMode);
+            if (!this.autoUpdateMode.equals(configuredMode)) {
+                logger.error(
+                    "Invalid autoUpdate value: \"" +
+                        configuredMode +
+                        "\". Supported values are: true, false, \"off\", \"atBackground\", \"atInstall\", \"onLaunch\", \"always\", \"onlyDownload\". Defaulting to \"atBackground\"."
+                );
+            }
+        } else {
+            final boolean enabled = configuredMode != null
+                ? "true".equals(configuredMode)
+                : Boolean.TRUE.equals(this.getConfig().getBoolean("autoUpdate", true));
+            this.autoUpdateMode = enabled
+                ? autoUpdateModeForLegacyDirectUpdateMode(this.resolveLegacyDirectUpdateModeFromConfig())
+                : AUTO_UPDATE_MODE_OFF;
+        }
+
+        this.autoUpdate = isAutoUpdateModeEnabled(this.autoUpdateMode);
+        this.directUpdateMode = directUpdateModeForAutoUpdateMode(this.autoUpdateMode);
+        this.implementation.directUpdate = isDirectUpdateMode(this.directUpdateMode);
+    }
+
+    private String resolveLegacyDirectUpdateModeFromConfig() {
+        final String directUpdateConfig = this.getConfig().getString("directUpdate", null);
+        if (directUpdateConfig != null) {
+            if ("true".equals(directUpdateConfig)) {
+                return AUTO_UPDATE_MODE_ALWAYS;
+            }
+            if ("false".equals(directUpdateConfig) || isDirectUpdateMode(directUpdateConfig)) {
+                return directUpdateConfig;
+            }
+            logger.error(
+                "Invalid directUpdate value: \"" +
+                    directUpdateConfig +
+                    "\". Supported values are: false, true, \"always\", \"atInstall\", \"onLaunch\". Defaulting to \"false\"."
+            );
+            return "false";
+        }
+
+        return Boolean.TRUE.equals(this.getConfig().getBoolean("directUpdate", false)) ? AUTO_UPDATE_MODE_ALWAYS : "false";
+    }
+
+    static String normalizedAutoUpdateMode(final String value) {
+        if (value == null) {
+            return AUTO_UPDATE_MODE_BACKGROUND;
+        }
+        switch (value) {
+            case "false":
+            case AUTO_UPDATE_MODE_OFF:
+                return AUTO_UPDATE_MODE_OFF;
+            case "true":
+            case AUTO_UPDATE_MODE_BACKGROUND:
+                return AUTO_UPDATE_MODE_BACKGROUND;
+            case AUTO_UPDATE_MODE_INSTALL:
+            case AUTO_UPDATE_MODE_LAUNCH:
+            case AUTO_UPDATE_MODE_ALWAYS:
+            case AUTO_UPDATE_MODE_ONLY_DOWNLOAD:
+                return value;
+            default:
+                return AUTO_UPDATE_MODE_BACKGROUND;
+        }
+    }
+
+    static String autoUpdateModeForLegacyDirectUpdateMode(final String directUpdateMode) {
+        switch (directUpdateMode) {
+            case AUTO_UPDATE_MODE_INSTALL:
+            case AUTO_UPDATE_MODE_LAUNCH:
+            case AUTO_UPDATE_MODE_ALWAYS:
+                return directUpdateMode;
+            case "false":
+            default:
+                return AUTO_UPDATE_MODE_BACKGROUND;
+        }
+    }
+
+    static String directUpdateModeForAutoUpdateMode(final String autoUpdateMode) {
+        switch (autoUpdateMode) {
+            case AUTO_UPDATE_MODE_INSTALL:
+            case AUTO_UPDATE_MODE_LAUNCH:
+            case AUTO_UPDATE_MODE_ALWAYS:
+                return autoUpdateMode;
+            default:
+                return "false";
+        }
+    }
+
+    static boolean isAutoUpdateModeEnabled(final String autoUpdateMode) {
+        return !AUTO_UPDATE_MODE_OFF.equals(autoUpdateMode);
+    }
+
+    static boolean shouldAutoUpdateModeSetNextBundle(final String autoUpdateMode) {
+        return isAutoUpdateModeEnabled(autoUpdateMode) && !AUTO_UPDATE_MODE_ONLY_DOWNLOAD.equals(autoUpdateMode);
+    }
+
+    static boolean isDirectUpdateMode(final String directUpdateMode) {
+        return (
+            AUTO_UPDATE_MODE_INSTALL.equals(directUpdateMode) ||
+            AUTO_UPDATE_MODE_LAUNCH.equals(directUpdateMode) ||
+            AUTO_UPDATE_MODE_ALWAYS.equals(directUpdateMode)
+        );
+    }
+
+    private boolean shouldAutoSetNextBundle() {
+        return shouldAutoUpdateModeSetNextBundle(this.autoUpdateMode);
+    }
+
     private boolean isDirectUpdateCurrentlyAllowed(final boolean plannedDirectUpdate) {
         return plannedDirectUpdate && !Boolean.TRUE.equals(this.autoSplashscreenTimedOut);
     }
@@ -1365,9 +1446,23 @@ public class CapacitorUpdaterPlugin extends Plugin {
 
     void configureDirectUpdateModeForTesting(final String directUpdateMode, final boolean onLaunchDirectUpdateUsed) {
         this.directUpdateMode = directUpdateMode;
+        this.autoUpdateMode = autoUpdateModeForLegacyDirectUpdateMode(directUpdateMode);
+        this.autoUpdate = isAutoUpdateModeEnabled(this.autoUpdateMode);
+        if (this.implementation != null) {
+            this.implementation.directUpdate = isDirectUpdateMode(this.directUpdateMode);
+        }
         this.onLaunchDirectUpdateUsed = onLaunchDirectUpdateUsed;
     }
 
+    void setAutoUpdateModeForTesting(final String autoUpdateMode) {
+        this.autoUpdateMode = normalizedAutoUpdateMode(autoUpdateMode);
+        this.autoUpdate = isAutoUpdateModeEnabled(this.autoUpdateMode);
+        this.directUpdateMode = directUpdateModeForAutoUpdateMode(this.autoUpdateMode);
+        if (this.implementation != null) {
+            this.implementation.directUpdate = isDirectUpdateMode(this.directUpdateMode);
+        }
+    }
+
     boolean shouldUseDirectUpdateForTesting() {
         return this.shouldUseDirectUpdate();
     }
@@ -3056,6 +3151,30 @@ public class CapacitorUpdaterPlugin extends Plugin {
         String failureAction,
         String failureEvent,
         boolean shouldSendStats
+    ) {
+        endBackGroundTaskWithNotif(
+            msg,
+            latestVersionName,
+            current,
+            error,
+            plannedDirectUpdate,
+            failureAction,
+            failureEvent,
+            shouldSendStats,
+            true
+        );
+    }
+
+    private void endBackGroundTaskWithNotif(
+        String msg,
+        String latestVersionName,
+        BundleInfo current,
+        Boolean error,
+        Boolean plannedDirectUpdate,
+        String failureAction,
+        String failureEvent,
+        boolean shouldSendStats,
+        boolean shouldNotifyNoNeedUpdate
     ) {
         this.consumeOnLaunchDirectUpdateAttempt(Boolean.TRUE.equals(plannedDirectUpdate));
         if (error) {
@@ -3074,9 +3193,11 @@ public class CapacitorUpdaterPlugin extends Plugin {
             ret.put("version", latestVersionName);
             this.notifyListeners(failureEvent, ret);
         }
-        final JSObject ret = new JSObject();
-        ret.put("bundle", InternalUtils.mapToJSObject(current.toJSONMap()));
-        this.notifyListeners("noNeedUpdate", ret);
+        if (shouldNotifyNoNeedUpdate) {
+            final JSObject ret = new JSObject();
+            ret.put("bundle", InternalUtils.mapToJSObject(current.toJSONMap()));
+            this.notifyListeners("noNeedUpdate", ret);
+        }
         this.sendReadyToJs(current, msg, plannedDirectUpdate);
         this.backgroundDownloadTask = null;
         this.downloadStartTimeMs = 0;
@@ -3113,7 +3234,9 @@ public class CapacitorUpdaterPlugin extends Plugin {
         final boolean initialDirectUpdateAllowed = this.isDirectUpdateCurrentlyAllowed(plannedDirectUpdate);
         final String messageUpdate = initialDirectUpdateAllowed
             ? "Update will occur now."
-            : "Update will occur next time app moves to background.";
+            : this.shouldAutoSetNextBundle()
+                ? "Update will occur next time app moves to background."
+                : "Update will be downloaded and made available.";
         Thread newTask = startNewThread(() -> {
             // Wait for cleanup to complete before starting download
             waitForCleanupIfNeeded();
@@ -3177,7 +3300,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
                                     false,
                                     true
                                 );
-                            } else {
+                            } else if (CapacitorUpdaterPlugin.this.shouldAutoSetNextBundle()) {
                                 if (plannedDirectUpdate && !directUpdateAllowedNow) {
                                     logger.info(
                                         "Direct update skipped because splashscreen timeout occurred. Update will be applied later."
@@ -3192,6 +3315,28 @@ public class CapacitorUpdaterPlugin extends Plugin {
                                     false,
                                     plannedDirectUpdate
                                 );
+                            } else {
+                                logger.info("autoUpdate is set to onlyDownload, builtin version will not be set as next bundle");
+                                final boolean builtinUpdateAvailable = !current.isBuiltin();
+                                if (builtinUpdateAvailable) {
+                                    final JSObject ret = new JSObject();
+                                    final BundleInfo builtinBundle = CapacitorUpdaterPlugin.this.implementation.getBundleInfo(
+                                        BundleInfo.ID_BUILTIN
+                                    );
+                                    ret.put("bundle", InternalUtils.mapToJSObject(builtinBundle.toJSONMap()));
+                                    CapacitorUpdaterPlugin.this.notifyListeners("updateAvailable", ret);
+                                }
+                                CapacitorUpdaterPlugin.this.endBackGroundTaskWithNotif(
+                                    "Latest version is builtin, autoUpdate onlyDownload",
+                                    latestVersionName,
+                                    current,
+                                    false,
+                                    plannedDirectUpdate,
+                                    "download_fail",
+                                    "downloadFailed",
+                                    true,
+                                    !builtinUpdateAvailable
+                                );
                             }
                             return;
                         }
@@ -3268,7 +3413,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
                                                 true
                                             );
                                         }
-                                    } else {
+                                    } else if (CapacitorUpdaterPlugin.this.shouldAutoSetNextBundle()) {
                                         if (plannedDirectUpdate && !directUpdateAllowedNow) {
                                             logger.info(
                                                 "Direct update skipped because splashscreen timeout occurred. Update will install on next background."
@@ -3283,6 +3428,20 @@ public class CapacitorUpdaterPlugin extends Plugin {
                                             false,
                                             plannedDirectUpdate
                                         );
+                                    } else {
+                                        logger.info("autoUpdate is set to onlyDownload, downloaded update will not be set as next bundle");
+                                        CapacitorUpdaterPlugin.this.notifyListeners("updateAvailable", ret);
+                                        CapacitorUpdaterPlugin.this.endBackGroundTaskWithNotif(
+                                            "update downloaded, autoUpdate onlyDownload",
+                                            latestVersionName,
+                                            current,
+                                            false,
+                                            plannedDirectUpdate,
+                                            "download_fail",
+                                            "downloadFailed",
+                                            true,
+                                            false
+                                        );
                                     }
                                     return;
                                 }
@@ -3329,7 +3488,8 @@ public class CapacitorUpdaterPlugin extends Plugin {
                                             latestVersionName,
                                             sessionKey,
                                             checksum,
-                                            manifest
+                                            manifest,
+                                            CapacitorUpdaterPlugin.this.shouldAutoSetNextBundle()
                                         );
                                     } else {
                                         // Handle single file download (existing code)
@@ -3338,7 +3498,8 @@ public class CapacitorUpdaterPlugin extends Plugin {
                                             latestVersionName,
                                             sessionKey,
                                             checksum,
-                                            null
+                                            null,
+                                            CapacitorUpdaterPlugin.this.shouldAutoSetNextBundle()
                                         );
                                     }
                                 } catch (final Exception e) {

package/dist/docs.json

@@ -4049,13 +4049,13 @@
               "name": "default"
             },
             {
-              "text": "false",
+              "text": "\"onlyDownload\"",
               "name": "example"
             }
           ],
-          "docs": "Configure whether the plugin should use Auto Update via an update server.\n\nOnly available for Android and iOS.",
+          "docs": "Configure how the plugin should use Auto Update via an update server.\n\nBoolean values keep their existing behavior:\n- `true`: Same as `\"atBackground\"`.\n- `false`: Same as `\"off\"`.\n\nString values merge the previous Auto Update and Direct Update configuration:\n- `\"off\"`: Disable Auto Update.\n- `\"atBackground\"`: Check and download updates automatically, then apply them the next time the app moves to background.\n- `\"atInstall\"`: Direct install only after app install or native app update, otherwise use `\"atBackground\"` behavior.\n- `\"onLaunch\"`: Direct install on app launch, otherwise use `\"atBackground\"` behavior after the first launch attempt.\n- `\"always\"`: Direct install whenever Auto Update runs.\n- `\"onlyDownload\"`: Check and download updates automatically, emit `updateAvailable`, but never direct install or set the next bundle automatically.\n\nOnly available for Android and iOS.",
           "complexTypes": [],
-          "type": "boolean | undefined"
+          "type": "boolean | 'always' | 'off' | 'atBackground' | 'atInstall' | 'onLaunch' | 'onlyDownload' | undefined"
         },
         {
           "name": "resetWhenUpdate",
@@ -4156,6 +4156,10 @@
         {
           "name": "directUpdate",
           "tags": [
+            {
+              "text": "Use {@link PluginsConfig.CapacitorUpdater.autoUpdate} string modes instead.\nWorks well for apps less than 10MB and with uploads done using --delta flag.\nZip or apps more than 10MB will be relatively slow for users to update.\n- false: Never do direct updates (use default behavior: download at start, set when backgrounded)\n- atInstall: Direct update only when app is installed, updated from store, otherwise act as directUpdate = false\n- onLaunch: Direct update only on app installed, updated from store or after app kill, otherwise act as directUpdate = false\n- always: Direct update in all previous cases (app installed, updated from store, after app kill or app resume), never act as directUpdate = false\n- true: (deprecated) Same as \"always\" for backward compatibility\n\nActivate this flag will automatically make the CLI upload delta in CICD envs and will ask for confirmation in local uploads.\nOnly available for Android and iOS.",
+              "name": "deprecated"
+            },
             {
               "text": "false",
               "name": "default"
@@ -4165,7 +4169,7 @@
               "name": "since"
             }
           ],
-          "docs": "Configure when the plugin should direct install updates. Only for autoUpdate mode.\nWorks well for apps less than 10MB and with uploads done using --delta flag.\nZip or apps more than 10MB will be relatively slow for users to update.\n- false: Never do direct updates (use default behavior: download at start, set when backgrounded)\n- atInstall: Direct update only when app is installed, updated from store, otherwise act as directUpdate = false\n- onLaunch: Direct update only on app installed, updated from store or after app kill, otherwise act as directUpdate = false\n- always: Direct update in all previous cases (app installed, updated from store, after app kill or app resume), never act as directUpdate = false\n- true: (deprecated) Same as \"always\" for backward compatibility\n\nActivate this flag will automatically make the CLI upload delta in CICD envs and will ask for confirmation in local uploads.\nOnly available for Android and iOS.",
+          "docs": "Configure when the plugin should direct install updates. Only for autoUpdate mode.",
           "complexTypes": [],
           "type": "boolean | 'always' | 'atInstall' | 'onLaunch' | undefined"
         },
@@ -4181,7 +4185,7 @@
               "name": "since"
             }
           ],
-          "docs": "Automatically handle splashscreen hiding when using directUpdate. When enabled, the plugin will automatically hide the splashscreen after updates are applied or when no update is needed.\nThis removes the need to manually listen for appReady events and call SplashScreen.hide().\nOnly works when directUpdate is set to \"atInstall\", \"always\", \"onLaunch\", or true.\nRequires the @capacitor/splash-screen plugin to be installed and configured with launchAutoHide: false.\nRequires autoUpdate and directUpdate to be enabled.\n\nOnly available for Android and iOS.",
+          "docs": "Automatically handle splashscreen hiding when using directUpdate. When enabled, the plugin will automatically hide the splashscreen after updates are applied or when no update is needed.\nThis removes the need to manually listen for appReady events and call SplashScreen.hide().\nOnly works when autoUpdate is set to \"atInstall\", \"always\", or \"onLaunch\", or when the deprecated directUpdate option is set to \"atInstall\", \"always\", \"onLaunch\", or true.\nRequires the @capacitor/splash-screen plugin to be installed and configured with launchAutoHide: false.\nRequires Auto Update and Direct Update behavior to be enabled.\n\nOnly available for Android and iOS.",
           "complexTypes": [],
           "type": "boolean | undefined"
         },

package/dist/esm/definitions.d.ts

@@ -42,14 +42,26 @@ declare module '@capacitor/cli' {
              */
             autoDeletePrevious?: boolean;
             /**
-             * Configure whether the plugin should use Auto Update via an update server.
+             * Configure how the plugin should use Auto Update via an update server.
+             *
+             * Boolean values keep their existing behavior:
+             * - `true`: Same as `"atBackground"`.
+             * - `false`: Same as `"off"`.
+             *
+             * String values merge the previous Auto Update and Direct Update configuration:
+             * - `"off"`: Disable Auto Update.
+             * - `"atBackground"`: Check and download updates automatically, then apply them the next time the app moves to background.
+             * - `"atInstall"`: Direct install only after app install or native app update, otherwise use `"atBackground"` behavior.
+             * - `"onLaunch"`: Direct install on app launch, otherwise use `"atBackground"` behavior after the first launch attempt.
+             * - `"always"`: Direct install whenever Auto Update runs.
+             * - `"onlyDownload"`: Check and download updates automatically, emit `updateAvailable`, but never direct install or set the next bundle automatically.
              *
              * Only available for Android and iOS.
              *
              * @default true
-             * @example false
+             * @example "onlyDownload"
              */
-            autoUpdate?: boolean;
+            autoUpdate?: boolean | 'off' | 'atBackground' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload';
             /**
              * Automatically delete previous downloaded bundles when a newer native app bundle is installed to the device.
              * Setting this to false can broke the auto update flow if the user download from the store a native app bundle that is older than the current downloaded bundle. Upload will be prevented by channel setting downgrade_under_native.
@@ -111,6 +123,8 @@ declare module '@capacitor/cli' {
             version?: string;
             /**
              * Configure when the plugin should direct install updates. Only for autoUpdate mode.
+             *
+             * @deprecated Use {@link PluginsConfig.CapacitorUpdater.autoUpdate} string modes instead.
              * Works well for apps less than 10MB and with uploads done using --delta flag.
              * Zip or apps more than 10MB will be relatively slow for users to update.
              * - false: Never do direct updates (use default behavior: download at start, set when backgrounded)
@@ -129,9 +143,9 @@ declare module '@capacitor/cli' {
             /**
              * Automatically handle splashscreen hiding when using directUpdate. When enabled, the plugin will automatically hide the splashscreen after updates are applied or when no update is needed.
              * This removes the need to manually listen for appReady events and call SplashScreen.hide().
-             * Only works when directUpdate is set to "atInstall", "always", "onLaunch", or true.
+             * Only works when autoUpdate is set to "atInstall", "always", or "onLaunch", or when the deprecated directUpdate option is set to "atInstall", "always", "onLaunch", or true.
              * Requires the @capacitor/splash-screen plugin to be installed and configured with launchAutoHide: false.
-             * Requires autoUpdate and directUpdate to be enabled.
+             * Requires Auto Update and Direct Update behavior to be enabled.
              *
              * Only available for Android and iOS.
              *