Universal Link¶

通用链接，一种通过HTTPS链接来唤起APP的功能。

如果你的应用支持Universal Link，当用户点击一个链接时可以跳转到你的网站并获得无缝重定向到对应的APP，且不需要通过Safari浏览器。如果你的应用不支持的话，则会在Safari中打开该链接。

支持`Universal Link`¶

先决条件：必须有一个支持HTTPS的域名，并且拥有该域名下上传到根目录的权限（为了上传Apple指定文件）

集成步骤¶

1、开发者中心配置¶

找到对应的App ID，在Application Services列表里有Associated Domains一条，把它变为Enabled就可以了

2、工程配置¶

targets->Capabilites->Associated Domains，在其中的Domains中填入你想支持的域名，必须以applinks:为前缀，如：applinks:m.nmkjxy.com

配的universalLink是https://m.nmkjxy.com/app/

则project配置Signing&capabilities下的Associated Domains设置applinks:m.nmkjxy.com。

applinks:是固定的，后面的要和universalLink的地址保持一致

举个例子：你的域名是：https://xxx.com 你要匹配的是：https://xxx.com/app/link/ 1、微信开发者 Universal Link 填写：https://xxx.com/app/link/ 2、xcode 的Associated Domains 添加 applinks:xxx.com

3、配置指定文件¶

在你关联的域根目录下创建 apple-app-site-association 文件，文件格式参照https://developer.apple.com/documentation/safariservices/supporting_associated_domains 。

创建一个内容为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": [ "*" ]
            },
            {
                "appID": "teamID.bundleID",
                "paths": [ "/app/link/*" ]
            },
        ]
    }
}

appID：组成方式是TeamID.BundleID。如上面的9JA89QQLNQ就是teamId。登陆开发者中心，在Account -> Membership里面可以找到Team ID paths：设定你的app支持的路径列表，只有这些指定路径的链接，才能被app所处理。*的写法代表了可识别域名下所有链接

注意：苹果是根据域名下的paths处理要打开的应用的，所以要避免相同的paths对应多个appID

4、上传该文件¶

上传该文件到你的域名所对应的根目录或者.well-known目录下，这是为了苹果能获取到你上传的文件。上传完后，先访问一下，看看是否能够获取到，当你在浏览器中输入这个文件链接后，应该是直接下载apple-app-site-association文件

5、代码中的相关支持¶

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

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler {
    // NSUserActivityTypeBrowsingWeb 由Universal Links唤醒的APP
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]){
        NSURL *webpageURL = userActivity.webpageURL;
        NSString *host = webpageURL.host;
        if ([host isEqualToString:@"api.r2games.com.cn"]){
            //进行我们的处理
            NSLog(@"TODO....");
        }else{
            NSLog(@"openurl");
            [[UIApplication sharedApplication] openURL:webpageURL options:nil completionHandler:nil];
        }
    }
    return YES;
}

苹果为了方便开发者，提供了一个网页验证我们编写的这个apple-app-site-association是否合法有效，但是苹果官方给的检测接口不靠谱，可以把通用链接地址在浏览器或者记事本上填写访问，能拉起应用就是配置成功了，不能就说明配置有问题或者还没有生效，一般配置完成最快要30分钟后才能生效

注意如果挂了代理，SSL的设置一定不要监控苹果的这个https://app-site-association.cdn-apple.com域名，可能会导致访问通用链接无效

Universal Link（通用链接）注意点¶

`Universal Link`跨域¶

Universal Link必须要求跨域，如果不跨域，就不会跳转。

假如当前网页的域名是A，当前网页发起跳转的域名是B，必须要求B和A是不同域名才会触发Universal Link，如果B和A是相同域名，只会继续在当前WebView里面进行跳转，哪怕你的Universal Link一切正常，根本不会打开App

`Universal Link`请求`apple-app-site-association`时机¶

当我们的App在设备上第一次运行时，如果支持Associated Domains功能，那么iOS会自动去GET定义的Domain下的apple-app-site-association文件
iOS会先请求https://domain.com/.well-known/apple-app-site-association，如果此文件请求不到，再去请求https://domain.com/apple-app-site-association，所以如果想要避免服务器接收过多GET请求，可以直接把apple-app-site-association放在./well-known目录下
服务器上apple-app-site-association的更新不会让iOS本地的apple-app-site-association同步更新，即iOS只会在App第一次启动时请求一次，以后除非App更新或重新安装，否则不会在每次打开时请求apple-app-site-association

Universal Link的好处¶

之前的Custom URL scheme是自定义的协议，因此在没有安装该app的情况下是无法直接打开的。而Universal Links本身就是一个能够指向web页面或者app内容页的标准web link，因此能够很好的兼容其他情况
Universal links是从服务器上查询是哪个app需要被打开，因此不存在Custom URL scheme那样名字被抢占、冲突的情况
Universal links支持从其他app中的UIWebView中跳转到目标app
提供Universal link给别的app进行app间的交流时，对方并不能够用这个方法去检测你的app是否被安装（之前的custom scheme URL的canOpenURL方法可以）