一、前言

项目中时常有这种需求, 是通过链接跳转到应用内部,现在iOS主流的方案有两个

  • Schema: 常用在于一个应用跳转到另一个应用内部,属于应用间的跳转。当然ios9以下,网页可以通过schema://跳转到App内部。但是这种方式跳转比较生硬,在每次跳转的时候都会弹框询问。如果iPhone中如果没有安装则会直接弹出错误提示。
  • Universal Links(通用链接): 常用于https链接来打开APP(手机中已经安装此APP),或者跳转到https链接(手机中没有安装此APP)。Universal Links就是一个通用链接,iOS9以上的用户,可以通过点击这个链接无缝的重定向到一个app应用,而不需要通过safari打开跳转。如果用户没有安装这个app,则会在safari中打开这个链接指向的网页。


Universal Links(通用链接)的优点

  • 唯一性: 不像自定义的scheme,因为它使用标准的http/https链接到你的web站点,所以它不会被其它的app所声明.另外,Custom URL scheme 因为是自定义的协议,所以在没有安装 app 的情况下是无法直接打开的,而 universal links 本身是一个 HTTP/HTTPS 链接,所以有更好的兼容性
  • 安全: 当用户的手机上安装了你的app,那么iOS将去你的网站上去下载你上传上去的说明文件(这个说明文件声明了你的app可以打开哪些类型的http链接).因为只有你自己才能上传文件到你网站的根目录,所以你的网站和你的app之间的关联是安全的.
  • 可变: 当用户手机上没有安装你的app的时候,Universal Links也能够工作.如果你愿意,在没有安装你的app的时候,用户点击链接,会在safari中展示你网站的内容.
  • 简单: 一个URL链接,可以同时作用于网站和app
  • 私有: 其它app可以在不需要知道你的app是否安装了的情况下和你的app相互通信.

二、需求场景

(1)第三方应用集成了友盟分享到QQ和微信的功能
(2)第三方应用分享了一个web页面到微信或QQ
(3)打开分享的web页面,点击上面的某一个按钮
(4)如果用户安装了该应用,直接打开应用根据web地址中的参数跳转到对应的页面
(5)如果用户没有安装应用,直接跳转到appStore

三、需求实现方案

iOS9 之后提供的 Universal Links 功能

四、需求实现步骤

1. 创建一个json文件,名称必须为 apple-app-site-association,⚠️该文件不可带 .json 的后缀名

apple-app-site-association 文件必须放在https服务器的根目录下,例:https://gorpeln.top 这个路径下 ⚠️一定是根目录,也就是说该文件必须是一级目录,供下载使用

apple-app-site-association 文件格式:

{
    "applinks": {
        "apps": [],
        "details": [{
            "appID": "teamID.com.gorpeln.notes",
            "paths": ["*"]
        },
        {
            "appID": "teamID.com.gorpeln.notes",
            "paths": ["*", "/qq_conn/111878720/*"]
        }]
    }
}

1)appID :
  appID 格式为 teamID.bundleId形式,譬如说我的teamID是xxxxxxxxxxx,bundleId是com.gorpeln.notes那么我的appID就是:xxxxxxxxxxx.com.gorpeln.notes。
  teamID:打开苹果官网,点击Account,点击左边栏的 Membership,查找teamID

20200112192505921

2) paths:
  设定一个App的路径支持列表,只有这些指定的路径链接才会被App所处理。格式如下:

"paths": [ "/wwdc/news/", "NOT /videos/wwdc/2010/*", "/videos/wwdc/201?/*"]
  • 使用*配置,则整个网站都可以使用
  • 使用特定的URL,例如/wwdc/news/来指定某一个特殊的链接。
  • 在特定URL后面添加*,例如 /videos/wwdc/2015/*, 来指定网站的某一部分。如果你的网站是gorpeln.top,你的path写的是/support/*,那么当用户点击gorpeln.top/support/myDoucument,就可以进入你的app了,相反gorpeln.top/other 就不会.
  • 除了使用*来匹配任意字符,你也可以使用 ?来匹配单个字符,你可以在路径当中结合这两个字符使用,例如 /foo/*/bar/201?/mypage。(配置的paths路径,是区分大小写的)

3) 验证apple-app-site-association文件
  文件配置完成之后,将其上传到你的服务器根目录或者.well-known这个子目录下。

  • 确保使用https://yourdomain.com/apple-app-site-association这个链接可以访问到,yourdomain.com为你的服务器域名。
  • 也可以使用苹果的验证网站,验证文件是否能被苹果请求到。出现该提示为apple-app-site-association文件配置正确。

20200112192505922

  • 出现404错误码提示,则为apple-app-site-association文件未上传成功,或者使用https://yourdomain.com/apple-app-site-association路径无法访问。

2. 建立web网页和app应用之间的关联 -> app IDs配置 和 项目配置

(1)app IDs 配置
  进入开发者网站,找到你自己的bundleId,可以点击edit按钮,开启associate domains,如下图: 20200112192505923

(2)项目配置
  在项目的Capablities中开启Associated domains,如下图:

20200112192505924

注意domains可以添加多个,前缀必须为applinks:applinks:后为你的服务器的域名。

代码接收Universal Links唤醒

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray *))restorationHandler
{
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *webpageURL = userActivity.webpageURL;
        NSString *host = webpageURL.host;
        if ([host isEqualToString:@"gorpeln.top"]) {
            //进行我们需要的处理
        }
        else {
            [[UIApplication sharedApplication]openURL:webpageURL];
        }
    }
    return YES;
}

在appdelegate中实现上面这个方法,当使用Universal Links唤醒app时就执行这个方法。

(3)验证以上配置
  快捷验证,在备忘录中输入https://yourdomain.com/apple-app-site-association,长按这个链接,出现下图提示则配置成功。

20200112192505925

备注:如果我们在手机上没有安装相应的应用,就可以通过Universal Links重定向进行跳转到下载也进行下载操作。因为我们在paths设置了路径限制,只要我们重定向的路径符合限制,就能先走本地是否安装程序,如果没有再跳转到相应下载页。