Prerequisites
Before implementing deep linking, enable Web App Synchronization in the Despia Editor:
-
Navigate to Add-ons → Hardcoded
-
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
Host the Digital Asset Links File
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 Release → Setup → App 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
For additional support or questions, please contact our support team at support@despia.com