Добавить объявление

Deeplinks во Flutter: настройка для Android и iOS

Диплинки позволяют открывать приложение по ссылке - перешел по URL и сразу попал на нужный экран. Смена пароля по ссылке из письма, открытие конкретного видео или поста, переход на карточку товара по ссылке - все это работает через deeplinks. Во Flutter нет единого решения, потому что механизм завязан на платформу. Придется настраивать Android и iOS отдельно, но это не так страшно, как кажется.

Для обработки ссылок внутри Flutter удобнее всего использовать пакет app_links. Он официально поддерживается, работает на всех платформах.

Добавляем пакет в проект:


Для добавления пакета в проект можно выполнить команду в терминале:

flutter pub add app_links

Либо добавить следующую строку в блок dependencies в файле pubspec.yaml:

app_links: ^7.1.1

Настройка для Android:


В файле android/app/src/main/AndroidManifest.xml внутри <activity> нужно добавить intent-filter. Это правило, которое говорит системе что нужно обрабатывать ссылки такого вида.

<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="https" android:host="your-domain.com" />
</intent-filter>

Если используете кастомную схему (не http/https), укажите ее вместо https.


App Links (https):

Для автоматического открытия ссылок в приложении нужно:

  • Указать android:autoVerify="true" в intent-filter.

  • Разместить файл assetlinks.json на сервере в папке .well-known (домен должен совпадать с указанным в intent-filter).

Пример файла assetlinks.json:

[
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.yourapp",
"sha256_cert_fingerprints": [
"ваш SHA256 отпечаток"
]
}
}
]

SHA256 можно получить из Google Play Console или сгенерировать через keytool.

Настройка для iOS:



Custom scheme:

Добавьте схему в Xcode: откройте Info.plist как исходный код и добавьте:

CFBundleURLTypes


CFBundleURLSchemes

myapp




Universal Links (https):

Нужно:

  • Включить Associated Domains в Capabilities проекта Xcode.

  • Добавить applinks:your-domain.com.

  • Разместить файл apple-app-site-association на сервере в папке .well-known.

Пример файла apple-app-site-association:

{
"applinks": {
"apps": [],
"details": [
{
"appID": "TEAMID.com.example.yourapp",
"paths": ["*"]
}
]
}
}

TEAMID можно найти в Apple Developer Account.

Обработка диплинков в Flutter:


Создадим сервис для работы с диплинками:

import 'package:app_links/app_links.dart';

class DeepLinkService {
static final AppLinks _appLinks = AppLinks();
static StreamSubscription<Uri>? _subscription;

// Ссылка, которая запустила приложение (холодный старт)
static Future<Uri?> getInitialLink() async {
return await _appLinks.getInitialLink();
}

// Поток ссылок, когда приложение уже открыто
static Stream<Uri> get linkStream => _appLinks.uriLinkStream;

static void dispose() {
_subscription?.cancel();
}
}

Инициализация перед runApp:


void main() async {
WidgetsFlutterBinding.ensureInitialized();

// Запоминаем ссылку, если приложение запустили по ней
final initialLink = await DeepLinkService.getInitialLink();

runApp(MyApp(initialLink: initialLink));
}

В корневом виджете подписываемся на поток ссылок:


class MyApp extends StatefulWidget {
final Uri? initialLink;
const MyApp({super.key, this.initialLink});

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

class _MyAppState extends State<MyApp> {
@override
void initState() {
super.initState();

// Обрабатываем ссылку при холодном старте
if (widget.initialLink != null) {
_handleDeepLink(widget.initialLink!);
}

// Слушаем ссылки, когда приложение уже работает
DeepLinkService.linkStream.listen((uri) {
_handleDeepLink(uri);
});
}

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

if (segments.isNotEmpty && segments[0] == 'product') {
final id = segments.length > 1 ? segments[1] : null;
navigatorKey.currentState?.pushNamed('/product', arguments: {'id': id});
} else if (segments.isNotEmpty && segments[0] == 'profile') {
navigatorKey.currentState?.pushNamed('/profile');
}
}

@override
void dispose() {
DeepLinkService.dispose();
super.dispose();
}

@override
Widget build(BuildContext context) {
return MaterialApp(
navigatorKey: navigatorKey,
initialRoute: '/',
routes: {
'/': (context) => HomePage(),
'/product': (context) => ProductPage(),
'/profile': (context) => ProfilePage(),
},
);
}
}

Вывод:


Диплинки во Flutter настраиваются в несколько этапов: правим манифест на Android, добавляем entitlements на iOS, кладем файлы на сервер, а в коде используем app_links для получения ссылок и Navigator для переходов. app_links берет на себя всю сложность получения deeplink на обеих платформах. Вам остается только подписаться на поток и написать логику переходов.

После правильной настройки приложение будет корректно открываться по ссылкам из писем, мессенджеров или браузера. Главное не забыть протестировать все сценарии и убедиться, что файлы assetlinks.json и apple-app-site-association доступны по правильным адресам.
02.06.2026 118 531