需求
- 用手机打开我们的网页,点击打开按钮或者收藏按钮,可以直接唤醒app,如果未安装app,则跳转到应用商店提示下载。
目前通用的方式有三种:
- Universal Links;
- url schemes;
- meta标签;
下面就来介绍一下这三种方式
meta标签
这种方式在国外的网页和app上好像比较常见,可以在网页上的meta标签做手脚,类似下图的效果:
meta标签的格式如下:
<meta charset="UTF-8" name="apple-itunes-app" content="app-id=1234567890, affiliate-data=myAffiliateData, app-argument=yourScheme://">
这样添加meta标签后,使用Safari打开网页就会在网页上方,显示自己app的信息导航条。
如果没有安装app可以点击跳转App Store去下载,如果安装了app就会自动打开app。
url Schemes
步骤如下:在项目里,info最下端,找到URL Types,add一个新的url scheme,这里几个参数最好都填一下,Url Schemes是必填的,如下图所示:
这里配置完之后,info.plist文件自动会加入一个配置:
接着在AppDelegate里的handleOpenURL
捕获跳转过来的url,获取参数:
-(BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
if (!url) {
return NO;
}
NSString *urlStr = url.absoluteString;
NSLog(@"handleOpenURL:%@",urlStr);
return YES;
}
接着可以在模拟器的Safari浏览器地址栏输入:TestOC://
格式为URL Schemes
:
//
三部分组成。
点击open,就会跳转到app,并且走到handleOpenURL
这个代理方法中。
Universal Links
什么是Universal Links
Universal Links是iOS9之后支持的一个通用链接,iOS9以上的用户可以通过点击这个链接无缝的重定向到一个app应用,而不需要通过Safari打开。
如果用户没有安装这个app,则会再Safari中打开这个链接。
详细的配置流程如下:
一、创建一个名为apple-app-site-association
,包含固定格式的json文件。
关于apple-app-site-association
文件的格式如下:
{
"applinks": {
"apps": [],
"details": [
{
"appID": "teamID.bundleId",
"paths": ["/deaplink","/wwdc/news/","*"]
},
{
"appID": "ABCD1234.com.apple.wwdc",
"paths": [ "*" ]
}
]
}
}
这里需要注意的是,文件名必须为apple-app-site-association
不能有后缀,需要注意。
appID的格式为teamID
.bundle id
,paths就是配置哪些路径可以唤醒,哪些路径不能唤醒,可以使用*
?
帮助配置。这里paths配置的路径是区分大小写的。
二、验证apple-app-site-association
文件
文件配置完成之后,需要将文件放到服务器的根目录下,或者是.well-known
这个子目录下。
- 确保使用
https://yourDomain.com/apple-app-site-association
这个链接可以访问到,yourDomain就是你的服务器域名。 - 也可以使用苹果的验证网站(https://search.developer.apple.com/appsearch-validation-tool/),验证文件是否能被苹果请求到。如果是未上线的问题,使用验证网站可能会提示你
Error no apps with domain entitlements
出现该提示则说明配置正确,出现404则说明配置错误。
三、项目和工程配置
使用Universal Links需要给app IDs配置打开 Association Domain
选项,进入开发者网站,找到自己的bundle id,edit,打开Association Domain。
然后就是工程配置。
在工程的Capabilities
中开启Association Domain
并且可以添加多个domains,格式为applinks:
服务器域名
接着在AppDelegate中实现代理方法,注意跟url schemes的代理方法不是同一个
-(BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{
NSLog(@"userActivity : %@",userActivity.webpageURL.description);
return YES;
}
当app通过Universal Link 唤醒是 就会回调到这个方法,获取信息。
四、验证以上配置
在备忘录中,输入https://yourDomain.com/apple-app-site-association
并点击,如果出现在***中打开
则说明配置成功。
Universal Links总结
- 服务器必须支持https,且必须是苹果新人的TSL证书,苹果支持的根证书列表;
-
apple-app-site-association
文件名千万不能写错,没有后缀; - 只有在初次安装时,才会去请求下载
apple-app-site-association
文件,所以可能会出现因为网络波动导致下载失败的情况,当工程中修改了Association Domain
配置时,也会重新去请求下载apple-app-site-association
文件。 - 还有一个问题,配置完成之后,备忘录和Safari都可以成功,但是在其他应用里面不成功,未跨域导致的,如:分享到微信的链接是(https://www.mydomain.com/share.html),然后该网页中的“在app内打开”按钮配置的通用链接为 (https://www.mydomain.com/index.html)。
跨域的意思是说,通用链接 和 调用通用链接的网页不要使用同一域名。
即如果通用链接域名为“www.mydomain.com”,则通用链接所处的网页域名就不能是“www.mydomain.com”。
ps.之前用Universal Links可以在微信中直接唤起app,目前好像也已经被企鹅和微信给屏蔽了。只能说一句太流氓了。现在大多数app的做法又跟url scheme类似了,如果分享到微信,加一层蒙版,引导在Safari中打开。
觉得有用,请帮忙点亮红心
Better Late Than Never!
努力是为了当机会来临时不会错失机会。
共勉!