> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dashlink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Flutter SDK

> Install the Dashlink Flutter plugin, forward live links, and recover the original content after a store install.

The Flutter plugin calls the [Android](https://docs.dashlink.ai/guides/app-dynamic-links/android.md) and [iOS](https://docs.dashlink.ai/guides/app-dynamic-links/ios.md) 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

| You have | Use |
| - | - |
| App installed, Dynamic Link host declared, OS verified | The OS delivers the short URL. Forward it to `handleUniversalLink`. |
| First open after a store install from a Dynamic Link | Call `getDynamicLink()` at startup. Android reads Play Install Referrer. iOS reads the pasteboard. |
| Later launches | Deferred is not re-run. |

`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

```yaml theme={null}
dependencies:
  dashlink: ^1.0.0
```

Also add the native SDKs:

```kotlin theme={null}
implementation("ai.dashlink:dashlink-android:1.0.0")
```

iOS: the plugin podspec pulls `pod 'Dashlink', '~> 1.0.0'`.

## Dynamic Link API key

JSON resolve requires a **Dynamic Link** key. REST keys (`dlk_live_`) are rejected.

```dart theme={null}
await Dashlink.configure('dlk_sdk_…');
await Dashlink.setDynamicLinkHosts(['yourbrand.dshl.in']);
```

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](https://docs.dashlink.ai/guides/app-dynamic-links/app-association.md).

## Live taps

Forward every URL from the app-links stream (or `uni_links`) into `handleUniversalLink`.

```dart theme={null}
final pending = await Dashlink.handleUniversalLink(url);
pending?.appUrl; // navigate
```

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`.

```dart theme={null}
final pending = await Dashlink.getDynamicLink();
pending?.appUrl;
pending?.isDeferred;
pending?.clickId;
```

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](https://docs.dashlink.ai/guides/app-dynamic-links/app-association.md), not the plugin.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.