Universal Link 是 iOS9 推出的一项功能,使你的应用(微信,微博等)可以通过传统的HTTPS链接来启动APP,而不是使用 scheme 的方式。
如何理解Universal Link(通用链接)
Universal Link(通用链接):看起来就是一条普通的https链接,当然是我们在该链接域名根目录配置过的一个链接,也可以在该链接中放置对应的H5页面。当用户的点击该链接,只要手机中安装了支持该链接的APP就会直接进入到APP中。如果没有安装APP则会跳转到Safari浏览器中,展示H5页面。对用户来说则是一个无缝跳转的过程。
Universal Link(通用链接)的应用场景
使用Universal Link(通用链接)可以让用户在Safari浏览器或者其他APP的webview中拉起相应的APP,也可以在APP中使用相应的功能,从而来把用户引流到APP中。比如淘宝当在Safari浏览器中进入淘宝网页点击打开APP则会使用Universal Link(通用链接)来拉起淘宝APP。 微信支付和微信分享等和微信相关的都已经使用了Universal Link进行跳转,这可能是一个趋势,我们必须了解该技术. 开始配置Unuversal Links: 一.在苹果开发者中心配置 Associated Domains 1.Certificates, Identifiers Profiles 2.Identifiers 3.勾选 Associated Domains (AppID在开发中心创建之初是默认勾选支持Associated Domains了的。如果你没有勾选,在你更改为支持Associated Domains之后你需要重新下载描述文件并导入,因为描述文件是关联了AppID的) 二.配置JSON文件 我们需要配置一个JSON文件,此为关键步骤. 创建一个空白文件(必须纯文本,命名为apple-app-site-association,去除后缀名,不能包含后缀名)。这里建议让后台人员或者运维工程师在其本地创建,避免文件传输时,文件自动被更改格式、后缀自动添加等问题。 文件里面的内容如下
{
"applinks": {
"apps": [],
"details": [
{
"appID": "xxxxxxx.bbbbbb",
"paths": [ "*" ]
}
]
}
}
说明:1.xxxxxxx表示苹果账号的团队ID,苹果的团队ID去你自己的开发者中心复制(TeamID 可以从开发者中心 -> Membership 中获 取)。 2.bbbbbb表示项目的BundleID。 3.这个JSON文件中的appID其实由你的团队ID(TeamID)和BundleID拼接而成. 4.paths:设定你的app支持的路径列表,只有这些指定的路径的链接,才能被app所处理。星号代表了可识别域名下所有链接,一般是使用的星号,星号为通配符号. 5.apps:是限制只能在这几个app中使用, 基本是不填写,所以是空数组. 6.paths除了[ “" ]这样设置,也还可以加一个斜杠,这是为了处理一些问题,如写成这样"paths": ["/”] PS : 据说可先配置微信开放平台和QQ互联平台,我当时没有这样做过,是先调试通了通用链接再去申请的微信平台,时间紧的网友可以一试,如果被微信拒绝了别来找我,成功了请在下面留个言,谢谢~ 如果上传人员给你的访问路径是: https://www.baidu.com/.well-known/apple-app-site-association 或 https://www.baidu.com/apple-app-site-association则: 微信开放平台的Universal Link填写是:https://www.baidu.com/app/ QQ互联平台的Universal Link填写是:https://www.baidu.com/qq_conn/22222222/ ("/qq_conn/22222222/*"需要根据QQ互联平台设置,22222222是QQ互联后台对应应用的APPID。) 三.上传JSON文件 配置好了文件,就让运维人员将文件上传到域名所对应的根目录或者.well-known目录下,这是为了苹果能获取到你上传的文件。上传完后,让上传人员给你一个访问路径,先访问一下,看看是否能够获取到。其实现在已经建议上传到.well-known目录下了,上传人员给你的访问地址你在PC端的浏览器或者手机的Safari浏览器访问,会提示下载该文件,你点击同意下载,下载下来是你的那个文件内容,并且内容没有乱码,说明正确,不行要重新检查上传。 四.在Xcode开发工具配置Associated Domains 在其中的Domains中填入你想支持的域名,必须以applinks:为前缀,如:applinks:domain 如果上传人员给你的访问路径是: https://www.baidu.com/.well-known/apple-app-site-association 或 https://www.baidu.com/apple-app-site-association 则Domains中填入:applinks:www.baidu.com 配置好后run起来。 这里你可以看到,这个Associated Domains是可以添加多个的。 五.验证我们的通用链接是否生效 1.使用我们的苹果手机备忘录。先在Xcode中配置好了Associated Domains,苹果开发者中心也配置好,导入描述文件,然后将App安装到你的手机真机上。最后在你的手机真机的备忘录中输入你的链接,点击你备忘录中的链接能直接打开你手机上的App,或者长按备忘录的链接,出现“在“xxxx”中打开”对话框,点击对话框也可以打开你的App即为成功.
2.使用iPhone的Safari浏览器。在浏览器中输入链接,输入过后,往下滑,顶部会出现“提示条”,提示“在“xxxxx”App中打开”,然后点击右侧的“打开”,如果能打开你的App,即为成功.
这里发生过一个小事故,我在Safari浏览器中输入链接的时候,往下拉一直不出现此提示条,就很纳闷。虽然上面的几个链接在备忘录中都可以打开我们的App,但是在浏览器中不都是可以出现提示条的。经过我不断的尝试我在https://class.xxxx.com/app/输入浏览器才出现提示条,也就是我在后面加了一个"/app/",才出现提示条,这可能和后台或者运维的配置有关,网上的其他通用链接教程,是没有我这一步的,也没有遇见谁提及到了此处. 3.使用苹果官方的检测通用链接的网址.地址是:https://search.developer.apple.com/appsearch-validation-tool/ 这玩意其实是有点坑的,你将你的链接输入进去,不报红就可以了。检测的到的话,会出来你App的名字,logo图标啥的,我之前的App可以检查到,新编写的项目死活检查不到,还以为哪里搞错了,结果硬着头皮申请了微信分享,测试,上架AppStore过后,结果还是检查不到,但是功能都是完全正常的,卡在这里卡了好久,一直检测不到,你说坑不坑. 六.代码. 跳转回 APP 的处理 当点击某个链接,直接可以进我们的app了,但是我们的目的是要能够获取到用户进来的链接,根据链接来展示给用户相应的内容。 我们需要在工程里的实现AppDelegate里对应的方法.上述配置和验证工作都完成过后,在Appdelegate中注入相关代码
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
NSString *urlStr = userActivity.webpageURL.absoluteString;
if ([urlStr isEqualToString:@"https:
return YES;
}
}
return [self UMApplication:application continueUserActivity:userActivity restorationHandler:restorationHandler];
}
七.注意事项 注意事项我只是总结了我遇到的问题,欢迎大家补充. 1.手机上必须安装你需要跳转的应用并配置Associated Domains,才能验证成功. 2.Universal Link必须要求跨域,如果不跨域,就不会跳转(iOS 9.2之后的改动). 3.服务器上apple-app-site-association的更新不会让iOS本地的apple-app-site-association同步更新,即iOS只会在App第一次启动时请求一次,以后除非App更新或重新安装,否则不会在每次打开时请求apple-app-site-association 4.只有当前webview的URL域名,与跳转目标URL域名不一致时,Universal Link(通用链接)才生效。 5.域名必须需要为可以访问的,必须使用https://有效证书托管文件,并且没有重定向. 6.域名最好不要与 app 接口域名一样,这与微信分享有关. 7.文件的URL应符合以下格式:https:///.well-know/apple-app-site-association
八.微信的要求 说白了,现在的通用链接都是给鹅厂产品搞的,比如微信和QQ,贼烦.
1.Universal Links必须支持https 2.Universal Links配置的paths不能带query参数 3.微信使用Universal Links拉起第三方App时,会在Universal Links末尾拼接路径和参数,因此App配置的paths必须加上通配符**/*** (这一条来自其他教程,没有实验过,不过我在做微信分享的时候通用链接是以"/app/“结尾的,JSON文件是”/*"作为的paths值,原作者可能表达的是这个意思)
下面这张图是微信官方申请的时候要求截图:
4.通用链接代替了原白名单式的跳转方式,但是微信还是要求了我们配置了白名单,相当于两者都配置了。不理解其意。
5.如果要做微信分享啥的,加上这个吧. 当然info下面的URL Types你还是要搞的。
好的,问题是小细节有点多
|