iOS Universal Links 的使用

通用链接（Universal Links）就不详细介绍了. 官方文档已经十分详细: Universal Links 苹果官网文档
Universal Links是iOS9推出的一项功能，使你的应用可以通过传统的HTTP链接来启动APP或者打开网页。

---

一.前期准备工作

TeamID：XXXXXX (即团队ID, 在苹果开发者网站 Apple Developer -> Member Center ->Membership->Team ID)
Bundle Identifier：xx.xxx.xx

需要生成一个json文件, 名为apple-app-site-association, 注意: 不需要添加任何后缀 !
内容如下:

 {
     "applinks": {
         "apps": [],
         "details": [
             {
                 "appID": "XXXXXX.xx.xxx.xx",
                 "paths": [ "*" ]
             }
         ]
     }
 }

注:
appID: 内容为 TeamID+Bundle Identifier , 例 XXXXXX.xx.xxx.xx
paths：设定你的app支持的路径列表，只有这些指定的路径的链接，才能被app所处理。星号的写法代表了可识别域名下所有链接。

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

使用 * 指定整个网站
1.包括特定的URL，例如/sub/im/，以指定特定的链接
2.附加 * 到特定网址，例如/sub/video/*，指定您网站的某个部分
3.指定不应作为通用链接处理的区域，请在路径字符串的开头添加“NOT”（包括后面的空格）

例如

"paths": [ "/sub/im/", "/sub/video/*", "NOT /sub/nor/2021/*"]

---

二.服务端

这里需要后台的小伙伴配合一下

1.服务端提供一个支持https的域名（必须支持https）
2.将上面生成好的json文件(apple-app-site-association)放到上面域名的服务器根目录下或者.well-known目录下

---

三.iOS客户端

配置开发者平台

1.登陆苹果开发者管理后台
2.打开 Member Center --- Certificates, Identifiers & Profiles
3.打开 Identifiers，找到项目对应的Identifier并打开
4.勾选Associated Domains选项

开发者平台配置

项目配置

5.打开我们的项目工程，然后继续打开我们的工程配置中的Signing&Capabilities
6.点击左上角的“+Capability”，然后选择Associated Domains
7.输入对应的Domains 例:你的Universal Links域名为www.test.com, 那么你的Domains的内容即为: applinks:test.com

项目配置applinks

8. 最后一步, 在appDelegate中, 添加如下的代码

@interface AppDelegate () {
    //1.解决打开未启动的app无法跳转指定页面的问题
    dispatch_group_t dispatchGroup;
}
@end

@implementation AppDelegate
//当用Universal Links启动APP时就会调用下面的方法
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray> * _Nullable))restorationHandler {    

    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *webpageURL = userActivity.webpageURL;
        NSLog(@"====== Universal Links启动APP links:%@======", webpageURL.absoluteString);

        if ([webpageURL.absoluteString containsString:@"test.com"]) {
            //判断域名是自己的网站，进行我们需要的处理
            UINavigationController *nav;
            if (self.tabBarController && self.tabBarController.viewControllers.count) {
                NSInteger index =  [self.tabBarController selectedIndex];
                nav = [self.tabBarController.viewControllers objectAtIndex:index];
            }else {
                nav = nil;
            }

            //4.解决打开未启动的app无法跳转指定页面的问题
            dispatch_group_notify(dispatchGroup, dispatch_get_main_queue(), ^{
                //跳转CDVViewController
                [[MXKit shareMXKit] pushToUniversalLinksUrlString:webpageURL.absoluteString withNavController:nav withCallback:nil];
            });
        }
    }
    return YES;
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //2.解决打开未启动的app无法跳转指定页面的问题
    dispatchGroup = dispatch_group_create();
    dispatch_group_enter(dispatchGroup);

    //doSomething...

    //3.解决打开未启动的app无法跳转指定页面的问题
    dispatch_group_leave(dispatchGroup);
    return YES;
}

这样, 我们就实现了, 点击www.test.com跳转到app的功能了.