【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

3. 创建 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。

4. 上次 apple-app-site-association 文件至你的网站服务器（需支持 HTTPS 协议），并将其放置网站根目录或 .well-known 文件夹下。
5. 在 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 文件，或只保留其中某个文件并使内容保持最新。