Flutter Deeplinks Configuration

FLUTTER_DEEPLINK_CONFIG.md

Managind Deeplinks in Flutter

References

• article
• youtube

Android

• Deeplinks allowed paths:

  • android:

    • AndroidManifest.xml/application/activity//

      <meta-data android:name="flutter_deeplink_enabled" android:value="true" />
      <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" />
        <data android:host="yourDomain.com" />
        <data android:pathPattern="/.."/>
      </intent-filter>
      

  • iOS:

    • TODO

• consistent appId in:

  • global.constants.dart/appPackageAndroid
  • global.constants.dart/appPackageIOS
  • android/app/build.gradle/defaultConfig/applicationId
  • ios

    • TODO

• assetlinks.json:

  • move to website root path and make sure it is accessible to the public
    • https://pocheapp.com/.well-known/assetlinks.json

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "com.groupecoatech.poche",
      "sha256_cert_fingerprints": [
        "00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00"
      ]
    }
  }
]

• replace sha256_cert_fingerprints with fingerprint

  • sign in play store / developer console: Setup/App Integrity/SHA-256 certificate fingerprint
  • sign in locally:
  1. keytool -list -v -keystore <keystore path> -alias <key alias> -storepass <store password> -keypass <key password>
  2. keytool -list -v -keystore <path-to-signing-key>
  • check if setup is correct with the statement list tester tool provided by Google
    • Google Deeplink Tool

• Test Deep Links on Android using adb (android/sdk/platform-tools)

  • For HTTP/HTTPS links:

    -c android.intent.category.BROWSABLE \
    -d https://yourDomain.com```

  • And for custom schemes:

    -c android.intent.category.BROWSABLE \
    -d yourScheme://yourDomain.com```
    

iOS

• Add key in Info.plist FlutterDeepLinkingEnabled to YES
• Handle associated domains
  • Go to "XCode > Runner > Signing & Capabilities > + Capability / Associated Domains /"
  • add you app domain exampleApp.com
• Add web integration
  • create apple-app-site-association.json in your root web app
    • https://pocheapp.com/.well-known/apple-app-site-association
    • must be served with the application/json content type

{
  "applinks": {
    "details": [
      {
        "appId": "abcde1234.com.ExampleApp",
        "paths": [
          "/link/?*",
          "/auth/?*",
          "/cagnottes/?*",
          "/caisses/?*",
          "/tontines/?*",
        ]
      }
    ]
  }
}

• the app id is a combination of you TEAM_ID.BUNDLE_ID
  • TEAM_ID location: Apple developer account id used for registration
  • BUNDLE_ID location: XCode > General
• Test Deep Links on iOS
  • For HTTP/HTTPS links:
    • xcrun simctl openurl booted https://yourDomain.com/path
  • And for custom scheme links:
    • xcrun simctl openurl booted yourScheme://yourDomain.com/path