deeplink_listener #

Features #

deeplink_listener : #

Handling Custom Deep Links and Universal Links Deep linking allows your app to respond to links, whether they come from emails, websites, or other apps. There are two main types:

1. Custom URL Schemes – Works on both iOS and Android, but users are prompted if the app is not installed.
2. Universal Links / App Links – Standardized, secure, and seamless links that open the app if installed or fallback to the website if not.

Befor use #

if you are using Universal links your must be config you servr support IOS and Android handle deeplink Android to create https://youserveer.com/.well-known/assetlinks.json

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.yourdomain.app",
      "sha256_cert_fingerprints": ["YOUR_APP_SHA256_FINGERPRINT"]
    }
  }
]

IOS to create https://yourdomain.com/.well-known/apple-app-site-association

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "teamId.com.yourdomain.app",
        "paths": [ "/apple-login-callback", "/callback/*" ]
      }
    ]
  }
}

Usage #

Make sure to check out examples

Installation #

Add the following line to pubspec.yaml:

dependencies:
  deeplink_listener: ^1.0.0

Basic setup #

The complete example is available here.

create your _linkSub  
StreamSubscription<String>? _linkSub;
String _deeplinkResult = 'Unknown';

⭐ Initial cold start

• Get first time app never open and not active.

DeeplinkListener.getInitialLink().then((link) {
      print('[Dart] getInitialLink: $link');
      if (link != null) _handleDeepLink(link);
});

⭐ Stream for incoming links

• Get all time when app live and in background.

 DeeplinkListener.linkStream.listen(
      (link) {
        print('[Dart] linkStream received: $link');
        _handleDeepLink(link);
      },
      onError: (err) {
        print('[Dart] linkStream error: $err');
      },
);

Funtion Handller #

 // Listen for links when app is already running
  void _listenForDeepLinks() {
    _linkSub = DeeplinkListener.linkStream.listen(
      (link) {
        print("Incoming deep link: $link");
        _handleDeepLink(link);
      },
      onError: (err) {
        print("Deep link stream error: $err");
      },
    );
  }

  // Example handler
  void _handleDeepLink(String link) {
    // Do something with the link (e.g., navigation)
    setState(() {
      _deeplinkResult = link;
    });
    print("Handling deep link: $link");
  }

Note Don't forget cancel _linkSub before your view dispose #

@override
void dispose() {
    _linkSub?.cancel();
    super.dispose();
}

Deeplink Config See #

1. Andoid Deeplink

2. IOS Deeplink

how to run Testing in local #

Make sure you config all

1. Android can run adb by add echo 'export PATH="$PATH:/Users/nemo/Library/Android/sdk/platform-tools"' >> ~/.zprofile, your .zsrc

//Check your device has been link 
 adb devices   
//Open Custom deeplink
adb shell am start -a android.intent.action.VIEW -d "myapp://open"
//Open Universal Links
 adb shell am start -a android.intent.action.VIEW -d "link.deepershort.com"

2. IOS no need you just : Open brother safari

//Open Custom deeplink
myapp://
//Open Universal Links
https://link.deepershort.com

Hello everyone 👋

If you want to support me, feel free to do so.

Thanks

============================================

សួស្ដី អ្នកទាំងអស់គ្នា👋

បើ​អ្នក​ចង់​គាំទ្រ​ខ្ញុំ សូម​ធ្វើ​ដោយ​សេរី ,

សូមអរគុណ