测试应用链接

在实现应用链接功能时，您应该测试链接功能，以确保系统能够将您的应用和网站相关联，并按预期方式处理网址请求。

如需测试现有语句文件，您可以使用语句列表生成器和测试器工具。

以下部分介绍了如何手动测试您的应用链接验证。如果您愿意，也可以通过 Play 深层链接工具或 Android Studio App Links Assistant 测试验证。

确认需要验证的主机列表

测试时，您应该对系统需要针对您的应用验证的已关联主机列表进行确认。创建一个列表，在其中列出所有相关网址，此类网址对应的 intent 过滤器包含以下属性和元素：

  • android:scheme 属性，值为 http 或 https
  • 具有网域网址格式的 android:host 属性
  • android.intent.action.VIEW 操作元素
  • android.intent.category.BROWSABLE 类别元素

使用此列表检查每个指定的主机和子网域上是否提供了 Digital Asset Links JSON 文件。

确认 Digital Asset Links 文件

对于每个网站，使用 Digital Asset Links API 确认是否已正确托管和定义 Digital Asset Links JSON 文件：

https://digitalassetlinks.googleapis.com/v1/statements:list?
   source.web.site=https://<var>domain.name</var>:<var>optional_port</var>&amp;
   relation=delegate_permission/common.handle_all_urls

对于动态应用链接，您还可以检查关系扩展。

https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://www.example.com&relation=delegate_permission/common.handle_all_urls&return_relation_extensions=true

您可以在测试过程中检查系统当前的链接处理设置。使用以下命令获取已连接设备上所有应用的现有链接处理政策列表：

adb shell dumpsys package domain-preferred-apps

以下命令会执行相同的操作：

adb shell dumpsys package d

该命令会返回设备上定义的每个用户或个人资料的清单，前面带有以下格式的标头：

App linkages for user 0:

在此标头后面，输出会使用以下格式列出相应用户的链接处理设置：

Package: com.android.vending
Domains: play.google.com market.android.com
Status: always : 200000002

此列表可以指示对于此用户，哪些应用与哪些网域相关联：

  • Package - 以软件包名称标识应用，与应用清单文件中声明的内容一致。
  • Domains - 显示相关主机的完整列表，该应用处理此类主机的网络链接，使用空格作为分隔符。
  • Status - 显示该应用的现有链接处理设置。已通过验证并且清单文件中包含 android:autoVerify="true" 的应用会显示 always 状态。此状态后的十六进制数字与 Android 系统的用户应用链接偏好设置记录有关。此值并不指示验证是否成功。

测试示例

为了让应用链接验证成功，系统必须能够针对您在符合应用链接标准的指定 intent 过滤器中指定的每个网站验证您的应用。以下示例展示了定义多个应用链接的清单配置：

<activity android:name=”MainActivity”>
        <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" />
            <data android:scheme="https" />
            <data android:host="www.example.com" />
            <data android:host="mobile.example.com" />
        </intent-filter>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="https" />
            <data android:host="www.example2.com" />
        </intent-filter>
    </activity>

    <activity android:name=”SecondActivity”>
        <intent-filter>
            <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" />
            <data android:host="account.example.com" />
        </intent-filter>
    </activity>

      <activity android:name=”ThirdActivity”>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <data android:scheme="https" />
            <data android:host="map.example.com" />
        </intent-filter>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="market" />
            <data android:host="example.com" />
        </intent-filter>
      </activity>

</application>

对于上述清单，平台会尝试验证以下主机：

www.example.com
mobile.example.com
www.example2.com
account.example.com

对于上述清单，平台不会尝试验证以下主机：

map.example.com (it does not have android.intent.category.BROWSABLE)
market://example.com (it does not have either an "http" or "https" scheme)

如需详细了解语句列表，请参阅创建语句列表