Android深度链接 Deep Links 和 App Links

前言

要想从浏览器或者从其它APP中直接打开我们的APP，增加我们APP的曝光度，我们需要使用Android的深度链接技术Deep Links 或 App Links

Deep Links

这里先展示下Deep Links的效果

DeepLinkScheme.gif

Deep Links实现

1. 在AndroidManifest中添加Intent Filters

下面的XML片段将链接这些URIs:

        <activity ...>

            <intent-filter>
                <!-- action 和category 必须这样写！！！ -->
                <action android:name="android.intent.action.VIEW"/>
                <category android:name="android.intent.category.DEFAULT"/>
                <category android:name="android.intent.category.BROWSABLE"/>
                <!-- 接受以 "http://yaoyi.ypzdw.com/article" 或 "https://yaoyi.ypzdw.com/article"开头的URIs -->
                <data android:scheme="http"/>
                <data android:scheme="https"/>
                <data android:host="yaoyi.ypzdw.com"/>
                <!-- android:pathPrefix="/article" 这里表示匹配Path以“/article”开头的uri，可以不写-->
                <data android:pathPrefix="/article"/>
                <!-- 注意 "/" 在pathPrefix中是必须的-->
            </intent-filter>

            <intent-filter>
                <!-- action 和category 必须这样写！！！ -->
                <action android:name="android.intent.action.VIEW"/>
                <category android:name="android.intent.category.DEFAULT"/>
                <category android:name="android.intent.category.BROWSABLE"/>
                <!-- 这里采用的是自定义Scheme -->
                <!-- 接受以 "com.ypzdw.zdb://article"开头的URIs  -->
                <data
                    android:host="article"
                    android:scheme="com.ypzdw.zdb"/>
            </intent-filter>
        </activity>

一旦我们在AndroidManifest中添加了以上Intent Filters，Android就可以在运行时路由任何满足匹配条件的Intent

2. Activity中解析Intents
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

    Uri uri = getIntent().getData();
    //Uri 规则: scheme://host+path?query
    //这里以“https://yaoyi.ypzdw.com/article/413?type=url&from=web”为例
    String scheme = uri.getScheme(); //https , "://" 这个前面的就表示scheme
    String host = uri.getHost(); //yaoyi.ypzdw.com
    String path = uri.getPath(); //article/413
    String query = uri.getQuery(); //type=mobile&from=web
    String type = uri.getQueryParameter("type"); //url
    L.d(getTag(), "scheme = " + scheme + ", host = " + host + ", path = " + path + ", query = " + query+", type = " + type);
}

下面是打印的Log

深度链接Activity解析Log.png

测试Deep Links

$ adb shell am start \
        -W -a android.intent.action.VIEW \
        -d <URI> <PACKAGE>

例:

$ adb shell am start
        -W -a android.intent.action.VIEW \
        -d "com.ypzdw.zdb://article" com.ypzdw.yaoyi \

Deep Links 遇到的坑

  1. scheme为htttp/https 开头的uri，在有的浏览器或者手机ROM中并不能链接至APP，而是在浏览器中打开了对应的链接。所以做Deep Links时建议全部采用自定义Scheme的形式。

  2. 在询问是否用APP打开对应的链接时，如果选择了“取消”并且“记住选择”被勾上，那么下次你再次想链接至APP时就不会有任何反应!!!

  3. 不同的host不要写在同一个Intent Filter中，最好为每种匹配规则新建一个Intent Filter

App Links

使用Deep Links 有时会让用户感到迷惑，因为会弹出一个对话框让用户选择是否在APP中打开。
Android在Android 6.0 (API level 23) 及以后加入了App Links , 当用户点击对应的URI 时，会直接启动对应的APP，不会再有对话框出现

App Links实现

1. 在AndroidManifest中添加Intent Filters
<activity ...>

    <intent-filter android:autoVerify="true">
        <!-- action 和category 必须这样写！！！ -->
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="yaoyi.ypzdw.com" />
        <data android:scheme="https" android:host="yaoyi.ypzdw.com" />
    </intent-filter>

</activity>

这里的Intent Filter和Deep Links 有点像，但是要注意，这里的Scheme只能用 http/https或者两个都用，但是 不能使用自定义的scheme！不能使用自定义的scheme！不能使用自定义的scheme！重要的事说三遍
android:autoVerify="true" 这句会让APP自动在所列的host中去验证，如果验证成功，APP将成为匹配URI默认打开方式

2.配置 assetlinks.json
2.1生成assetlinks.json

你也可以访问https://developers.google.com/digital-asset-links/tools/generator ，然后填写host,包名，fingerprint，然后点击Generate Statement生成assetlinks.json

生成assetlinks.json.gif
2.2 手动添加 assetlinks.json

如果你的梯子不够高，也没关系，可以手动添加assetlinks.json
我们需要改的就是 sha256_cert_fingerprints 和 package_name
格式如下：

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
}]

这个json的命名必须为assetlinks.json！！！ 之前看见有人说这个名字可以随便取为XXX.json，经验证这完全是行不通的！！！，这个名字必须是assetlinks.json！！！ 此处省略3000字~

2.3 获取sha256_cert_fingerprints
$ keytool -list -v -keystore my-release-key.keystore
2.4 部署assetlinks.json

如上，我们的host为yaoyi.ypzdw.com，那么我们就需将assetlinks.json放到 https://yaoyi.ypzdw.com/.well-known/assetlinks.json

2.5 检查服务器上assetlinks.json是否可访问

还是在上面的链接里，填上该有的信息，然后点击 Test Statement

验证assetlinks.json.gif

如果下面提示Success, 那么就可以访问，Android会在我们的APP启动后自动去访问这个地址，然后进行验证

你也可以通过访问下面来检查
https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://<domain1>:<port>&relation=delegate_permission/common.handle_all_urls

如果成功将显示你配置的assetlinks.json内容

例:
https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://yaoyi.ypzdw.com&relation=delegate_permission/common.handle_all_urls

3.测试 web URI intent
adb shell am start -a android.intent.action.VIEW \
    -c android.intent.category.BROWSABLE \
    -d "http://<domain1>:<port>"

<port>端口为可选项

例

adb shell am start -a android.intent.action.VIEW \
    -c android.intent.category.BROWSABLE \
    -d "http://yaoyi.ypzdw.com"
4.Activity中解析Intents

这里和DeepLink是一样的

5.多域名情况
5.1 AndroidManifest
<activity ...>
    <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="http" android:host="yaoyi.ypzdw.cn" />
      <data android:scheme="https" android:host="yaoyi.ypzdw.com" />
    </intent-filter>
  </activity>
5.2 部署assetlinks.json

我们有几个域名，就需要部署几个assetlinks.json
如上，我们有两个域名，就需要把assetlinks.json部署在https://yaoyi.ypzdw.com/.well-known/assetlinks.json
和 http://yaoyi.ypzdw.cn/.well-known/assetlinks.json
假如有一个域名没有验证成功，那么App Link是不会生效的

路径格式如下
https://domain[:optional_port]/.well-known/assetlinks.json

6.多子域名情况

和多域名是类似的，假如我们的域名是yaoyi.ypzdw.com 和 mobile.ypzdw.com ，那么，我们必须部署assetlinks.json在 https://yaoyi.ypzdw.com/.well-known/assetlinks.json
和 https://mobile.ypzdw.com/.well-known/assetlinks.json

7. 多APP情况

如果多个APP都链接相同的域名，那么我们的assetlinks.json将这样写

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
}
{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.another",
    "sha256_cert_fingerprints":
    ["FF:15:CB:89:51:FD:8E:C9:5D:25:17:D2:2F:32:B6:12:19:09:12:B6:D9:BB:94:FC:37:CA:3A:48:A6:49:8C:9C"]
  }
}]
8.检查link策略
adb shell dumpsys package domain-preferred-apps
 --or--
adb shell dumpsys package d

注意：在你安装APP后至少等待20秒，这是为了让系统去完成验证（就是系统自动会去访问你App links配置的各域名的assetslinks，检查下是否存在该文件，并且里面fingerprints是否和你app的一致，注意，不同的签名，fingerprints是不一样的），如果验证成功，你的APP就会成为默认的URI启动项

你会得到类似下面的输出结果

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

上面表示包名为“com.android.vending”的APP，会链接“play.google.com” 和“market.android.com”两个域名的URI

参考

Deep Links: https://developer.android.com/training/app-indexing/deep-linking.html
App Links: https://developer.android.com/training/app-links/index.html

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 212,222评论 6赞 493
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 90,455评论 3赞 385
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 157,720评论 0赞 348
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 56,568评论 1赞 284
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 65,696评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,879评论 1赞 290
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,028评论 3赞 409
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,773评论 0赞 268
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,220评论 1赞 303
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,550评论 2赞 327
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,697评论 1赞 341
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,360评论 4赞 332
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,002评论 3赞 315
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,782评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,010评论 1赞 266
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 46,433评论 2赞 360
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 43,587评论 2赞 350

推荐阅读更多精彩内容