我一个小菜鸟又开始分享最近做的东西啦,不足之处请大家多多指教.
最近公司要求做一个功能,将 app 中分享出去的文章,在微信打开相应app的 h5链接后,点击页面顶部一按钮可跳转到自己的 app 应用.如下图所示:
点击打开按钮之后将跳转自己的 app.
经过多方的查找资料,最终确定了使用 ios9出的Universal Links,下面我为大家讲解一下使用的方法.
1.服务器需要做的处理:
第一,网站必须要有SSL证书(也就是支持https).(大家注意一下, SSL 证书必须要是机构认证的证书,比如腾讯云,阿里云,我推荐用阿里云免费得证书,我们也是用的这个证书.开始的时候我们用的自己公司个人认证的证书,在 app 启动时不会自动下载在服务器存放的 json 文件,这点大家一定要注意)
第二,在网站根目录下放一个名为“apple-app-site-association”的json文件,去除后缀“.json”,换句话说可以通过https://www.test.com/apple-app-site-association访问到该文件。
"apple-app-site-association"文件内容如下:
{
"applinks":
{
"apps": [],
"details": [
{"appID":"teamID.bundleId”,
"paths": ["/deaplink","/wwdc/news/","*"]
},
{"appID":"ABCD1234.com.apple.wwdc","paths": ["*"]
}
]
}
}
appID 的 格式为teamID.bundleId形式。
如何获取teamID呢?
登录开发者网站,找到Membership选项卡。
teamId.png
appID具体显示就是:xxxxxxxxxxx.com.mytest.app这种
paths
paths配置,实际上就是限制哪些路径可以唤醒app,哪些路径不能唤醒app。格式如下:
"paths": ["/wwdc/news/","NOT /videos/wwdc/2010/*","/videos/wwdc/201?/*"]
使用*配置,则整个网站都可以使用
使用特定的URL,例如/wwdc/news/来指定某一个特殊的链接
在特定URL后面添加*,例如/videos/wwdc/2015/*, 来指定网站的某一部分
除了使用*来匹配任意字符,你也可以使用?来匹配单个字符,你可以在路径当中结合这两个字符使用,例如/foo/*/bar/201?/mypage
需要注意的是:
配置的paths路径,是区分大小写的
验证apple-app-site-association文件
文件配置完成之后,将其上传到你的服务器根目录或者.well-known这个子目录下。
确保使用https://yourdomain.com/apple-app-site-association这个链接可以访问到,yourdomain.com为你的服务器域名。
也可以使用苹果的验证网站,验证文件是否能被苹果请求到。如果是未上线的应用,使用验证网站时可能出现如下提示:
Validation Tool.png
-出现该提示为apple-app-site-association文件配置正确。
-出现404错误码提示,则为apple-app-site-association文件未上传成功,或者使用https://yourdomain.com/apple-app-site-association路径无法访问。
2.建立web网页和app应用之间的关联 ->app IDs配置 和 项目配置
app IDs 配置
进入开发者网站,找到你自己的bundleId,可以点击edit按钮,开启associate domains,如下图:
associated domains.png
项目配置
在项目的Capablities中开启Associated domains,如下图:
appLinks.png
注意domains可以添加多个,前缀必须为applinks:,applinks:后为你的服务器的域名。
代码接收Universal Links唤醒
-(BOOL)application:(UIApplication*)application continueUserActivity:(NSUserActivity*)userActivity restorationHandler:(void(^)(NSArray* _Nullable))restorationHandler{
NSLog(@"userActivity : %@",userActivity.webpageURL.description);
returnYES;
}
在appdelegate中实现上面这个方法,当使用Universal Links唤醒app时就执行这个方法。
3.验证配置
快捷验证,在备忘录中输入https://yourdomain.com/apple-app-site-association,长按这个链接,出现下图提示则配置成功。
有的需求需要跳转相应的界面可以通过 paths 这个字段设置其是否进行跳转,还可设置不跳转app 的路径前面要加 NOT ,例如"NOT www.test.com/*",星号代表所有,还可以使用?等.
再向大家推荐一个方法测试是否从服务器请求到了 json 文件
使用charles抓包显示,只有初次安装app时才会去请求apple-app-site-association文件,所以测试时有可能因为网络波动导致apple-app-site-association文件获取失败。这种情况,多卸载几次,安装时使用4G。
希望这篇文章对大家有所帮助,有什么不足之处请大家多多指教.有什么问题也可以留言询问我.再向大家推荐一个基于Universal Links的第三方框架,LinkedMe,大家也可以用这个第三方,也比较简单.
最后与大家分享一句话,"不积跬步,无以至千里;不积小流,无以成江海".加油!!