Universal Links 接入指南

什么是 Universal Links ?

当用户点击一个 Universal Link 时，iOS 会直接将链接重定向到你的应用程序，而无需通过 Safari 或你的网站进行路由。另外，由于通用链接是标准的HTTP或HTTPS链接，一个URL同时适用于您的网站和应用程序。如果您的应用程序没有安装，系统将在Safari中打开URL，允许您的网站处理它。

Universal Links 和 URL Schemes 比较

还记得 URL Schemes 吗？iOS 系统中因 sandbox 机制的存在，应用之间互相访问只能通过一个叫 URL Schemes 的机制来完成。通过注册Scheme，自定义URL，来调起一个app，URL是自定义的，app可根据URL的内容来处理一些来自外部的请求。

URL Schemes 是不安全的。苹果没有限制多个app可以注册同样的 Scheme 。2015年，乌云网公布一个漏洞，称未越狱的设备存在一个泄露支付宝账户密码的漏洞，其实就是劫持了支付宝的 URL Scheme 实现的。

再来看看 Universal LInks。苹果这样描述它的安全性：“当安装了一个使用 Univesal Links 的应用程序时，iOS 会通过你网站上的苹果应用程序网站关联文件验证关联，从而消除了其他应用程序可能会申请你的 scheme 并重定向你的 url 的可能性。” 这样看来，Universal Links 确实解决了前面提到的 URL Schemes 的安全性问题。

除此之外，URL Schemes 在调起 app 前，总是有弹框，让用户选择是否打开。而 Universal Links 则是直接调起 app。

如何支持 Universal Links ?

1. 创建应用程序和网站之间的双向关联，并指定应用程序处理的 url。

   • 添加Associated Domains Entitlement到你的 app。每个 Target 的设置如下：

     1. 打开工程的 Capabilities 选项卡，添加 Associated Domains

     2. 在 Domains 列表中，点击 ’+‘ 按钮，新增一条

     3. 修改刚才新增那条 domain ，格式如下：

        applinks:<域名>[:端口号]
        

        例如：

        applinks:developer.apple.com
        

   • 创建一个名为apple-app-site-association的文件

   • 添加 applinks key 到 apple-app-site-association 文件中，格式如下：

     {
         "applinks": {
             "apps": [],
             "details": [{
                 "appID": "D3KQX62K1A.com.example.photoapp",
                 "paths": ["/albums"]
                 },
                 {
                 "appID": "D3KQX62K1A.com.example.videoapp",
                 "paths": ["/videos"]
             }]
         }
     }
     

     applinks 通用链接对象有两个属性：

     • apps 这个属性并不用于 Universal Links，但它必须出现，并设置为空数组。

     • details数组可以定义多个能处理通用链接的 app

       • appID定义了能处理通用链接的应用程序标识符，格式如下：

         <Team Identifier>.<Bundle Identifier>
         

       • paths数组定义了一组由应用程序去处理的路径。可使用* ?通配符以及NOT

   根据 app 的业务场景，修改好这个文件即可。

   • 上传 apple-app-site-association 文件到你的网站

     上传的位置可以在网站根目录下，或者在.well-known目录下。

     如果使用.well-known目录，则地址遵循以下格式：

     https://<域名>/.well-known/apple-app-site-association
     

     必须使用https://和有效的证书来托管此文件，并且不使用任何重定向。

   • 测试 Universal Link 是否可用

     备忘录里输入可以让 app 处理的 Universal Link 网址，例如 我配置的paths 是 ["*"] , 表示域名下的任意网址， 我在备忘录里输入 https://foobar.com/foo 然后点击，如果成功是会打开 app 的。

2. 更新您的 AppDelegate，以响应iOS在 Universal Links 路由到您的应用程序时提供的 UserActivity 对象。

   当一个 Universal Link 被触发，iOS 会启动你的 app , 向它发送一个NSUserActivity对象。通过查询这个对象的属性，找到 app 是如何被启动的，以及决定要执行什么操作。

   示例：

   func application(_ application: UIApplication,
                    continue userActivity: NSUserActivity,
                    restorationHandler: @escaping ([Any]?) -> Void) -> Bool
   {
       guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
           let incomingURL = userActivity.webpageURL,
           let components = NSURLComponents(url: incomingURL, resolvingAgainstBaseURL: true),
           let path = components.path,
           let params = components.queryItems else {
               return false
       }
       
       print("path = \(path)")
       
       if let albumName = params.first(where: { $0.name == "albumname" } )?.value,
           let photoIndex = params.first(where: { $0.name == "index" })?.value {
           
           print("album = \(albumName)")
           print("photoIndex = \(photoIndex)")
           return true
           
       } else {
           print("Either album name or photo index missing")
           return false
       }
   }