Deeplinking

Configure universal links (iOS) and app links (Android) to enable direct app opening from web URLs in your web-native mobile app.

Prerequisites

Before implementing deep linking, enable Web App Synchronization in the Despia Editor:

  1. Navigate to Add-onsHardcoded

  2. Enable Web App Synchronization for your platform (iOS/Android)

iOS Configuration

Host the Apple App Site Association File

Create and host the AASA file at:

/.well-known/apple-app-site-association

File Structure

{
  "applinks": {
    "details": [
      {
        "appIDs": [
          "TEAMID.BUNDLEID"
        ],
        "components": [
          {
            "/": "/*",
            "comment": "Matches any URL path"
          }
        ]
      }
    ]
  }
}

Required Values

  • Bundle ID: Found in Despia Publishing Panel

  • Team ID: Found in Apple Developer account

Android Configuration

Create and host the assetlinks file at:

/.well-known/assetlinks.json

File Structure

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "PACKAGE_NAME",
      "sha256_cert_fingerprints": [
        "SHA256_FINGERPRINT"
      ]
    }
  }
]

Required Values

  • Package Name: Found in Despia Publishing Panel

  • SHA256 Fingerprint: Found in Google Play Console under ReleaseSetupApp Integrity

Important Notes for Both Platforms

  • Files must be served over HTTPS

  • Files must be accessible without redirects

  • Content-Type must be application/json

  • No file extensions for iOS file (apple-app-site-association not .json)

  • Test thoroughly before production deployment

Verification

iOS

  • Use Apple's App Search API Validation Tool

  • Check Safari developer tools for AASA file loading

Android

  • Use Google's Digital Asset Links debugging tool

  • Test with Android App Links Assistant in Android Studio

Need Help?

For additional support or questions, please contact our support team at support@despia.com

Updated on