Configure verification objects

​

Android App Links Verification

Android App Links allow your app to become the default handler for a specific website’s URLs. This requires proper verification of your domain ownership.

​

Step 1: Create the Digital Asset Links JSON File

Create a file named assetlinks.json with the following content:

[
    {
        "relation": ["delegate_permission/common.handle_all_urls"],
        "target": {
            "namespace": "android_app",
            "package_name": "your.package.name",
            "sha256_cert_fingerprints": ["SHA-256:XX:XX:XX:..."]
        }
    }
]

Replace:

• your.package.name with your actual Android package name
• SHA-256:XX:XX:XX:... with your app’s SHA-256 fingerprint

​

Step 2: Get Your App’s SHA-256 Fingerprint

To obtain your app’s SHA-256 fingerprint:

1. For debug builds, use:

   keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
   

2. For release builds, use your release keystore:

   keytool -list -v -keystore your_release_keystore.keystore -alias your_key_alias
   

3. Look for the “SHA-256 Certificate fingerprint” line in the output

​

iOS Universal Links Verification

Universal Links allow iOS to open your app when users tap links to your website.

​

Step 1: Create an Apple App Site Association File

Create a file named apple-app-site-association (with no file extension) with the following content:

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "TEAM_ID.BUNDLE_ID",
                "paths": ["*"]
            }
        ]
    }
}

Replace:

• TEAM_ID with your Apple Developer Team ID
• BUNDLE_ID with your app’s bundle identifier

The paths array can be customized to include only specific paths that your app should handle. Use * to handle all paths.

​

Step 2: Find Your Team ID and Bundle ID

1. Your Team ID can be found in the Apple Developer Portal under Membership Details
2. Your Bundle ID is in your Xcode project settings

​

Step 3: Host the JSON File

Upload the apple-app-site-association file to your server at:

https://your-domain.com/.well-known/apple-app-site-association

Make sure it’s accessible via HTTPS and has the correct Content-Type header (application/json).

​

Step 4: Configure Your App

In Xcode:

1. Open your project settings
2. Go to “Signing & Capabilities”
3. Add the “Associated Domains” capability
4. Add applinks:your-domain.com to the domains list

For more details, see the official Apple documentation.

​

Testing Deep Link Verification for Android

1. Install the app on a device
2. Open a link to your verified domain in a browser
3. The app should open automatically without prompting

Alternatively, use adb to test:

adb shell am start -a android.intent.action.VIEW -d "https://your-domain.com/path" your.package.name

​

Troubleshooting for Android

1. App doesn’t open automatically:

   • Ensure your assetlinks.json file is correctly formatted
   • Verify the SHA-256 fingerprint matches your app signing key
   • Make sure the file is accessible via HTTPS

2. Verification warnings in logcat:

   • Look for “IntentFilterIntentSvc” messages in logcat for details on verification failures

​

Testing Deep Link Verification for iOS

1. Install the app on a device
2. Open Safari and navigate to your verified domain
3. The app should open automatically

Alternatively, use the iOS Simulator:

xcrun simctl openurl booted "https://your-domain.com/path"

​

Troubleshooting for iOS

1. App doesn’t open with Universal Links:

   • Ensure your apple-app-site-association file is correctly formatted
   • Verify Team ID and Bundle ID are correct
   • Make sure the file is accessible via HTTPS
   • Check that the Associated Domains capability is enabled

2. Debug Universal Links:

   • Connect your device to a Mac
   • Open Console.app and filter for “swcd” to see Universal Links logs