Merge pull request #12 from jayadevpanthaplavil/development

Add Remote Config redirection URL and fix update handling priority and checks

Author: jayadevpanthaplavil

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file.
 
+
+## [1.2.1] - 2025-10-22
+### Added
+- Support for separate redirection URL in Remote Config, allowing different URLs for update redirection based on configuration.
+
+### Fixed
+- Prioritized forced update handling over patch updates when the minimum version changes.
+- Ensured update check is triggered even when store navigation is skipped, improving reliability of update detection.
+
 ## [1.2.0] - 2025-10-15
 ### Added
 - Support for common update tracks: `stable`, `beta`, and `staging` for both release and patch updates.

README.md

@@ -238,12 +238,13 @@ class _MyHomePageState extends State<MyHomePage> {
 2. Add the following default parameters and values.
 3. Refer to [`example/remoteconfig.template.json`](example/remoteconfig.template.json) for a complete example.
 
-| Key                    | Example Value                                                                                                 | Description                                                                                                          |
-|------------------------|---------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
-| `min_required_version` | `{"stable": "1.0.0", "beta": "1.0.5", "staging": "1.0.10"}`                                                   | Minimum app version required **per track**. JSON map of track versions (`{"stable": "1.0.0", "beta": "1.0.5"}`).     |
-| `latest_version`       | `{"stable": "1.0.29", "beta": "1.0.30", "staging": "1.0.31"}`                                                 | Latest available version **per track**. JSON map of track versions (`{"stable": "1.0.29", "beta": "1.0.30"}`).       |
-| `patch_enabled`        | `true`                                                                                                        | Global flag to enable or disable patch checking.                                                                     |
-| `patch_info`           | `{ "1.0.25": { "stable": 1, "beta": 0, "staging": 0 }, "1.0.1": { "stable": 1, "beta": 2, "staging": 3 } }`   | Patch numbers per version and track. The format is `{ "version": { "track": patchNumber } }`.                        |
+| Key                    | Example Value                                                                                                                                                                                                                                                                                                                                                                                                  | Description                                                                                                               |
+|------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `min_required_version` | `{"stable": "1.0.0", "beta": "1.0.5", "staging": "1.0.10"}`                                                                                                                                                                                                                                                                                                                                                    | Minimum app version required **per track**. JSON map of track versions (`{"stable": "1.0.0", "beta": "1.0.5"}`).          |
+| `latest_version`       | `{"stable": "1.0.29", "beta": "1.0.30", "staging": "1.0.31"}`                                                                                                                                                                                                                                                                                                                                                  | Latest available version **per track**. JSON map of track versions (`{"stable": "1.0.29", "beta": "1.0.30"}`).            |
+| `patch_enabled`        | `true`                                                                                                                                                                                                                                                                                                                                                                                                         | Global flag to enable or disable patch checking.                                                                          |
+| `patch_info`           | `{ "1.0.25": { "stable": 1, "beta": 0, "staging": 0 }, "1.0.1": { "stable": 1, "beta": 2, "staging": 3 } }`                                                                                                                                                                                                                                                                                                    | Patch numbers per version and track. The format is `{ "version": { "track": patchNumber } }`.                             |
+| `redirect_url`         | `{ "android": { "stable": "https://play.google.com/store/apps/details?id=com.example.stable", "beta": "https://play.google.com/store/apps/details?id=com.example.beta", "staging": "https://play.google.com/store/apps/details?id=com.example.staging"}, "ios": {"stable": "https://apps.apple.com/app/idxxxx", "beta": "https://apps.apple.com/app/idxxxx", "staging": "https://apps.apple.com/app/idxxxx"}}` | Redirection URLs for each platform and track. JSON {"android": {"stable": "<url>", ...}, "ios": {"stable": "<url>", ...}} | 
 
 **Example `patch_info` value:**
 

example/pubspec.lock

@@ -368,10 +368,10 @@ packages:
     dependency: transitive
     description:
       name: url_launcher_ios
-      sha256: d80b3f567a617cb923546034cc94bfe44eb15f989fe670b37f26abdb9d939cb7
+      sha256: "6b63f1441e4f653ae799166a72b50b1767321ecc263a57aadf825a7a2a5477d9"
       url: "https://pub.dev"
     source: hosted
-    version: "6.3.4"
+    version: "6.3.5"
   url_launcher_linux:
     dependency: transitive
     description:
@@ -384,10 +384,10 @@ packages:
     dependency: transitive
     description:
       name: url_launcher_macos
-      sha256: c043a77d6600ac9c38300567f33ef12b0ef4f4783a2c1f00231d2b1941fea13f
+      sha256: "8262208506252a3ed4ff5c0dc1e973d2c0e0ef337d0a074d35634da5d44397c9"
       url: "https://pub.dev"
     source: hosted
-    version: "3.2.3"
+    version: "3.2.4"
   url_launcher_platform_interface:
     dependency: transitive
     description:

example/pubspec.yaml

@@ -16,7 +16,7 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
 # In Windows, build-name is used as the major, minor, and patch parts
 # of the product and file versions while build-number is used as the build suffix.
-version: 1.0.51+51
+version: 1.0.54+54
 
 environment:
   sdk: ^3.9.2

example/remoteconfig.template.json

@@ -27,6 +27,11 @@
       },
       "description": "Latest available version per track. JSON {\"stable\": \"1.0.29\", \"beta\": \"1.0.30\"}",
       "valueType": "STRING"
+    },
+    "redirect_url": {
+      "defaultValue": { "value": "{\"android\": {\"stable\": \"https://play.google.com/store/apps/details?id=com.example.stable\", \"beta\": \"https://play.google.com/store/apps/details?id=com.example.beta\", \"staging\": \"https://play.google.com/store/apps/details?id=com.example.staging\"}, \"ios\": {\"stable\": \"https://apps.apple.com/app/id1234567890\", \"beta\": \"https://apps.apple.com/app/id1234567891\", \"staging\": \"https://apps.apple.com/app/id1234567892\"}}" },
+      "description": "Redirection URLs for each platform and track. JSON {\"android\": {\"stable\": \"<url>\", ...}, \"ios\": {\"stable\": \"<url>\", ...}}",
+      "valueType": "STRING"
     }
   }
 }

lib/src/remote_config/remote_config_service.dart

@@ -1,4 +1,5 @@
 import 'dart:convert';
+import 'dart:io';
 import 'package:firebase_remote_config/firebase_remote_config.dart';
 import 'package:flutter/cupertino.dart';
 import 'package:package_info_plus/package_info_plus.dart';
@@ -74,6 +75,18 @@ class RemoteConfigService {
         RemoteConfigVariables.latestVersion: _packageInfo.version,
         RemoteConfigVariables.patchEnabled: false,
         RemoteConfigVariables.patchInfo: '{}',
+        RemoteConfigVariables.redirectUrl: jsonEncode({
+          "android": {
+            "stable": "",
+            "beta": "",
+            "staging": "",
+          },
+          "ios": {
+            "stable": "",
+            "beta": "",
+            "staging": "",
+          },
+        }),
       });
 
       await _remoteConfig.fetchAndActivate();
@@ -209,4 +222,47 @@ class RemoteConfigService {
       return null;
     }
   }
+
+  /// Get redirection URL for the current or specified track, platform-specific only
+  String getRedirectUrl({UpdateTrackType? track}) {
+    final configValue =
+        _remoteConfig.getString(RemoteConfigVariables.redirectUrl);
+
+    if (configValue.isEmpty) {
+      debugPrint("Redirect URL not found in Remote Config. Using default.");
+      return "";
+    }
+
+    try {
+      final dynamic parsed = jsonDecode(configValue);
+      final currentTrack = track ?? _currentTrack;
+
+      if (parsed is! Map<String, dynamic>) {
+        return "";
+      }
+
+      // Determine platform
+      final platformKey = Platform.isAndroid ? 'android' : 'ios';
+      final platformUrls = parsed[platformKey];
+
+      if (platformUrls is Map<String, dynamic>) {
+        final trackUrl = platformUrls[currentTrack.name];
+        if (trackUrl != null && trackUrl is String && trackUrl.isNotEmpty) {
+          return trackUrl;
+        } else {
+          // Platform exists but track URL not found
+          debugPrint(
+              "Track '${currentTrack.name}' not found for platform '$platformKey'");
+          return "";
+        }
+      }
+
+      // Platform not found
+      debugPrint("Platform '$platformKey' not found in redirect_url");
+      return "";
+    } catch (e) {
+      debugPrint("Redirect URL parse error: $e");
+      return "";
+    }
+  }
 }

lib/src/remote_config/remote_config_variables.dart

@@ -3,4 +3,5 @@ class RemoteConfigVariables {
   static const String latestVersion = "latest_version";
   static const String patchEnabled = "patch_enabled";
   static const String patchInfo = "patch_info";
+  static const String redirectUrl = "redirect_url";
 }

lib/src/ui/ui_handler/ui_handler.dart

@@ -41,6 +41,9 @@ class UpdateUIHandler {
   static const String _patchBannerKey = 'patch_banner';
   static const String _patchOverlayKey = 'patch_overlay';
 
+  // Remote Config Service
+  final remoteConfigService = RemoteConfigService.instance;
+
   UpdateUIHandler({
     required this.context,
     required this.config,
@@ -920,36 +923,47 @@ class UpdateUIHandler {
 
   Future<void> _navigateToStore() async {
     final isAndroid = Theme.of(context).platform == TargetPlatform.android;
-    final url = isAndroid
-        ? config.androidPlayStoreUrl
-        : config.iosAppStoreUrl ?? config.iosTestFlightUrl;
+
+    final redirectUrl = remoteConfigService.getRedirectUrl();
+    final url = (redirectUrl.isEmpty)
+        ? (isAndroid
+            ? config.androidPlayStoreUrl
+            : config.iosAppStoreUrl ?? config.iosTestFlightUrl)
+        : redirectUrl;
 
     if (url != null && await canLaunchUrl(Uri.parse(url))) {
       await launchUrl(
         Uri.parse(url),
         mode: LaunchMode.externalApplication,
       );
+
+      // After returning from the store, recheck the update.
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        _waitForAppResumed();
+      });
     } else {
       debugPrint('Could not launch store URL: $url');
       if (!context.mounted) return;
-      ScaffoldMessenger.of(context).showSnackBar(
-        const SnackBar(
-          content: Text('Could not open store. Please update manually.'),
-        ),
+      ScaffoldMessenger.of(context)
+          .showSnackBar(
+            const SnackBar(
+              content: Text('Could not open store. Please update manually.'),
+            ),
+          )
+          .closed
+          .then(
+        (value) async {
+          // Immediately check for updates here since user didn't leave app
+          await remoteConfigService.handleUpdateCheck();
+        },
       );
     }
-
-    // After returning from the store, recheck the update.
-    WidgetsBinding.instance.addPostFrameCallback((_) {
-      _waitForAppResumed();
-    });
   }
 
   void _waitForAppResumed() {
     WidgetsBinding.instance.addObserver(
       _AppLifecycleObserver(
         onResumed: () async {
-          final remoteConfigService = RemoteConfigService.instance;
           await remoteConfigService.handleUpdateCheck();
         },
       ),

lib/src/update_manager.dart

@@ -141,25 +141,30 @@ class UpdateManager {
 
     _lastUpdateType = type;
 
-    // Only trigger Shorebird check if patch source
-    if (source == UpdateSource.patch && patchNumber != null) {
-      if (enableShorebird &&
-          _shorebirdService != null &&
-          _shorebirdService!.isAvailable) {
-        await checkShorebirdPatch(track: currentTrackType);
-        return; // Don't show store UI for patch updates
-      }
-    }
-
-    // Show store update UI
+    // --- Step 1: Handle store (release) updates first ---
     if (type != UpdateType.none) {
       if (onUpdate == null && _uiHandler != null) {
-        await _uiHandler!.handleStoreUpdate(type: type, source: source);
+        await _uiHandler!
+            .handleStoreUpdate(type: type, source: UpdateSource.release);
       }
 
       if (onUpdate != null) {
-        await onUpdate!(type: type, source: source, patchNumber: patchNumber);
+        await onUpdate!(
+            type: type, source: UpdateSource.release, patchNumber: patchNumber);
       }
+
+      // If it's a forced update, stop further checks (don’t continue to Shorebird)
+      if (type == UpdateType.force) return;
+    }
+
+    // --- Step 2: Only check Shorebird patch updates after handling store updates ---
+    if (enableShorebird &&
+        source == UpdateSource.patch &&
+        patchNumber != null &&
+        _shorebirdService != null &&
+        _shorebirdService!.isAvailable) {
+      await checkShorebirdPatch(track: currentTrackType);
+      return; // Don't show store UI for patch updates
     }
   }
 

pubspec.yaml

@@ -1,6 +1,6 @@
 name: update_manager
 description: "A Flutter package to manage app updates with Firebase Remote Config and Shorebird, supporting force, optional, and patch updates easily."
-version: 1.2.0
+version: 1.2.1
 homepage: "https://github.com/jayadevpanthaplavil/update-manager"
 repository: "https://github.com/jayadevpanthaplavil/update-manager"
 issue_tracker: "https://github.com/jayadevpanthaplavil/update-manager/issues"