Deeplink定义
deeplink是用于设置一个web链接,将链接嵌入到web页面中,当用户点击外部链接时由浏览器对链接进行解析并打开自己的项目APP,并跳转到APP内特定界面。
Deeplink设置
配置文件配置
配置AndroidManifest.xml文件,在Activity中设置<intent-filter>,并填充必要的属性,示例代码如下:
<activity
android:name=".DeepLinkActivity"
android:noHistory="true">
<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:host="@string/deeplink_host"
android:scheme="@string/deeplink_scheme"/>
</intent-filter>
</activity>
- 声明action为action.VIEW确保能够应用能够接受到deeplink请求。
- deeplink样式和URL样式相同,如示例代码中的deeplink就是scheme://host。
- 如果包含有多个deeplink,则可以声明多个intent-filter,变更启动的data配置即可。
代码中判断和实现deeplink
- 我们可以将项目内的deeplink封装在独立的Activity中,deeplink的判断爱Activity中完成。
- 通过对URI的解析确定deeplink对应的地址应该执行的操作,如:
var data = intent.data
if (data?.host != null) {
when (data.host) {
getString(R.string.deeplink_host) -> {
toTargetPage()
}
else -> {
finish()
}
}
} else
finish()
通过intent 获取到对应的URI并进行host,path等具体的解析完成特定的跳转。
Deeplink adb测试
为了能够更加快速方便的测试deeplink是否起到了对应的效果,我们可以采用adb指令的方式来快速访问deeplink。
adb指令
adb指令的格式为
adb shell am start -W -a android.intent.action.VIEW -d "具体的deeplink地址" packageName
示例如下:
adb shell am start -W -a android.intent.action.VIEW -d "scheme://host" com.example.deeplinkdemo
Uri结构和Deeplink进一步应用
uri的详细结构如下:
[scheme:][//host:port][path][?query][#fragment]
Deeplink主要是通过具体的Uri跳转到APP内部特定的页面,因此其核心内容是URI结构内容,可以通过URI结构设置特定的参数,然后通过这些特定的参数达到能够传递特殊参数的效果或者目的,此处便不再展示。
备注
本篇内容只是展示的最简单的deeplink开发和使用,URI方面更是采用了最简单的格式进行说明。
GitHub demo地址