iOS 通用链接(Universal Links)的配置与使用

一、通用链接简介

在iOS9之前,对于从各种从浏览器、Safari中唤醒APP的需求,我们通常只能使用scheme。但是这种方式需要提前判断系统中是否安装了能够响应此scheme的app,并且这种方式在微信中是被禁用了的。

通用链接(Universal Links)是iOS9推出的一项功能,使你的应用可以通过传统的HTTP链接来启动APP(如果iOS设备上已经安装了你的app,不管在微信里还是在哪里), 或者打开网页(iOS设备上没有安装你的app)。

通用链接为您提供了使用自定义URL方案时无法获得的几个主要优势。具体而言,通用链接是:

  • 独特。与自定义网址方案不同,其他应用无法声明通用链接,因为它们使用指向您网站的标准HTTP或HTTPS链接。
  • 安全。当用户安装您的应用时,iOS会检查您上传到网络服务器的文件,以确保您的网站允许您的应用代表其打开网址。只有您可以创建并上传此文件,因此您的网站与应用的关联是安全的。
  • 灵活。即使您的应用未安装,通用链接也能正常工作。未安装您的应用时,点按指向您网站的链接会在用户期望的Safari中打开内容。
  • 简单。一个URL适用于您的网站和您的应用。
  • 私人的。其他应用可以与您的应用进行通信,而无需知道您的应用是否已安装。

注意
1、通用链接允许用户在点击您网站内的链接WKWebView和UIWebView视图以及Safari页面时打开您的应用,此外还有导致呼叫的链接openURL:,例如邮件,消息和其他应用中出现的链接。
2、当用户在Safari中浏览您的网站并且他们点击与当前网页位于同一域中的URL的通用链接时,iOS会尊重用户最可能的意图并在Safari中打开该链接。如果用户点击通向不同域中网址的通用链接,iOS会在您的应用中打开该链接。
3、对于运行早于9.0版本的iOS的用户,点击指向您网站的通用链接会在Safari中打开该链接。

二、配置通用链接

1、配置开发证书

需要在开发者中心做配置:找到对应的App ID,在Application Services列表里有Associated Domains一条,把它变为Enabled就可以了。

配置开发证书.jpg

2、配置Capabilitles

进入项目的Targets->Capabilites->Associated Domains,设置成ON状态。在其中的Domains中填入你想支持的域名,必须以applinks:为前缀,后面添加通用链接的域名,这里以 www.baidu.com 为例

配置Capabilitles.png

3、创建关联文件apple-app-site-association

创建一个内容为json格式的文件,苹果将会在合适的时候,从我们在项目中填入的域名请求这个文件。这个文件名必须为apple-app-site-association,没有后缀名,文件内容大概是这样子:

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "9JA89QQLNQ.com.apple.wwdc",
                "paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
            },
            {
                "appID": "ABCD1234.com.apple.wwdc",
                "paths": [ "*" ]
            }
        ]
    }
}

注意
1、不要附加.json到apple-app-site-association文件名。
2、appID:组成方式是 teamId.yourapp’s bundle identifier。如上面的 9JA89QQLNQ就是teamId。登陆开发者中心,在Account - Membership里面可以找到Team ID
3、paths:设定你的app支持的路径列表,只有这些指定的路径的链接,才能被app所处理。星号的写法代表了可识别域名下所有链接。

paths要指定不应作为通用链接处理的区域,请在路径字符串的开头添加“NOT”(包括后面的空格T)。例如,apple-app-site-association显示的文件可能会阻止/videos/wwdc/2010/*通过更新paths数组将网站区域作为通用链接处理,如下所示:

"paths": [ "/wwdc/news/", "NOT /videos/wwdc/2010/*", "/videos/wwdc/201?/*"]

因为系统paths按照指定的顺序评估数组中的每个路径,并且在找到正匹配或负匹配时停止评估,您应该在低优先级路径之前指定高优先级路径。请注意,只有URL的路径组件用于比较,其他组件(例如查询字符串或片段标识符)将被忽略。

有多种方法可以在apple-app-site-association文件中指定网站路径。例如,您可以:

  • 使用 * 指定整个网站
  • 包括特定的URL,例如/wwdc/news/,以指定特定的链接
  • 附加 * 到特定网址,例如/videos/wwdc/2015/*,指定您网站的某个部分
  • 除了用于 * 匹配任何子字符串之外,您还可以使用 ? 匹配任何单个字符。您可以将两个通配符组合在一个路径中,例如/foo/*/bar/201?/mypage

注意:
用于指定paths阵列中网站路径的字符串区分大小写。

4、上传关联文件apple-app-site-association

上传该文件到你的域名所对应的根目录或者.well-known目录下,这是为了苹果能获取到你上传的文件。上传完后,自己先访问一下,看看是否能够获取到,当你在浏览器中输入这个文件链接后,应该是直接下载apple-app-site-association文件。如以知乎为例:https://www.zhihu.com/apple-app-site-association

三、验证通用链接

1、抓包验证

我们创建apple-app-site-association文件的目的是为了让iOS系统能获取这个文件,知道你的哪些是链接是Universal Links,哪些不是Universal Links。所以在你第一次安装APP时,iOS系统会去对应的路径下拿取apple-app-site-association文件,所以我们可以通过抓包来判断通不通。另外直接用Xcode debug调试APP时,iOS也会去拿取apple-app-site-association文件。

配置抓包.png

2、访问验证

在iOS设备中的备忘录中输入App能识别的链接,然后直接点击此链接,就会直接跳转到你的app了。或是长按,在出现的弹出菜单中第二项是在’XXX’中打开,这也代表着成功。这里使用知乎的链接为例:https://www.zhihu.com/question/345124567

备忘录验证.png

如果你选择在Safari中打开,上下滑动页面,你会发现仍然有一个按钮可以打开你的应用。


safari打开应用.jpg

3、验证失败原因推测

  • TeamId不对,要使用开发者中心账号下的TeamID
  • 域名不是https请求
  • 服务器端的SSL证书有问题(伪证书或者无效证书)
  • 服务器端的证书配置有问题

四、结合NFC使用

1、AppDelegate处理Universal Links

用户点击某个链接,直接可以进我们的app了,但是我们的目的是要能够获取到用户进来的链接,根据链接来展示给用户相应的内容。我们需要在工程里的 AppDelegate 里实现回调方法:

/// 通用链接回调方法
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void(^)(NSArray<id<UIUserActivityRestoring>> * __nullable restorableObjects))restorationHandler {
    // 通用链
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *url = userActivity.webpageURL;
        NSLog(@"通用链接 :%@", url);
    }
    
    return YES;
}

Demo下载:https://github.com/ZhangJingHao/ZJHNFCDemo

2、NFC后台读取通用链接

NFC的相关介绍,请参考这边文章:iOS NFC功能集成及详解

iPhone XS及更高版本支持后台标签读取。系统扫描并读取NFC数据,而无需用户使用应用程序扫描标签。每次读取新标签时,系统都会显示弹出通知。用户点击通知后,系统会将标记数据传递到相应的应用程序。如果iPhone被锁定,系统会在将标签数据提供给应用程序之前提示用户解锁手机。

首先将链接信息写入NFC标签,这里以知乎链接为例:https://www.zhihu.com/question/345124567

当扫描普通链接,或未安装相应应用的app时,会弹出Safari打开通知弹框,点击会跳转到Safari。


safari打开提示弹框.png

当扫描已配置好的通用链接,且安装了该app,会弹出使用app打开的通知弹框,点击会跳转到对应的app。


app打开提示弹框.png



参考链接:
iOS Universal Links(通用链接)的使用
iOS 9 通用链接(Universal Links)
Support Universal Links
Adding Support for Background Tag Reading

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 201,924评论 5 474
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,781评论 2 378
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 148,813评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,264评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,273评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,383评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,800评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,482评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,673评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,497评论 2 318
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,545评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,240评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,802评论 3 304
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,866评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,101评论 1 258
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,673评论 2 348
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,245评论 2 341

推荐阅读更多精彩内容