如何在iOS9系统中使用Universal Link

作者: 火三君 | 来源:发表于2018-12-25 15:23 被阅读0次

概述

在ios9系统中，可以通过类似打开网页的方式，通过http协议打开app。通过一个唯一的网址，可以指到app内部的一个特定的view。而不用再使用scheme。设想一下，如果twitter使用了Universal Link，如果你点击了一个twitter的链接。你的设备直接打开twitter app内相应的页面。而不是打开一个普通的网页，然后再通过这个网页打开twitter，这种体验将是非常平滑，且对用户来讲，也节省了很多不必要的操作。

功能

使用Universal Link 能让你的App做到，通过点击一个网址，打开你的app，并跳转到对应的页面。

准备工作

实现Universal link 并不难，但是你必须遵从一些条件。下面是需要准备的清单。

序号	条件	例如
1	注册域名	www.domian.com
2	可以SSL访问你的域名	https://
3	能够上传一个Json文件到你的域名	file
4	IOS 9	ios 9
5	至少要Xcode 7	xcode 7

如果你已经具备了上面所有的先决条件，那么接下来只需要3步就可以在IOS9上的设备实现Universal link。

具体步骤

添加域名到Capabilities
1. 首先需要在xcode的capability下面添加域名，且必须得是applinks:的前缀，如果有二级域名，也一并加入进去，诸如(www.domain.com,news.domain.com,etc)
  
  image.png
  这将会使你的app访问一个特殊的json文件"apple-app-site-association",当你首次运行app的时候，它就会从https://domain.com/apple-app-site-association 下载这个json文件。接下来，看步骤2来学习下怎么构造这个文件。
  此外，还需要在网站上配置app的授权，允许universal link。编辑Associate Domain的授权为enable
上传apple-app-site-assosiation 文件
1. 这个文件必须存在，且能通过SSL的方式，通过get请求获取到。你可以打开一个文本编辑器，然后写下如下的json格式
```
{
 "applinks": {
 "apps": [],
 "details": [
 {
 "appID": "TBEJCS6FFP.com.domain.App",
 "paths":[ "*" ]
 }
 ]
 }
}
```
  在这个path 字段下，你可以有一个列表，这个列表是app允许反射到的url地址，或者也可以是一个*号，来标示你只是想打开一个app，而不管它的具体地址。
2. 另外，你可能会好奇TBEJCS6FFP.com.domain.App 这个值是从哪获取的，通常来讲，它就是你app的bundleid所在的teamed。你也可以点击它来查询你的teamid,然后bundleid可以在app的General下查询到。
  image.png
3. 最后，如果你可以在你的根域名下，找到 https://domain.com/apple-app-site-association，那么你就可以开始下一步了。
在你的app内部如何处理universallink

为了在app内部支持universal link，你需要在appdelegate中实现以下方法，application(_:continueUserActivity:restorationHandler:) ，尽管这个方法可能会处理多个事件（如 Handoff，SearchApi），但是我们只关注来自universal link的事件。

如果userActivity给的参数是NSUserActivityTypeBrowsingWeb.这就意味着它是来自universal link的参数，在这个情况下，首先保证它的webpageURL不为空，这个属性指的就是用户打开的链接。那么它有可能为如下的格式http://domain.com/path/to/thezoo

为了确保你的app能够转换这些URL，你需要做以下几步
- 通过NSURLComponents类解析webpageURL host以及path路径。
- 确保你能够识别这个host
- 尽量把path的路径对应到你的app页面中
- 确保path对应的页面能够展示
- 展示对应的页面给用户
  
  如果上面的步骤失败了，苹果建议你的app，优雅的打开safari对应的网址。

其他

当无法往根域名下放置apple-app-site-association文件的时候，可以考虑在二级域名下放置，同时将二级域名重定向到根域名。通过这种方式也可以实现苹果启动设备的时候获取文件。

使用二级域名重定向的时候，要对apple-app-site-association文件进行加密。

而且此文件的类型应该是application/pkcs7-mime

常见错误

Denying redirect 'https://www.domain.com/.well-known/apple-app-site-association' -> 'http://err.taobao.com/error1.html'
May 17 12:11:05 chengde-iPhone swcd(CoreUtils)[159] <Notice>: ### Rejecting URL 'https://www.domain.com/apple-app-site-association' for auth method 'NSURLAuthenticationMethodServerTrust': -6754/0xFFFFE59E kAuthenticationErr

https://forums.developer.apple.com/thread/67882

http://stackoverflow.com/questions/34166173/apple-app-site-association-file-wont-download(解决方法)

https://gist.github.com/anhar/6d50c023f442fb2437e1#sign-the-apple-app-association-file-using-openssl（服务端和客户端需要做的事）

https://forum.ind.ie/t/ios-9-universal-links-apple-app-site-association-blues/986（一些注意事项）