Skip to main content
The Flutter plugin calls the Android and iOS SDKs. It does not replace app association. Routing still needs an autoVerify intent-filter and an applinks: host in the native project. The plugin forwards live links and recovers the original destination on first open after a store install, using the native Android and iOS SDKs.

When you need the SDK

getDynamicLink() and handleUniversalLink(url) stay split. On Android, getDynamicLink() also reads the current activity intent, so a cold start from an App Link is covered there. On iOS, getDynamicLink() is only the pasteboard check. A live Universal Link must be passed to handleUniversalLink.

Install

Also add the native SDKs:
iOS: the plugin podspec pulls pod 'Dashlink', '~> 1.0.0'. JSON resolve requires a Dynamic Link key. REST keys (dlk_live_) are rejected.
Create the key in Settings → API Keys → Type Dynamic Link. setDynamicLinkHosts is required. An empty list lets any https URL with a back-half through.

Association

Declare the Dynamic Link host in AndroidManifest.xml and in Associated Domains. The plugin cannot invent OS intercept. See App association.

Live taps

Forward every URL from the app-links stream (or uni_links) into handleUniversalLink.
An installed tap JSON-resolves with deferred=0 and match=direct, returns appUrl, and analytics records app_open.

Deferred first open

Call getDynamicLink() once at startup, after configure and setDynamicLinkHosts.
Android reads Play Install Referrer (match=referrer). iOS reads the pasteboard (match=pasteboard) and may show the system paste banner once. Both publish deferred_open joined to the store tap’s click_id. An empty or foreign value is a miss and is consumed once. Desktop and web builds have no Play referrer and no Universal Link pasteboard. Do not expect a link there.

Tracking

The store redirect is the click. SDK JSON resolve is an outcome on that click when click_id matches, not a second campaign click. PendingDynamicLink carries appUrl, destinationUrl, fallbackUrl, clickId, isDeferred, matchType, outcome, UTM fields, and shortUrl.

Test on a device

1

Uninstall the app

A previous install will not re-run deferred recovery.
2

Tap a Dynamic Link

The device should reach the store, not the home screen.
3

Install a build that includes the plugin

The host and the API key must already be configured.
4

Open the app

First open must land on appUrl, and analytics must show deferred_open for the same click_id.
If an installed tap still opens the browser, the problem is almost always app association, not the plugin.