美文网首页iOS经验总结
【iOS】Universal Links(通用链接)及其配置方法

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

作者: 胡萝卜须摇头玩 | 来源:发表于2019-08-01 17:57 被阅读0次

    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 文件,或只保留其中某个文件并使内容保持最新。

    相关文章

      网友评论

        本文标题:【iOS】Universal Links(通用链接)及其配置方法

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