Universal Links
做App开发经常需要将某个页面分享到微信或者其他社交平台,也经常会有这么一个需求:如果安装了app就从app打开,并跳转到相应的产品页,如果没有安装app,就跳出h5页面。一般从浏览器、Safari中唤醒APP都是使用scheme,但是微信比较霸气,直接禁用了scheme。因此只能使用别的方式。
Unibersal Links就是为此而生。它是IOS9推出的一项功能,可以通过http链接来启动唤醒自己的APP。因为是IOS9(及以后)的系统服务,因此微信等社交平台也没有办法阻止。
官方文档地址:文档
example
好不好用先看看别人的app。
1、下载app
4、自己写个网页,加个a标签,href = http://www.opentable.com/restaurant/profile/33160?shareReferrer=ios-share ,然后在微信中打开你的网页,点击a标签就跳转到别人的app中去。
配置Universal Links(客户端)
- 首先,你的服务器必须支持https,并且你必须有一个域名。
因为我使用的是腾讯旗下的域名解析,因此我从腾讯云申请ssl证书,免费ssl证书申请地址,申请速度很快10分钟就审批下来。
- 需要在开发者中心的AppID中开启Universal Links。
然后重新配置下载描述文件(这步应该都会,这里只截图开发的描述文件,发布版的也一样要配置)
然后下载下来双击,使其在xCode生效。
- 在你的应用中配置Associated Domains,并且用
applinks:
为前缀。
顺便我们也来看看刚才下载的描述文件有没有配置好。
-
创建一个名字为
apple-app-site-association
的文件,并放在服务器网络的根目录下。注意,这个文件没有后缀!而且名字也不能改。
比如:{
"applinks": {
"apps": [],
"details": [
{
"appID": "GQUVXPG592.com.nuomi.test",
"paths": ["/hello/","/","/"]
}
]
}
}
其中GQUVXPG592
是teamId,可以在你的开发者中心查看到,com.nuomi.test
是你AppID。paths
就是URL路径支持通配符。具体怎么写,还是查看文档吧。
- 上传
apple-app-site-association
文件到根补录。
怎么才是判断位置是否对呢?访问https://你的域名/apple-app-site-association,如果能看见json或者下载到文件apple-app-site-association,那么就是放对了。
- 在appDelegate中编写代码
如果上面都配置对了,那么在点击对应的链接就会响应application:continueUserActivity:restorationHandler:
方法,然后在这个方法里面根据传进来的参数和路径跳转到不同的界面。
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{
if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]){
NSURL *url = userActivity.webpageURL;
NSString * msg = url.absoluteString;
UIAlertView * alert = [[UIAlertView alloc]initWithTitle:@"Universal Links测试" message:[NSString stringWithFormat:@"url:%@",msg] delegate:self cancelButtonTitle:@"ok" otherButtonTitles: nil];
[alert show];
}
return YES;
}
服务器配置https
还是老规矩,服务器端的内容因为不是重点,因此只会简单得点一下。毕竟在配置服务器方面我也是摸爬滚打配出来的,网上资料很多,可以自行参考。
我的服务器采用apache,因此就用apache为例子。
- 首先,准备好证书。
我的证书是在腾讯云下载到的,如图(ca文件,公钥证书,私钥):
我稍微改了下名字(顺序不变):
- 找到你的apache在服务器中的位置,并找到
httpd.conf
文件。
我的httpd.conf
在"apache/httpd-2.2.24/conf"下。
找到Include conf/extra/httpd-ssl.conf
并把前面的#
去掉。如果没有在最后一行自己加。
- 修改
httpd-ssl.conf
文件。
我的httpd-ssl.conf
文件在"apache/httpd-2.2.24/conf/extra"下,如果没有有可能你的apache不支持ssl,具体的可以网上寻找解决方案。
找到<VirtualHost _default_:443>
或者差不多的标签,找到SSLCipherSuite xxxxx
修改为SSLCipherSuite ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4
,找到SSLProtocol xxxxx
修改为SSLProtocol TLSv1 TLSv1.1 TLSv1.2
使其支持TLSv1.2。
然后把我们刚才的证书传到服务器上,并在httpd-ssl.conf
修改证书文件路径到对应文件下,比如:
SSLCertificateFile "/www/wdlinux/httpd-2.2.24/conf/server.crt"
SSLCertificateKeyFile "/www/wdlinux/httpd-2.2.24/conf/server.key"
SSLCertificateChainFile "/www/wdlinux/httpd-2.2.24/conf/server-ca.crt"
最后ssh到你的服务器,然后service httpd restart
。
ps:
httpd-ssl.conf
中 DocumentRoot "xxxxxxxx"就是你网站的根目录。
现在可以通过浏览器用https访问了,如果访问成功,那么恭喜你适配成功了,如果不成功。。。再找教程吧。
检验
Universal Links通用链接其实到目前为止就已经全部实现了,除了服务器配置不熟外,其他的还是很简单的。下面只要测试下是否能在微信中打开。
比如我的apple-app-site-association
文件挂在cs.pzhss.cc域名下,那么只要在rt.pzhss.cc(可以用http,不用https)的页面中随便加个a链接<a href = "https://cs.pzhss.cc">测试</a>
然后在微信的浏览器中打开,点击a链接就能跳转到自己的app中来。
或者在备忘录中打链接,然后长按,弹出在”xxx中打开“就算配置成功了。