Unable to navigate with Navigator state after receiving a Deep-link in iOS, Android works fine.

[manthan34]

Is there an existing issue for this?

• I have searched the existing issues
• I have read the guide to filing a bug

Steps to reproduce

1. Run the app in iPhone or iOS simulator
2. Write this link in a chat in iPhone Messages app > nstsaas://com.deeplink.test?error=error
3. Select the whole link text, tap it once and select the Open Link option
4. My app will come to foreground but won't navigate to a desire screen.

Expected results

To navigate to a desired screen when app receives a Deep-link.

Actual results

App is not navigating in iPhone where as Android app works as expected.

Code sample

Code sample

import 'package:deeplink/home.dart';
import 'package:deeplink/settings.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
  DeeplinkManager.instance.configureChannel();
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      navigatorKey: NavigationService.navigatorKey,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: HomePage(),
      routes: Routes.routes,
      restorationScopeId: "nst-saas-root",
    );
  }
}

class NavigationService {
  NavigationService._();
  static GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();
}

class DeeplinkManager {

  static const channelName = 'com.nst.dltest.deeplink/deeplinkmanager';
  late MethodChannel methodChannel;

  static final DeeplinkManager instance = DeeplinkManager._init();

  DeeplinkManager._init();

  void configureChannel() {
    methodChannel = const MethodChannel(channelName);
    methodChannel.setMethodCallHandler(methodHandler); // set method handler
  }

  Future<void> methodHandler(MethodCall call) async {
    switch (call.method) {
      case "handleDeeplinkData":
        try {
          NavigationService
              .navigatorKey
              .currentState!.pushNamed(Routes.settings,);
        } catch (e) {
          print("Exception: DeeplinkManager > methodHandler: ${e.toString()}");
        }
        break;
      default:
        print("Error: No method handler for: ${call.method}");
    }
  }

}

class Routes {
  Routes._();

  //static variables
  static const String home = '/home';
  static const String settings = '/settings';

  static final routes = <String, WidgetBuilder> {
    home: (BuildContext context) => const HomePage(),
    settings: (BuildContext context) => const SettingsPage(),
  };

}

Screenshots or Video

Screenshots / Video demonstration

android.mov

iPhone.mov

Logs

Logs

[Paste your logs here]

Flutter Doctor output

Doctor output

[!] Flutter (Channel stable, 3.10.5, on macOS 13.3 22E252 darwin-arm64, locale en-IN)
    • Flutter version 3.10.5 on channel stable at /Users/nextsavy/development/flutter
    ! Warning: `dart` on your path resolves to /opt/homebrew/Cellar/dart/3.0.5/libexec/bin/dart, which is not inside your current Flutter SDK checkout at /Users/nextsavy/development/flutter. Consider adding
      /Users/nextsavy/development/flutter/bin to the front of your path.
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 796c8ef792 (4 months ago), 2023-06-13 15:51:02 -0700
    • Engine revision 45f6e00911
    • Dart version 3.0.5
    • DevTools version 2.23.1
    • If those were intentional, you can disregard the above warnings; however it is recommended to use "git" directly to perform update checks and upgrades.

[!] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
    • Android SDK at /Users/nextsavy/Library/Android/sdk
    ✗ cmdline-tools component is missing
      Run `path/to/sdkmanager --install "cmdline-tools;latest"`
      See https://developer.android.com/studio/command-line for more details.
    ✗ Android license status unknown.
      Run `flutter doctor --android-licenses` to accept the SDK licenses.
      See https://flutter.dev/docs/get-started/install/macos#android-setup for more details.

[✓] Xcode - develop for iOS and macOS (Xcode 14.3.1)
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Build 14E300c
    • CocoaPods version 1.12.1

[✓] Chrome - develop for the web
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[✓] Android Studio (version 2022.2)
    • Android Studio at /Applications/Android Studio.app/Contents
    • Flutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build 17.0.6+0-17.0.6b802.4-9586694)

[✓] VS Code (version 1.82.2)
    • VS Code at /Applications/Visual Studio Code.app/Contents
    • Flutter extension can be installed from:
      🔨 https://marketplace.visualstudio.com/items?itemName=Dart-Code.flutter

[✓] Connected device (4 available)
    • sdk gphone64 arm64 (mobile) • emulator-5554                        • android-arm64  • Android 13 (API 33) (emulator)
    • iPhone 14 Pro Max (mobile)  • 733D4B45-2965-4B70-B882-87F8F1CDC0C5 • ios            • com.apple.CoreSimulator.SimRuntime.iOS-16-4 (simulator)
    • macOS (desktop)             • macos                                • darwin-arm64   • macOS 13.3 22E252 darwin-arm64
    • Chrome (web)                • chrome                               • web-javascript • Google Chrome 117.0.5938.92

[✓] Network resources
    • All expected network resources are available.

! Doctor found issues in 2 categories.

[huycozy]

Hi @manthan34
In order to address the issue properly, please provide a completed and minimal reproducible code sample that doesn’t include 3rd party plugins or complex production code so that we may verify this.

Instead, if you think that the issue might depend on your implementation, please see flutter's community for resources and ask the same question. You may also get some help if you post it on Stack Overflow as well.

Thanks!

[manthan34]

Hi @manthan34 In order to address the issue properly, please provide a completed and minimal reproducible code sample that doesn’t include 3rd party plugins or complex production code so that we may verify this.

Instead, if you think that the issue might depend on your implementation, please see flutter's community for resources and ask the same question. You may also get some help if you post it on Stack Overflow as well.

Thanks!

Hi @huycozy
Please find the complete code sample here:
https://github.com/manthan34/deeplink-test

[huycozy]

Thanks for providing the sample code. I see the issue also happens on Android when the app has cold start. It can be reproduced when you quit app by Back button and open deep link from outside.

This behavior may be explained at deep-linking#behavior.

Also, I looked at sample code and can see you are handling the navigation (navigate to the next page) by MethodChannel signal. In order to isolate the issue to know if this is a Navigator issue or also related to MethodChannel, I would suggest you simplify the sample code by removing MethodChannel part and only handle deep link with navigation to see if the issue still occurs or not.

[manthan34]

@huycozy
If I handle the navigation with onGenerateRoute, it works fine for iOS but in Android it is not receiving all the query parameters. I have pushed the latest code the repo, please take a pull and check it.

Try to hit this link in Android and iOS
Link: nstsaas://com.deeplink.test/settings?consent=consent&application-user-id=userId&user-uuid=uuid&institution=test

iOS will receive all 4 query parameters but Android only gets first query parameter.

[huycozy]

Thanks for the update. But that is an issue with the command, please see this. It should be added single comma (') as below:

adb shell 'am start -a android.intent.action.VIEW -d "nstsaas://com.deeplink.test/settings?consent=consent&application-user-id=userId&user-uuid=uuid&institution=test"'

Or you can try open the link from html page like this from browser for testing purpose:

<!DOCTYPE html>
<html>
<body>

<h1>HTML Links</h1>

<p><a href="nstsaas://com.deeplink.test/settings?consent=consent&application-user-id=userId&user-uuid=uuid&institution=test">Test Deeplink</a></p>

</body>
</html>

If you think this issue has been solved, feel free to close it.

[github-actions]

Without additional information, we are unfortunately not sure how to resolve this issue. We are therefore reluctantly going to close this bug for now.
If you find this problem please file a new issue with the same description, what happens, logs and the output of 'flutter doctor -v'. All system setups can be slightly different so it's always better to open new issues and reference the related ones.
Thanks for your contribution.

[github-actions]

This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.