【iOS】Universal Links(通用链接)及其配置方法

Universal Links 的作用

当应用支持 Universal Links 后,如果用户已经安装了你的 app,当点击开发者配置的网站链接后,iOS 用户可以无缝跳转至该应用 ,而无需经由 Safari 中转;如果没有安装,则会通过 Safari 打开链接对应的网站。

:当用户在 WKWebView 或 UIWebView 页面或 Safari 网页中点击指向网站的链接时,Universal Links 才允许用户打开开发者的应用

Universal Links 配置方法

  1. 在开发者中心进行配置:找到对应的App ID,在 Application Services 列表里将 Associated Domains 更改为 Enabled。


    Application Services
  2. 打开工程配置 Capabilities 选项卡中的 Associated Domains 开关,在其中的 Domains 中填入域名,必须以“applinks:”为前缀,如“applinks:test.universallinks.com”。

    image.png

  1. 创建 JSON 数据格式的名为 apple-app-site-association 的文件,内容为你的应用需关联的所有 URL,形式如下:
{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "9JA89QQLNQ.com.apple.wwdc",
                "paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
            },
            {
                "appID": "ABCD1234.com.apple.wwdc",
                "paths": [ "*" ]
            }
        ]
    }
}

:对于在 iOS 9.3.1 更高版本中运行的应用程序,apple-app-site-association 的文件大小必须 ≤ 128 KB。

  1. 上次 apple-app-site-association 文件至你的网站服务器(需支持 HTTPS 协议),并将其放置网站根目录或 .well-known 文件夹下。
  2. 在 AppDelegate 的 - (BOOL)application: continueUserActivity: restorationHandler: 方法中处理通用链接。
- (BOOL)application:(nonnull UIApplication *)application
continueUserActivity:(nonnull NSUserActivity *)userActivity
 restorationHandler:(nonnull void (^)(NSArray * __nullable))restorationHandler {
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *webpageURL = userActivity.webpageURL;
        NSString *host = webpageURL.host;
        if ([host isEqualToString:@"test.universallinks.com"]) {
            // TODO:处理应用内跳转逻辑
        }
        else {
            [[UIApplication sharedApplication]openURL:webpageURL];
        }
        return YES;
    }
    return NO;
}

Universal Links 原理

  1. app 第一次启动 或 app 更新版本后第一次启动时,会向工程里配置的域名发起获取 apple-app-site-association 文件的 get 请求,并将其注册给系统。

  2. 当用户在 WKWebView 或 UIWebView 页面或 Safari 网页中点击指向开发者网站的链接时,如果系统中安装了开发者的 app,Universal Links 会直接调起,否则会通过 Safari 打开链接对应的网站。

其它问题

  1. 点击 url 页面中的通用链接后,没有打开应用。
    原因:当用户点击通用链接时,iOS 系统会检查用户最近的选择,以确定是打开应用还是网站。 例如,用户在 Safari 中点击通用链接打开应用后,可以通过点击状态栏中返回按钮来在 Safari 中继续浏览网站,直到用户在网页顶部的条幅中点击“打开”按钮。
    解决方法:在网页顶部的条幅中点击“打开”按钮。

  2. 服务器配置了 apple-app-site-association 文件,点击 url 链接却没有调起客户端。
    原因:服务器根目录及 .well-known 文件夹下均存在 apple-app-site-association 文件,客户端在请求该文件时,会以 .well-known 文件夹下的配置文件内容为准,而在更改配置时没有同时对这两个目录中的文件进行更新,故导致上述问题。
    解决方法:同时更新根目录及 .well-known 文件夹下的 apple-app-site-association 文件,或只保留其中某个文件并使内容保持最新。

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

推荐阅读更多精彩内容