美文网首页
Universal Links 接入指南

Universal Links 接入指南

作者: 秦枫桀 | 来源:发表于2019-10-10 16:10 被阅读0次

什么是 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
        }
    }
    

相关文章

网友评论

      本文标题:Universal Links 接入指南

      本文链接:https://www.haomeiwen.com/subject/utrapctx.html