Configure deep link settings

Disable Flutter deep link reception

Since Flutter 3.27, built-in deep link reception is enabled by default. This couples reception with routing, which prevents the Adjust SDK from processing deep links before your app navigates. Disable it on each platform.

Before (default):

Flutter receives deep link in native code → Flutter deep link routing (such as go_router) automatically navigates the user. Your app has no opportunity to process the link.

After (disabled):

app_links library receives deep link in native code → forwards to Flutter callback → your app applies any custom logic, passes the link to the Adjust SDK for processing → your app navigates the user with Flutter deep link routing (such as go_router).

On iOS, add the following to your Info.plist:

1
<key>FlutterDeepLinkingEnabled</key>
2
<false/>

On Android, add the following to your main FlutterActivity’s <activity> tag in AndroidManifest.xml:

1
<activity
2
    android:name=".MainActivity"
3
    ...>
4
    <meta-data
5
        android:name="flutter_deeplinking_enabled"
6
        android:value="false" />
7
</activity>

Platform deep link setup

In addition to disabling Flutter’s built-in deep link reception, follow the native platform guides to configure Adjust deep link settings: