Universal Link 介绍
Universal Link是苹果在WWDC 2015上提出的iOS 9的新特性之一。此特性类似于深层链接,并能够方便地通过打开一个Https链接来直接启动您的客户端应用(手机有安装App)。对比起以往所使用的URL Sheme, 这种新特性在实现web-app的无缝链接时能够提供极佳的用户体验。
这具体是一种怎样的情景呢?举个例子,你的用户在微信里面浏览一个你们公司的网页,而此时用户手机也同时安装有你们公司的App ;而universal link 能够使的用户在打开某个详情页时直接打开你的app 并到达app中相应内容的页面,从而实施用户想要的操作(例如查看某条新闻,例如查看某个商品的明细)
以下分别为URL Scheme方式及Universal Link的方式呈现场景恢复的过程
以下为URL Scheme方式: (第一张图是在微信中浏览web,下同)
下面是用Universal Link方式:
通过上述对比得知,Universal Link能够直接从微信中打开App,比起以往的URL Scheme的方式能够大大改善用户体验。
Univerasl Link的准备工作
- 拥有自己的域名,且此域名网站支持https
- 能够上传文件
apple-app-site-association
到自己的域名 - 只支持iOS 9以上
注:可以使用三方服务,MobLink已经帮您完成了上面所有的工作,免费为您提供Universal Link服务。使用MobLink提供的技术方案,无论您是否iOS9以上,都能够助您实现 Web与App 之间的完美交互。
集成步骤
- 开启
Associated Domains
服务
注意:有的app会区分线上包和测试包,不同账号下的都需要设置App ID才行,前往不要忘记。
2.开启Associated Domains
服务
在xcode工程的Capabilities -> Associated Domains
中添加跳转域名,域名的格式为:
applinks:www.example.com
注意:
你的服务器必须支持SSL
Domains可以添加多个
Domains必须以applinks:
开头
3.配置apple-app-site-association
文件,官方文档如下:
{
"applinks": {
"apps": [],
"details": [
{
"appID": "9JA89QQLNQ.com.apple.wwdc",
"paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
},
{
"appID": "ABCD1234.com.apple.wwdc",
"paths": [ "*" ]
}
]
}
}
apps项必须对应一个空的数组
details项对应一个字典的数组,
-
appID对应项由前缀和ID两部分组成,可以在developer中的Identifiers→AppIDs中点击对应的App ID查看。
paths对应域名中的path,用于过滤可以跳转到App的链接,支持通配符
*
,?
以及NOT
进行匹配,匹配的优先级是从左至右依次降低
。建议配置上path,同一公司可能多款app有次需求,不同的path有益于后期的扩展。
最后,需要把配置好的json文件上传到服务器中该域名的根目录下,也就是说,我们可以用GET请求可以获取到这个apple-app-association文件。
当我们的App在设备上第一次运行时,如果支持Associated Domains功能,那么iOS会自动去GET定义的Domain下的apple-app-site-association
文件。
需要留意iOS会先请求 https://domain.com/.well-known/apple-app-site-association
如果此文件请求不到,再去请求 https://domain.com/apple-app-site-association。 所以如果想要避免服务器接收过多GET请求,可以直接把apple-app-site-association放在./well-known/目录下。
4.Appdelegate增加如下代码
#pragma mark Universal Link
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
NSURL *url = userActivity.webpageURL;
// TODO 根据需求进行处理
}
// TODO 根据需求进行处理
return YES;
}
坑
在Safari中点击链接打开App后,会发现App的右上角的navigationBar会有一串网址的链接箭头,
如果你点击了它,它会跳转到Safari,同时系统会默认你选择用Safari来打开该域名的链接,而不用app打开,也就是说下次你再点击该链接,它只会在Safari中打开,不会在App中打开了。
那么如何开启app跳转呢?有两种方法:
第一种,在Safari页面中,手指往下拉一下页面,会显示一个“隐藏”的banner,俗称为 smart banner,右侧有一个button,点击它,就开启App跳转功能了。
第二种,长按跳转链接,底下会弹出一些选项,选择在App中打开,同样可以开启这个功能。
apple-app-site-association
文件注意格式是否正确 中文字符不识别
总结
apple-app-site-association不需要.json后缀。
如果要对没有path的域名进行支持(如:www.163.com),在json文件的paths中用通配符’*’是不行的,需要在paths数组中加入’/’进行匹配。
对json文件的请求仅在App第一次启动时进行,如果此时网络连接出了问题apple会缓存请求,等有网的时候再去请求,而实际测试抓包并没有请求故通用连接会失效。
paths匹配的优先级是从左至右依次降低,但需要明确,否则会出问题。比如"paths":[ "NOT /together/",""],在IOS9.2上path为/together/*都不会跳到App,但是在IOS9.0上会跳到。
iOS 9.2开始,在相同的domain内Universal Links是不work的,必须要跨域才生效
参考文章:
苹果官方文档
mob
iOS的UniversalLink开发总结