UniversalLink通用链接梳理

本文内容收集整理自网络,结合了项目中的情况

1.什么是Universal Link

iOS9 新引入的一个功能,是通过传统HTTP链接来启动App的技术,可以使用相同的网址打开网站和App。通过唯一的网址,就可以链接到App中具体的视图,不需要特殊的scheme。如果用户没有安装App则链接到对应的普通网页。无缝连接Web-App ,备忘录-App,信息-App之间的跳转。
(在iOS 9以前,我们从外部启动App都是通过URL Scheme实现跳转的,与scheme不同,Universal Link是系统级别的,可以突破微信或是其他第三方封杀;
无缝跳转,没有提示框弹出,没有安装App则链接到对应的普通网页,让用户体验提升一个级别)

特征

  • 唯一性。不像自定义的scheme协议, unversal link不受其他App的限制,因为它是使用标准的http和https协议连接到自己的网站。

  • 安全性。当用户安装你的app的时候,iOS系统会检测你指定服务器你来确定你的网站是否支持通过这个方式来打开URL链接。一旦你创建和上传你的关联文件到你的服务器,你的站点和app的关联就是私密安全的。

  • 灵活性。Universal Link无论是是否安装了关联的app,都可以无缝的工作。当用户未安装关联的app时,就是一个普通的URL链接,可以通过webView正常打开,无需做其他配置。这个完全是iOS系统webKit的行为,开发者不用关心。

  • 简单。一个URL链接,可以同时作用于网站和app。

  • 私密性。其他app可以无缝的和你的app通信,其他app并不能通过连接知道用户是不是安装了你的app。

先决条件

  • 有一个注册的域名,并可通过 SSL 访问
  • 至少 iOS 9 版本
  • 至少 Xcode 7

Universal Link的基本运作流程

  • APP第一次启动 or APP更新版本后第一次启动
  • APP向工程里配置的域名发起Get请求拉取apple-app-association Json File
  • APP将apple-app-association注册给系统
  • 由任意webview发起跳转的url,如果命中了apple-app-association注册过的通用链接
  • 打开App,触发Universal Link delegate
  • 没命中,webview继续跳转url

注意事项

  • iOS 9.2之前,不用跨域都可以跳转, iOS 9.2之后,必须跨域才能进行跳转到原生app上。

  • iOS只会在App第一次启动时请求一次apple-app-site-association文件,服务器上该文件的更新不会让iOS本地的文件同步更新。

  • 下载的文件必须是apple-app-site-association,不能带后缀。

  • apple-app-site-association文件中paths 路径是大小写敏感。

  • iOS系统还会记录用户的习惯。
    (如果跳转到app内后,用户点击了屏幕右上角的按钮使用Safari打开后,下次还是点击出发跳转的连接的时候,那么iOS系统会根据用户的使用习惯直接用Safari或者WebView打开,不会跳转到App内;当用户点击了WebView或者Safari启发跳转连接顶栏那个”打开”按钮发生跳转后,下次打开才会触发跳转)

2.实现步骤

1. 在开发者中心打开Associated Domains服务

20180102111723000.png

2. 在 Xcode 的 capabilities 里 添加域名

image

3. 配置apple-app-site-association文件
1
2
3
4
5
6
7
8
9
10
11
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "8A7VED9NUX.com.biyao.fu",
        "paths":[ "/product/*", "/design/*", "/order/*", "/market/*", "/account/*"]
      }
    ]
  }
}
  • apps 是限制只能在这几个app中使用, 基本是不填写
  • appID:TeamID+.Bundle ID
  • paths:可以跳转的路径。代表此域名下所有路径都支持,也可以具体制定到某个页面例如/path/page或者某个路径下所有URL例如/path/
4. 上传 apple-app-site-association 文件
  • 上传 apple-app-site-association 文件到域名的根目录或者.well-known子目录下
  • 服务器需要支持https
  • 能打开https:///apple-app-site-association 或 https:///.well-known/apple-app-site-association
    当我们的App在设备上第一次运行时,如果支持Associated Domains功能,那么iOS会自动去获取域名下的apple-app-site-association文件
5. 在 APP 里处理通用链接

我们在AppDelegate中实现如下代理方法:

1
2
3
4
5
6
7
8
-(BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler
{
    if([userActivity.activityTypeisEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *webpageURL = userActivity.webpageURL;
        ......    
    }
    return YES;
}

3.遇到的问题

由于苹果iOS 13系统版本安全升级,为此openSDK在1.8.6版本进行了适配。 1.8.6版本支持Universal Links方式跳转,对openSDK分享进行合法性校验。
在配置好Universal Link后,发现无法正确连接,每次分享都会出现二次跳转。


image

再来看下之前 apple-app-site-association 的配置,

1
2
3
4
5
6
7
8
9
10
11
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "8A7VED9NUX.com.biyao.fu",
        "paths":[ "/product/*", "/design/*", "/order/*", "/market/*", "/account/*"]
      }
    ]
  }
}

这种写法可以识别的Universal Link只有这种几种情况:

  • https://www.domain.com/product/
  • https://www.domain.com/design/
  • https://www.domain.com/order/
  • https://www.domain.com/market/
  • https://www.domain.com/account/

而直接访问https://www.domain.com/是不会命中Universal Link的,这也导致了微信无法识别
将根目录添加通配符:

1
2
3
4
5
6
7
8
9
10
11
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "8A7VED9NUX.com.biyao.fu",
        "paths":[ "/product/*", "/design/*", "/order/*", "/market/*", "/account/*","*"]
      }
    ]
  }
}

就可以让直接访问根目录https://www.domain.com/的请求也命中,成为有效的Universal Link,解决微信的问题。