ios app相关跳转

---

跳转APP的方式目前主要有两种：URL Scheme和Universal Links

---

一、URL Scheme

• scheme是iOS9之前比较主流的一种跳转方案了， 更多的是用在了两个APP相互跳转中。也可以在Safari中输入schema://跳转到App内部。
• scheme跳转app会有提示框提示取消或者打开，如果没有安装app的会提示框提示无法打开网页（这一点不是很友好）。

---

1、app之间跳转：app1跳转至app2并传值

• 在app1的target → info → url type 里创建一个url scheme为com.cs.app1（这个是app1的scheme）
• 在app2的target → info → url type 里创建一个url scheme为com.cs.app2（这个是app2的scheme）
• 在app1的info.plist里创建白名单Queried URL Schemes里添加app2的scheme
• 在app2的info.plist里创建白名单Queried URL Schemes里添加app1的scheme

设置好以上步骤之后，在app1里完成如下代码（app2雷同）

//app1跳转app2方法
- (void)pushApp2:(UIButton *)sender
{
    NSURL *url = [NSURL URLWithString:@"com.cs.app2://cs?name=xiaoa&age=10&sex=1&address=22222"];
    
    if ([[UIApplication sharedApplication] canOpenURL:url]) {
        //设备安装了app2  //打开url
        if (@available(iOS 10.0, *)) {
            [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:nil];
        } else {
            [[UIApplication sharedApplication] openURL:url];
        }
    }else {
        //设备没有安装app2, 打开AppStore去下载
        NSString *appid = @"xxx";
        NSString *str = [NSString stringWithFormat:@"itms-apps://itunes.apple.com/cn/app/id%@", appid];
        NSURL *url = [NSURL URLWithString:str];

        if (@available(iOS 10.0, *)) {
            [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:nil];
        } else {
            [[UIApplication sharedApplication] openURL:url];
        }
    }
}

在app2的AppDelegate里完成接收（app1雷同）

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
    //将url转为字符串
     NSString * urlString = url.absoluteString;
    //判断是通过什么跳转过来的
    if ([urlString containsString:@"com.cs.app2"] ) {
        NSLog(@"返回值转字典___%@",[self queryToDict:url.query]);
    }
    return YES;
}

//query转字典
- (NSDictionary *)queryToDict:(NSString *)query
{
    if (query.length == 0 || [query isEqualToString:@"nil"] || [query isEqualToString:@"null"] || [query isEqual:[NSNull null]]) {
        return nil;
    }else{
        NSMutableDictionary * paramsDict = [NSMutableDictionary dictionary];
        NSArray * temp = [query componentsSeparatedByString:@"&"]; //根据&分割字符串
        for (NSString * str in temp) {
            NSArray * tempStr = [str componentsSeparatedByString:@"="]; //根据=分割字符串
            [paramsDict setObject:tempStr[1] forKey:tempStr[0]];
        }
        return [paramsDict copy];
    }
}

---

2、Safari跳转app

按照app之间的跳转方法设置好url type后，只需调用url = com.cs.app1://cs?name=xiaoa&age=10&sex=1&address=22222 即可。

* 注意：

当设置的url type有大写字母，例如：com.cs.App1 时，在AppDelegate里接收数据判断url.absoluteString时，当app之间跳转时区分大小写（返回com.cs.App1），Safari跳转app时不区分大小写（返回com.cs.app1）。

---

二、Universal Links

• 先看一下官方文档
• Universal Links（通用链接）是iOS9.0出的技术。如果我们的应用支持通用链接，那么就可以通过https链接来打开APP（手机中已经安装此APP），或者跳转到https链接（手机中没有安装此APP），必须是https。

---

1、生成 apple-app-site-association 文件

• 【原理】：在第一次安装APP的时候，手机的iOS系统会去指定的路径（这个路径是后面后端开发人员给的）下载apple-app-site-association文件。通过这个文件，iOS系统就会知道哪些URL是Universal Links，哪些不是Universal Links。从而我们指定的路径可以发生跳转。这个apple-app-site-association文件需要开发者去创建和放到一个苹果可以访问的服务器上。这个过程在xcode调试的时候也会发生。

• 新建一个名字为apple-app-site-association的纯文本文件（Json格式），不要有任何后缀，文件内容如下：

{
    "applinks": {
        "apps": [], //是限制只能在这几个app中使用， 基本是不填写，所以是空数组
        "details": [ //如果有多个App需要支持Universal，details数组中可配置多个App的信息
            {
                "appID": "ABCD1234.com.apple.cs1", //TeamID.BundleID格式自行替换TeamID和BundleID
                "paths": [ "/AHost/*", "/BHost/*"] //path 过滤需要处理的地址，不需要过滤处理则配置通配符*
            },
            {
                "appID": "EFGH5678.com.apple.cs2",
                "paths": [ "*" ]
            }
        ]
    }
}

• appID：组成方式是 TeamID.BundleID。登陆开发者中心，在Account → Membership里面可以找到Team ID。
• paths：设定App支持的路径，只有这些设定的路径的链接，才能被App所处理。通配符*代表支持域名下所有链接。如果是一个服务器对应一个APP跳转，那么这里其实填写一个 “ * ” 就可以了。
  如果一个服务器支持多个APP跳转，则需要用不同的专用路径节点（填写 “ /节点/ * ”）去互相屏蔽。比如地址：https://cs.com/AHost/XXX（paths填写 " /AHost/ * "只能用于A应用的跳转；地址 https://cs.com/BHost/XXX（paths填写 " /BHost/ * "）只能用于B应用的跳转。

* 注意：配置apple-app-association

• 域名必须支持https
• 域名根目录下放这个文件apple-app-site-association，不带任何后缀
• 文件为json格式保存为文本即可
• json按着官网的要求填写即可
• 测试是否正确，直接访问域名+配置文件名如果能正确访问则放置的位置是正确的。例如你想通过访问”https://cs.com/xxx“来打开app，那么你要把配置文件放在”https://cs.com/“对应服务器根目录，通过访问”https://cs.com/apple-app-association“能直接访问配置文件则是正确的。

---

2、apple-app-site-association文件的存放

• 这个文件创建好之后，交给后端人员。让他们把这个文件放到指定的url的根目录下（URL不一定要指定，可以后端人员给啥我们就用啥也行。这个URL在配置XCode会用到）。这个根目录下除了放这个文件不要放其他东西。我们的URL是 https://cs.com/。

• 【验证】：验证后端是否正确放置的方法，这是浏览器输入这个地址，会直接下载apple-app-site-association文件。如果没有下载到这个软件，说明服务器配置不对。
  可以使用apple的验证网站来验证文件是否能够被访问到。出现Error no apps with domain entitlements 是因为还没有发布，出现404错误，则说明apple-app-site-association文件未上传成功或者使用上面的域名不能访问到。

* 注意：

对于paths有填写专用路径节点的情况（比如我这里写的【"paths": [" /AHost/* "]】）， 服务器不用在这个路径下添加真实的文件访问路径！访问applinks这个域名网址的时候，找不到的话不要重定向！！访问applinks网址的时候，找不到的话不要写一个专门的空白页！

---

3、Identifiers、Profiles相关配置

• 登录Apple Developer，选择Identifiers，在Capabilities里勾选Associated Domains 然后点Save保存。
• 选择Profiles重新选择上步设置好的Identifiers，之后下载配置文件双击安装。

---

4、app相关配置

• 在target → signing&capabilities → associated domains里添加我们要访问的地址的url。
  配置associated domains的applinks，格式为：“applinks:xxx”。这里的xxx为一个域名，没有“https://”前缀，也没有“/”后缀。
  例如：我们访问的地址是https://cs.com/AHost/XXX，在associated domains里添加：applinks:cs.com 即可。
• 然后在我们xxx.entitlements文件中查看associated domains里是否正确，不正确就修改。
• 在AppDelegate里接收处理如下：

//Universal Links
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler
{
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *webpageURL = userActivity.webpageURL;
        NSString *host = webpageURL.host;
        // 在这里写需要的逻辑，比如跳转到某个详情页
        if ([host isEqualToString:@"cs.com"]) {
            
        } else{
            if (@available(iOS 10.0, *)) {
                [[UIApplication sharedApplication] openURL:webpageURL options:@{} completionHandler:nil];
            } else {
                [[UIApplication sharedApplication] openURL:webpageURL];
            }
        }
    }
    return YES;
}

---

5、完成跳转

• 安装了 App 时，通过 domain + path ，系统软件内部能够直接跳转到 App。
• 未安装 App 时，通过 domain + path ，跳转到 Safari 打开对应的引导页。
  例如：点击 https://cs.com/AHost/xxx 即可跳转我们设置好的domain的app。
  https://+applinks配置的域名+apple-app-site-association里的paths

* 注意：

首先如果使用 Universal Link ，那么就只用使用 domain/path 的路径来完成跳转。另外，又需要一个引导页，所以这个引导页必须发布到后端服务器对应的 path 中，或者使用前端路由到这个引导页。

---

6、最后问题

• 有人说：因为xcode的签名用的自动签名（即勾选了Automatically manage siging），导致iOS 系统 直接没有在APP 安装的时候去请求apple-app-site-association文件。【解决】：取消勾选Automatically manage siging。

• apple-app-site-association文件改动后重新放到服务器。电脑浏览器下载下来的 apple-app-site-association文件依旧是修改前的数据。浏览器清理缓存后，下载下来的最新的apple-app-site-association文件。

---