https://myapp.com/invitation/ABC123

myapp://invitation/ABC123

https://myapp.com/invitation/ABC123

https://myapp.com/.well-known/assetlinks.json

apple-app-site-association

https://myapp.com/.well-known/apple-app-site-association

flutter pub add app_links

dependencies:
  flutter:
    sdk: flutter

  app_links: ^7.2.1

flutter pub get

https://myapp.com/invitation/ABC123

final invitationCode = 'ABC123';

final invitationUrl = Uri.https(
  'myapp.com',
  '/invitation/$invitationCode',
).toString();

print(invitationUrl);

https://myapp.com/invitation/ABC123

{
  "code": "ABC123",
  "link": "https://myapp.com/invitation/ABC123"
}

API:
https://api.myapp.com

App Links:
https://myapp.com

https://myapp.com/invitation/ABC123

https://api.myapp.com/invitations/ABC123

https://myapp.com/invitation/ABC123

https://links.myapp.com/invitation/ABC123

android/app/src/main/AndroidManifest.xml

<meta-data
    android:name="flutter_deeplinking_enabled"
    android:value="false" />

<intent-filter android:autoVerify="true">

    <action android:name="android.intent.action.VIEW" />

    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data
        android:scheme="https"
        android:host="myapp.com"
        android:pathPrefix="/invitation" />

</intent-filter>

https://myapp.com/invitation/ABC123

/.well-known/assetlinks.json

https://myapp.com/.well-known/assetlinks.json

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.myapp",
      "sha256_cert_fingerprints": [
        "AA:BB:CC:DD:EE:FF:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:11:22:33:44:55:66:77:88:99:00:11"
      ]
    }
  }
]

com.example.myapp

keytool -list -v -keystore my-release-key.keystore

myapp://invitation/ABC123

<intent-filter>

    <action android:name="android.intent.action.VIEW" />

    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data
        android:scheme="myapp"
        android:host="invitation" />

</intent-filter>

ios/Runner/Info.plist

<key>FlutterDeepLinkingEnabled</key>
<false/>

myapp://invitation/ABC123

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>com.example.myapp</string>

        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
    </dict>
</array>

myapp://

https://myapp.com/invitation/ABC123

applinks:myapp.com

apple-app-site-association

https://myapp.com/.well-known/apple-app-site-association

{
  "applinks": {
    "details": [
      {
        "appID": "TEAMID.com.example.myapp",
        "paths": [
          "/invitation/*"
        ]
      }
    ]
  }
}

TEAMID.com.example.myapp

https://myapp.com/invitation/ABC123

String generateInvitationLink(String code) {
  return Uri.https(
    'myapp.com',
    '/invitation/$code',
  ).toString();
}

final link = generateInvitationLink('ABC123');

print(link);

https://myapp.com/invitation/ABC123

https://myapp.com/invitation/ABC123?ref=whatsapp

final uri = Uri.https(
  'myapp.com',
  '/invitation/ABC123',
  {
    'ref': 'whatsapp',
    'campaign': 'summer',
  },
);

print(uri.toString());

https://myapp.com/invitation/ABC123?ref=whatsapp&campaign=summer

import 'package:app_links/app_links.dart';

final appLinks = AppLinks();

final subscription = appLinks.uriLinkStream.listen((uri) {
  print(uri);
});

https://myapp.com/invitation/ABC123?ref=whatsapp

void handleLink(Uri uri) {
  print(uri.scheme);
  print(uri.host);
  print(uri.path);
  print(uri.pathSegments);
  print(uri.queryParameters);
}

scheme:
https

host:
myapp.com

path:
/invitation/ABC123

pathSegments:
[invitation, ABC123]

queryParameters:
{ref: whatsapp}

void handleInvitation(Uri uri) {
  final segments = uri.pathSegments;

  if (segments.length < 2) {
    return;
  }

  if (segments[0] != 'invitation') {
    return;
  }

  final code = segments[1];

  print('Invitation Code: $code');
}

https://myapp.com/invitation/ABC123

ABC123

https://myapp.com/invitation/ABC123?ref=whatsapp

final source = uri.queryParameters['ref'];

print(source);

whatsapp

void handleLink(
  BuildContext context,
  Uri uri,
) {
  final segments = uri.pathSegments;

  if (segments.length < 2) {
    return;
  }

  if (segments[0] == 'invitation') {
    final code = segments[1];

    Navigator.of(context).push(
      MaterialPageRoute(
        builder: (_) => InvitationPage(
          code: code,
        ),
      ),
    );
  }
}

uriLinkStream

final appLinks = AppLinks();

final initialUri = await appLinks.getInitialLink();

if (initialUri != null) {
  print(initialUri);
}

await appLinks.getInitialLinkString();

await appLinks.getLatestLink();

await appLinks.getLatestLinkString();

appLinks.uriLinkStream

import 'dart:async';

import 'package:app_links/app_links.dart';

class AppLinksService {
  AppLinksService._();

  static final AppLinksService instance = AppLinksService._();

  final AppLinks _appLinks = AppLinks();

  StreamSubscription<Uri>? _subscription;

  Future<void> init({
    required void Function(Uri uri) onLink,
  }) async {
    await _subscription?.cancel();

    _subscription = _appLinks.uriLinkStream.listen(
      onLink,
      onError: (error) {
        print('Deep link error: $error');
      },
    );
  }

  Future<void> dispose() async {
    await _subscription?.cancel();
    _subscription = null;
  }
}

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  runApp(const MyApp());
}

@override
void initState() {
  super.initState();

  AppLinksService.instance.init(
    onLink: handleDeepLink,
  );
}

void handleDeepLink(Uri uri) {
  final segments = uri.pathSegments;

  if (segments.length < 2) {
    return;
  }

  final type = segments[0];
  final value = segments[1];

  if (type == 'invitation') {
    print('Open invitation: $value');

    // Navigate to invitation page
  }
}

https://myapp.com/invitation/ABC123

Browser / WhatsApp
        ↓
Android / iOS
        ↓
App Links / Universal Links
        ↓
app_links
        ↓
uriLinkStream
        ↓
handleDeepLink()
        ↓
ABC123
        ↓
InvitationPage

GET /invitations/ABC123

رابط المشاركة
     ↓
التطبيق
     ↓
app_links
     ↓
قراءة ABC123
     ↓
API
     ↓
بيانات الدعوة

final code = 'ABC123';

final link = Uri.https(
  'myapp.com',
  '/invitation/$code',
).toString();

final link = Uri.https(
  'myapp.com',
  '/invitation/ABC123',
).toString();

// استخدم الرابط مع مكتبة المشاركة التي تعتمد عليها
print(link);

adb shell am start -a android.intent.action.VIEW \
  -d "myapp://invitation/ABC123"

xcrun simctl openurl booted \
  "myapp://invitation/ABC123"

https://myapp.com/invitation/ABC123

https://myapp.com/invitation/ABC123

myapp.com
www.myapp.com

https://www.myapp.com/invitation/ABC123

App Info
→ Open by default
→ Add link

/invitation/:code

final code = uri.pathSegments[1];

https://myapp.com/invitation/ABC123

Future<void> openInvitation(String code) async {
  final response = await api.get(
    '/invitations/$code',
  );

  // اعرض بيانات الدعوة بعد التحقق من الخادم
}

final uri = Uri.https(
  'myapp.com',
  '/product/125',
);

https://myapp.com/product/125

if (uri.pathSegments.length >= 2 &&
    uri.pathSegments[0] == 'product') {
  final productId = uri.pathSegments[1];

  print(productId);
}

final uri = Uri.https(
  'myapp.com',
  '/order/98765',
);

https://myapp.com/order/98765

https://myapp.com/reset-password/TOKEN123

if (uri.pathSegments.length >= 2 &&
    uri.pathSegments[0] == 'reset-password') {
  final token = uri.pathSegments[1];

  // افتح شاشة إعادة تعيين كلمة المرور
}

إنشاء الرابط
↓
https://myapp.com/invitation/ABC123

مشاركة الرابط
↓
WhatsApp / Telegram / Browser / Email

ضغط المستخدم على الرابط
↓
Android / iOS

تسليم الرابط إلى التطبيق
↓
app_links

قراءة URI
↓
ABC123

الاتصال بالـ API
↓
بيانات الدعوة

عرض الشاشة
↓
InvitationPage

https://myapp.com/invitation/ABC123

import 'dart:async';

import 'package:app_links/app_links.dart';
import 'package:flutter/material.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  runApp(const MyApp());
}

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final AppLinks _appLinks = AppLinks();

  StreamSubscription<Uri>? _linkSubscription;

  @override
  void initState() {
    super.initState();

    _initDeepLinks();
  }

  Future<void> _initDeepLinks() async {
    await _linkSubscription?.cancel();

    _linkSubscription = _appLinks.uriLinkStream.listen(
      (uri) {
        _handleDeepLink(uri);
      },
      onError: (error) {
        debugPrint(
          'Deep Link Error: $error',
        );
      },
    );
  }

  void _handleDeepLink(Uri uri) {
    debugPrint(
      'Received URI: $uri',
    );

    debugPrint(
      'Scheme: ${uri.scheme}',
    );

    debugPrint(
      'Host: ${uri.host}',
    );

    debugPrint(
      'Path: ${uri.path}',
    );

    debugPrint(
      'Segments: ${uri.pathSegments}',
    );

    debugPrint(
      'Query Params: ${uri.queryParameters}',
    );

    final segments = uri.pathSegments;

    if (segments.length >= 2 &&
        segments[0] == 'invitation') {
      final invitationCode = segments[1];

      _openInvitation(
        invitationCode,
      );
    }
  }

  void _openInvitation(
    String code,
  ) {
    debugPrint(
      'Invitation code: $code',
    );

    Navigator.of(context).push(
      MaterialPageRoute(
        builder: (_) => InvitationPage(
          code: code,
        ),
      ),
    );
  }

  String generateInvitationLink(
    String code,
  ) {
    return Uri.https(
      'myapp.com',
      '/invitation/$code',
    ).toString();
  }

  @override
  void dispose() {
    _linkSubscription?.cancel();

    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'App Links Demo',
      home: const HomePage(),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text(
          'App Links',
        ),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment:
              MainAxisAlignment.center,
          children: [
            const Text(
              'Deep Link Demo',
              style: TextStyle(
                fontSize: 24,
                fontWeight: FontWeight.bold,
              ),
            ),

            const SizedBox(
              height: 20,
            ),

            TextButton(
              onPressed: () {
                final link = Uri.https(
                  'myapp.com',
                  '/invitation/ABC123',
                ).toString();

                debugPrint(link);
              },
              child: const Text(
                'Generate Invitation Link',
              ),
            ),
          ],
        ),
      ),
    );
  }
}

class InvitationPage
    extends StatelessWidget {
  final String code;

  const InvitationPage({
    super.key,
    required this.code,
  });

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text(
          'Invitation',
        ),
      ),
      body: Center(
        child: Text(
          'Invitation Code: $code',
          style: const TextStyle(
            fontSize: 22,
          ),
        ),
      ),
    );
  }
}

<manifest
    xmlns:android="http://schemas.android.com/apk/res/android">

    <application
        android:label="myapp"
        android:name="${applicationName}"
        android:icon="@mipmap/ic_launcher">

        <activity
            android:name=".MainActivity"
            android:exported="true"
            android:launchMode="singleTop"
            android:theme="@style/LaunchTheme"
            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
            android:hardwareAccelerated="true"
            android:windowSoftInputMode="adjustResize">

            <meta-data
                android:name="flutter_deeplinking_enabled"
                android:value="false" />

            <intent-filter>

                <action
                    android:name="android.intent.action.MAIN" />

                <category
                    android:name="android.intent.category.LAUNCHER" />

            </intent-filter>

            <intent-filter
                android:autoVerify="true">

                <action
                    android:name="android.intent.action.VIEW" />

                <category
                    android:name="android.intent.category.DEFAULT" />

                <category
                    android:name="android.intent.category.BROWSABLE" />

                <data
                    android:scheme="https"
                    android:host="myapp.com"
                    android:pathPrefix="/invitation" />

            </intent-filter>

        </activity>

    </application>

</manifest>

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.myapp",
      "sha256_cert_fingerprints": [
        "YOUR_SHA256_FINGERPRINT"
      ]
    }
  }
]

https://myapp.com/.well-known/assetlinks.json

<key>FlutterDeepLinkingEnabled</key>
<false/>

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>com.example.myapp</string>

        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
    </dict>
</array>

Runner
→ Signing & Capabilities
→ Associated Domains
→ applinks:myapp.com

apple-app-site-association

https://myapp.com/.well-known/apple-app-site-association

{
  "applinks": {
    "details": [
      {
        "appID": "TEAM_ID.com.example.myapp",
        "paths": [
          "/invitation/*"
        ]
      }
    ]
  }
}

String generateInvitationLink(
  String code,
) {
  final uri = Uri.https(
    'myapp.com',
    '/invitation/$code',
  );

  return uri.toString();
}

final link = generateInvitationLink(
  'ABC123',
);

print(link);

https://myapp.com/invitation/ABC123

final appLinks = AppLinks();

final subscription =
    appLinks.uriLinkStream.listen(
  (Uri uri) {
    final segments = uri.pathSegments;

    if (segments.length >= 2 &&
        segments[0] == 'invitation') {
      final code = segments[1];

      print(
        'Invitation Code: $code',
      );
    }
  },
);

adb shell am start \
  -a android.intent.action.VIEW \
  -d "myapp://invitation/ABC123"

xcrun simctl openurl booted \
  "myapp://invitation/ABC123"