Android App Links let your Flutter app handle HTTPS links without showing a disambiguation dialog. When a user taps a link to your domain, the app opens directly. This guide covers the Android-specific configuration for App Links in Flutter apps.<\/p>\n\n\n\n
For the full Flutter deep linking setup (including iOS), see Flutter Deep Linking: Complete Setup Tutorial<\/a>. For go_router integration, see Flutter go_router Deep Links<\/a>. For the Android fundamentals, see Android App Links: Complete Implementation Guide<\/a>.<\/p>\n\n\n\n Android has two types of link handling:<\/p>\n\n\n\n Deep Links<\/strong> (basic): Use App Links<\/strong> (verified): Use Always use App Links for production. Deep Links without verification are only appropriate for development and testing.<\/p>\n\n\n\n Open If your links come from multiple domains:<\/p>\n\n\n\n Note: each domain you add requires its own To handle only specific paths (not all URLs on the domain):<\/p>\n\n\n\n Available path matching options:<\/p>\n\n\n\n Your domain must serve a verification file at:<\/p>\n\n\n\n If using Tolinku, the assetlinks.json is generated automatically when you configure your Appspace with your package name and SHA-256 fingerprints.<\/p>\n\n\n\n Debug keystore:<\/strong><\/p>\n\n\n\n Release keystore:<\/strong><\/p>\n\n\n\n Google Play App Signing:<\/strong>\nIf you use Google Play's app signing feature (recommended), Google re-signs your APK with their own key. You need both:<\/p>\n\n\n\n Include both in your assetlinks.json:<\/p>\n\n\n\n Check that the file is accessible and valid:<\/p>\n\n\n\n Use Google's Digital Asset Links tool<\/a> to validate the file against your app.<\/p>\n\n\n\n With If you need access to the full URL (including the host), use the After installing your app, check that Android has verified the domain:<\/p>\n\n\n\n The output shows the verification status for each domain:<\/p>\n\n\n\n If it shows If the app opens directly (no disambiguation dialog), App Links are working.<\/p>\n\n\n\n The most common issue: you test with a debug build (which uses the debug keystore) but your assetlinks.json only has the release fingerprint. Include both fingerprints during development.<\/p>\n\n\n\n For the cross-platform perspective, see Cross-Platform Deep Linking Guide<\/a>. For the Tolinku Flutter SDK, see the Flutter SDK docs<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":" Set up Android App Links for Flutter apps. Configure intent filters, verify Digital Asset Links, and handle deep link routing in Dart.<\/p>\n","protected":false},"author":2,"featured_media":901,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"rank_math_title":"App Links in Flutter: Android Configuration Guide","rank_math_description":"Set up Android App Links for Flutter apps. Configure intent filters, verify Digital Asset Links, and handle deep link routing in Dart.","rank_math_focus_keyword":"Flutter app links","rank_math_canonical_url":"","rank_math_facebook_title":"","rank_math_facebook_description":"","rank_math_facebook_image":"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/og-flutter-app-links.png","rank_math_facebook_image_id":"","rank_math_twitter_title":"","rank_math_twitter_description":"","rank_math_twitter_image":"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/og-flutter-app-links.png","footnotes":""},"categories":[15],"tags":[25,23,179,20,35,57,184,69],"class_list":["post-902","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-engineering","tag-android","tag-app-links","tag-dart","tag-deep-linking","tag-digital-asset-links","tag-flutter","tag-intent-filters","tag-mobile-development"],"_links":{"self":[{"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/posts\/902","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/comments?post=902"}],"version-history":[{"count":1,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/posts\/902\/revisions"}],"predecessor-version":[{"id":903,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/posts\/902\/revisions\/903"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/media\/901"}],"wp:attachment":[{"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/media?parent=902"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/categories?post=902"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tolinku.com\/blog\/wp-json\/wp\/v2\/tags?post=902"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}How App Links Differ from Deep Links<\/h2>\n\n\n\n
intent-filter<\/code> without autoVerify<\/code>. When the user taps a matching link, Android shows a dialog asking which app should open it. Other apps can also claim the same URLs.<\/p>\n\n\n\nintent-filter<\/code> with android:autoVerify="true"<\/code>. Android verifies that you own the domain by checking \/.well-known\/assetlinks.json<\/code>. Once verified, your app opens directly with no dialog.<\/p>\n\n\n\nStep 1: Configure AndroidManifest.xml<\/h2>\n\n\n\n
android\/app\/src\/main\/AndroidManifest.xml<\/code> and add intent filters to your main activity:<\/p>\n\n\n\n<activity\n android:name=".MainActivity"\n android:exported="true"\n android:launchMode="singleTop"\n android:theme="@style\/LaunchTheme"\n android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"\n android:hardwareAccelerated="true"\n android:windowSoftInputMode="adjustResize">\n\n <!-- Flutter deep linking metadata -->\n <meta-data\n android:name="flutter_deeplinking_enabled"\n android:value="true" \/>\n\n <!-- Default Flutter intent filter -->\n <intent-filter>\n <action android:name="android.intent.action.MAIN"\/>\n <category android:name="android.intent.category.LAUNCHER"\/>\n <\/intent-filter>\n\n <!-- App Links (verified) -->\n <intent-filter android:autoVerify="true">\n <action android:name="android.intent.action.VIEW" \/>\n <category android:name="android.intent.category.DEFAULT" \/>\n <category android:name="android.intent.category.BROWSABLE" \/>\n <data\n android:scheme="https"\n android:host="go.yourapp.com" \/>\n <\/intent-filter>\n<\/activity>\n<\/code><\/pre>\n\n\n\nKey Attributes<\/h3>\n\n\n\n
\n
android:autoVerify="true"<\/code><\/strong>: Triggers Android's domain verification process. Without this, links show a disambiguation dialog.<\/li>\nandroid:launchMode="singleTop"<\/code><\/strong>: Reuses the existing activity when a link is tapped while the app is already running. Without this, a new activity is created, and the deep link may not reach your Dart code.<\/li>\nflutter_deeplinking_enabled<\/code><\/strong>: Tells Flutter's engine to forward incoming URLs to your Dart router automatically.<\/li>\n<\/ul>\n\n\n\nMultiple Domains<\/h3>\n\n\n\n
<intent-filter android:autoVerify="true">\n <action android:name="android.intent.action.VIEW" \/>\n <category android:name="android.intent.category.DEFAULT" \/>\n <category android:name="android.intent.category.BROWSABLE" \/>\n <data android:scheme="https" android:host="go.yourapp.com" \/>\n <data android:scheme="https" android:host="links.yourapp.com" \/>\n<\/intent-filter>\n<\/code><\/pre>\n\n\n\nassetlinks.json<\/code> file.<\/p>\n\n\n\nPath Restrictions<\/h3>\n\n\n\n
<intent-filter android:autoVerify="true">\n <action android:name="android.intent.action.VIEW" \/>\n <category android:name="android.intent.category.DEFAULT" \/>\n <category android:name="android.intent.category.BROWSABLE" \/>\n <data\n android:scheme="https"\n android:host="go.yourapp.com"\n android:pathPrefix="\/product" \/>\n <data\n android:scheme="https"\n android:host="go.yourapp.com"\n android:pathPrefix="\/invite" \/>\n<\/intent-filter>\n<\/code><\/pre>\n\n\n\n\n
android:path="\/exact\/path"<\/code> – Exact match<\/li>\nandroid:pathPrefix="\/prefix"<\/code> – Starts with<\/li>\nandroid:pathPattern="\/product\/.*"<\/code> – Regex pattern<\/li>\n<\/ul>\n\n\n\nStep 2: Digital Asset Links (assetlinks.json)<\/h2>\n\n\n\n
https:\/\/go.yourapp.com\/.well-known\/assetlinks.json\n<\/code><\/pre>\n\n\n\nFile Content<\/h3>\n\n\n\n
[{\n "relation": ["delegate_permission\/common.handle_all_urls"],\n "target": {\n "namespace": "android_app",\n "package_name": "com.yourapp",\n "sha256_cert_fingerprints": [\n "AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99"\n ]\n }\n}]\n<\/code><\/pre>\n\n\n\nGetting Your SHA-256 Fingerprint<\/h3>\n\n\n\n
keytool -list -v -keystore ~\/.android\/debug.keystore -alias androiddebugkey -storepass android\n<\/code><\/pre>\n\n\n\nkeytool -list -v -keystore \/path\/to\/your\/release.keystore -alias your-alias\n<\/code><\/pre>\n\n\n\n\n
[{\n "relation": ["delegate_permission\/common.handle_all_urls"],\n "target": {\n "namespace": "android_app",\n "package_name": "com.yourapp",\n "sha256_cert_fingerprints": [\n "YOUR:UPLOAD:KEY:FINGERPRINT",\n "GOOGLE:SIGNING:KEY:FINGERPRINT"\n ]\n }\n}]\n<\/code><\/pre>\n\n\n\nVerification<\/h3>\n\n\n\n
# Accessibility\ncurl -I https:\/\/go.yourapp.com\/.well-known\/assetlinks.json\n\n# Content\ncurl https:\/\/go.yourapp.com\/.well-known\/assetlinks.json | python3 -m json.tool\n<\/code><\/pre>\n\n\n\nStep 3: Handling Links in Dart<\/h2>\n\n\n\n
With go_router (Recommended)<\/h3>\n\n\n\n
final router = GoRouter(\n routes: [\n GoRoute(\n path: '\/',\n builder: (context, state) => const HomeScreen(),\n ),\n GoRoute(\n path: '\/product\/:id',\n builder: (context, state) {\n return ProductScreen(id: state.pathParameters['id']!);\n },\n ),\n GoRoute(\n path: '\/invite\/:code',\n builder: (context, state) {\n return InviteScreen(code: state.pathParameters['code']!);\n },\n ),\n ],\n errorBuilder: (context, state) => const NotFoundScreen(),\n);\n<\/code><\/pre>\n\n\n\nflutter_deeplinking_enabled<\/code> set to true<\/code>, the URL path is automatically forwarded to go_router.<\/p>\n\n\n\nWith app_links Package (For Full URL Access)<\/h3>\n\n\n\n
app_links<\/code> package:<\/p>\n\n\n\nimport 'package:app_links\/app_links.dart';\n\nclass DeepLinkService {\n final AppLinks _appLinks = AppLinks();\n\n void init() {\n _appLinks.uriLinkStream.listen((Uri uri) {\n handleLink(uri);\n });\n\n _appLinks.getInitialLink().then((Uri? uri) {\n if (uri != null) handleLink(uri);\n });\n }\n\n void handleLink(Uri uri) {\n \/\/ Access full URL: uri.host, uri.path, uri.queryParameters\n router.go(uri.path);\n }\n}\n<\/code><\/pre>\n\n\n\nStep 4: Verify App Links<\/h2>\n\n\n\n
On-Device Verification<\/h3>\n\n\n\n
# Check verification status\nadb shell pm get-app-links com.yourapp\n<\/code><\/pre>\n\n\n\ncom.yourapp:\n ID: ...\n Signatures: [...]\n Domain verification state:\n go.yourapp.com: verified\n<\/code><\/pre>\n\n\n\nnone<\/code> or legacy_failure<\/code>, the verification failed. Common causes:<\/p>\n\n\n\n\n
Force Re-Verification<\/h3>\n\n\n\n
# Reset verification state\nadb shell pm set-app-links --package com.yourapp 0 all\n\n# Trigger re-verification\nadb shell pm verify-app-links --re-verify com.yourapp\n<\/code><\/pre>\n\n\n\nTest a Link<\/h3>\n\n\n\n
adb shell am start -a android.intent.action.VIEW \\\n -d "https:\/\/go.yourapp.com\/product\/123" \\\n com.yourapp\n<\/code><\/pre>\n\n\n\nTroubleshooting<\/h2>\n\n\n\n
Disambiguation Dialog Still Appears<\/h3>\n\n\n\n
\n
android:autoVerify="true"<\/code> is on the intent filter<\/li>\nLinks Open in Browser<\/h3>\n\n\n\n
\n
Links Work in ADB but Not from Browser<\/h3>\n\n\n\n
\n
Debug vs Release Fingerprint Mismatch<\/h3>\n\n\n\n
Production Checklist<\/h2>\n\n\n\n
autoVerify=\"true\"<\/code> in AndroidManifest.xml<\/li>flutter_deeplinking_enabled<\/code> metadata set to true<\/code><\/li>launchMode=\"singleTop\"<\/code> on the activity<\/li>\/.well-known\/assetlinks.json<\/code><\/li>adb shell pm get-app-links<\/code><\/li>