Universe Link 简介
iOS 9之前,一直使用的是URL Schemes技术来从外部对App进行跳转,但是iOS系统中进行URL Schemes跳转的时候如果没有安装App,会提示无法打开页面的提示。
iOS 9之后起可以使用Universal Links技术进行跳转页面,这是一种体验更加完美的解决方案。
简而言之: Universal Links 是从浏览器或者网页上打开链接跳转到手机上的app。
- 我们在该链接域名根目录配置过的一个链接(直接跳转到我们app);也可以在该链接中放置对应的H5页面(点击H5页面按钮跳转到我们app)。
当用户的点击该链接,只要手机中安装了支持该链接的APP就会直接进入到APP中。如果没有安装APP则会跳转到Safari浏览器中,展示H5页面。对用户来说则是一个无缝跳转的过程。
使用Universal Link(通用链接)跳转的好处
1, 唯一性: 不像自定义的URL Scheme,因为它使用标准的HTTPS协议链接到你的web站点,所以一般不会被其它的APP所声明。另外,URL scheme因为是自定义的协议,所以在没有安装 app 的情况下是无法直接打开的(在Safari中还会出现一个不可打开的弹窗),而Universal Link(通用链接)本身是一个HTTPS链接,所以有更好的兼容性;
2, 安全: 当用户的手机上安装了你的APP,那么系统会去你配置的网站上去下载你上传上去的说明文件(这个说明文件声明了当前该HTTPS链接可以打开那些APP)。因为只有你自己才能上传文件到你网站的根目录,所以你的网站和你的APP之间的关联是安全的;
3, 可变: 当用户手机上没有安装你的APP的时候,Universal Link(通用链接)也能够工作。如果你愿意,在没有安装你的app的时候,用户点击链接,会在safari中展示你网站的内容;
4, 简单: 一个HTTPS的链接,可以同时作用于网站和APP;
5, 私有: 其它APP可以在不需要知道你的APP是否安装了的情况下和你的APP相互通信。
支持Universal Link(通用链接)
先决条件:必须有一个支持HTTPS的域名,并且拥有该域名下上传到根目录的权限(为了上传Apple指定文件)。
配置指定apple-app-site-association文件
apple-app-site-association文件创建编辑其内容
需要创建一个apple-app-site-association文件,必须命名为apple-app-site-association,切记没有后缀。
apple-app-site-association 文件是放到根目录下
https://<fully qualified domain>/.well-known/apple-app-site-association
https://<fully qualified domain>/apple-app-site-association
apple-app-site-association 内容
{
"applinks": {
"apps": [],
"details": [
{
"appID": "TeamID.com.****.***",
"paths": [ "/main/api.html", "/main/api_gobear.html" ]
},
{
"appID": "5NZRFH2H.com.apple.wwdc",
"paths": [ "*"]
}
]
}
}
iOS14 Universal Link隐藏顶部横幅方法
"applinks": { "details": [ { "appIDs": [ "ABCDE12345.com.example.app"], "components": [ { "/": "/main/*", "exclude": true //加这行可以隐藏顶部横幅 } ] } ] }
注意修改之后不会立即生效,生效时间大概在24小时之内。
1,apps:是限制只能在这几个app中使用, 基本是不填写,所以是空数组
2,appID :为teamId.bundle identifier形式,5NZRFH2H就是teamId,com.apple.wwdc是项目identifier。
登陆开发者中心,在Account -> Membership里面可以找到Team ID。
3,details:数组中可以配置多个APP的信息,如果公司内有多个APP需要支持Universal link,则可以直接添加多个
4,paths:设定你的app支持的路径列表,只有这些指定路径的链接,才能被app所处理。的写法代表了可识别域名下所有链接。注意是区分大小写的
5,/app/是自己定义的路径;
上传完后,让上传人员给你一个访问路径,先访问一下,看看是否能够获取到,当你在浏览器中输入这个文件链接后, 出现下图就可以了:
苹果开发者账号配置
注意记得最后要更新下载证书,替换原来的证书
xcode 项目配置
在添加好的 Associated Domains 添加 links
点击加号添加 ,格式是 applinks:+配置的域名
例如: applinks:www.Share.com
可以添加多个
访问 apple-app-site-association 文件路径就是
https://www.Share.com/.well-known/apple-app-site-association
或
https://www.Share.com/apple-app-site-association
注意:
Universal link
的域名和H5页面URL的域名
不可以是同一个,详情请看Universal link同域不能唤起Universal Link
有跨域问题,Universal Link
必须要求跨域,如果不跨域,就不会跳转(iOS 9.2
之后的改动)
假如当前网页的域名是A
,当前网页发起跳转的域名是B
,必须要求B
和A
是不同域名才会触发Universal Link
,如果B
和A
是相同域名,只会继续在当前WebView
里面进行跳转,哪怕你的Universal Link
一切正常,根本不会打开App
Universal Link
请求apple-app-site-association
时机- 当我们的
App
在设备上第一次运行时,如果支持Associated Domains
功能,那么iOS
会自动去GET
定义的Domain
下的apple-app-site-association
文件
APP 处理 Universal Link
跳转APP 方法
我们需要在工程里的实现AppDelegate里对应的方法:
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler {
if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
NSURL *url = userActivity.webpageURL;
if (url是我们希望处理的) {
//进行我们的处理
} else {
[[UIApplication sharedApplication] openURL:url];
}
}
return YES;
}
测试是否生效
a) 在Safari输入Universal Links
,查看是否弹出跳转链接
b) 在iOS原生备忘录上, 输入Universal Links
,点击是否可以跳转app
Universal Link
的运行机制原理
当App初次安装后或者更新版本后的第一次启动(第二次启动就不会),向工程配置的applinks:的域名
请求apple-app-site-association
配置文件。
App自动的将apple-app-site-association
配置文件向iOS系统配置。
当任何WebView发起UniversalLink
的url的时候,系统遍历注册过的通用链接,如果命中则直接打开App触发Delegate方法。
如果没命中,WebView继续跳转加载url。
以上都是系统默默替你做的,我们要做的就是确保配置的正确性。
Universal link 查询配置链接 UAT 环境
iOS 查看配置
https://<fully qualified domain>/apple-app-site-association
https://<fully qualified domain>/.well-known/apple-app-site-association
安卓 查看配置
https://<fully qualified domain>/.well-known/assetlinks.json
更多内容可以查看原文[Universal Links(通用链接)详解]https://www.jianshu.com/p/f1c97d0d0d22