Android Deeplink未注册：浏览器直接加载URL而非唤起应用

我希望我的Android应用能通过LinksActivity打开类似mysite.com/users/12345的URL，目前仅需记录Intent中的所有信息。但通过Android Studio发送测试URL或在浏览器打开该URL时，只会加载页面的404错误。

我已在网站添加.well-known/assetlinks.json文件，不确定SHA密钥是否正确，但即使改为无归属的URL也无法正常工作，且Debug和Release版本均无效。

AndroidManifest.xml #

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:tools="http://schemas.android.com/tools"
    xmlns:android="http://schemas.android.com/apk/res/android">
<application
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/Theme.ValuesRank">
    <activity
        android:name=".ui.links.LinksActivity"
        android:exported="true">
        <tools:validation testUrl="https://mywebsite.com/users" />
        <intent-filter android:autoVerify="true">
            <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="raderie.me"
                android:pathPrefix="/users" />
        </intent-filter>
    </activity>
    <activity
        android:name=".ui.share.ShareActivity"
        android:exported="false">
        <meta-data
            android:name="android.app.lib_name"
            android:value="" />
    </activity>
    <activity android:name=".ui.results.ResultsActivity" />
    <activity
        android:name=".ui.main.MainActivity"
        android:exported="true">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>
</manifest>

LinksActivity.kt #

import android.content.Intent
import android.net.Uri
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.airbnb.deeplinkdispatch.DeepLink
import com.orhanobut.logger.Logger
import org.clarkecollective.raderie.R

class LinksActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_links)
  }

  override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    handleIntent(intent)
  }

  private fun handleIntent(intent: Intent) {
    val appLinkAction = intent.action
    val appLinkData: Uri? = intent.data

    Logger.d("App Link Action: %s\nApp Link Data: %s", appLinkAction, appLinkData)
  }
}

mysite.com/.well-known/assetlinks.json #

[{
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target" : { "namespace": "android_app", "package_name": "org.site.mypackagename",
                 "sha256_cert_fingerprints": ["The SHA for the Release Package is here"] }
  }, {
         "relation": ["delegate_permission/common.handle_all_urls"],
         "target" : { "namespace": "android_app", "package_name": "org.site.mypackagename",
                      "sha256_cert_fingerprints": ["The SHA for the Debug Package is here"] }
       }]

核心排查与修复点 #

1. 域名匹配错误
   你Manifest中Intent Filter的android:host="raderie.me"，但测试用的是mysite.com，两者完全不匹配，这是无法唤起App的直接原因。需将host改为实际测试域名，或使用raderie.me/users/12345进行测试。

2. assetlinks.json 关键信息不匹配

   • package_name与应用实际包名不符：代码中应用包名是org.clarkecollective.raderie，但assetlinks里写的是org.site.mypackagename，必须完全一致。
   • SHA256指纹需准确获取：
     • Debug版本：通过Android Studio右侧Gradle面板，执行app > Tasks > android > signingReport获取SHA-256值
     • Release版本：使用命令keytool -list -v -keystore 你的签名文件.jks -alias 你的别名获取
   • 确保该文件可通过HTTPS访问，且返回的Content-Type为application/json，无404错误。

3. Intent处理逻辑遗漏
   当前代码仅在onNewIntent中处理Intent，但首次启动Activity时，Intent是通过onCreate传递的，需在onCreate中补充调用handleIntent(intent)：

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(R.layout.activity_links)
       handleIntent(intent) // 新增此行
   }
   

4. 正确测试方式

   • 优先使用adb命令测试，避免浏览器 fallback 影响：

     adb shell am start -W -a android.intent.action.VIEW -d "https://你的域名.com/users/12345" org.clarkecollective.raderie
     

   • Android Studio测试工具需确保测试URL与Intent Filter的host、pathPrefix完全匹配。

5. 网站路径可用性
   若App Links验证失败，系统会跳转至网页，此时404说明网站/users/12345路径不存在。需确保该路径可正常访问（哪怕返回空白页），或调整网站路由配置。

内容的提问来源于stack exchange，提问作者Paxana Non Grata