iOS deepLink 唤醒app

需求

• 用手机打开我们的网页，点击打开按钮或者收藏按钮，可以直接唤醒app，如果未安装app，则跳转到应用商店提示下载。

目前通用的方式有三种：

• Universal Links；
• url schemes；
• meta标签；

下面就来介绍一下这三种方式

meta标签

这种方式在国外的网页和app上好像比较常见，可以在网页上的meta标签做手脚，类似下图的效果：

meta.jpg

meta标签的格式如下：

<meta charset="UTF-8" name="apple-itunes-app" content="app-id=1234567890, affiliate-data=myAffiliateData, app-argument=yourScheme://">

这样添加meta标签后，使用Safari打开网页就会在网页上方，显示自己app的信息导航条。
如果没有安装app可以点击跳转App Store去下载，如果安装了app就会自动打开app。

url Schemes

步骤如下：在项目里，info最下端，找到URL Types，add一个新的url scheme，这里几个参数最好都填一下，Url Schemes是必填的，如下图所示：

url schemes.png

这里配置完之后，info.plist文件自动会加入一个配置：

info.png

接着在AppDelegate里的handleOpenURL捕获跳转过来的url，获取参数：

-(BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
    if (!url) {
        return  NO;
    }
    
    NSString *urlStr = url.absoluteString;
    NSLog(@"handleOpenURL:%@",urlStr);
    
    return YES;
}

接着可以在模拟器的Safari浏览器地址栏输入：TestOC://
格式为URL Schemes : //三部分组成。
点击open，就会跳转到app，并且走到handleOpenURL这个代理方法中。

Universal Links

什么是Universal Links

Universal Links是iOS9之后支持的一个通用链接，iOS9以上的用户可以通过点击这个链接无缝的重定向到一个app应用，而不需要通过Safari打开。
如果用户没有安装这个app，则会再Safari中打开这个链接。

详细的配置流程如下：

一、创建一个名为apple-app-site-association，包含固定格式的json文件。
关于apple-app-site-association文件的格式如下：

{
"applinks": {
        "apps": [],
        "details": [
            {
                "appID": "teamID.bundleId",
                "paths": ["/deaplink","/wwdc/news/","*"]
            },
            {
                "appID": "ABCD1234.com.apple.wwdc",
                "paths": [ "*" ]
            }
        ]
    }
}

这里需要注意的是，文件名必须为apple-app-site-association不能有后缀，需要注意。

appID的格式为teamID .bundle id，paths就是配置哪些路径可以唤醒，哪些路径不能唤醒，可以使用* ? 帮助配置。这里paths配置的路径是区分大小写的。

二、验证apple-app-site-association文件

文件配置完成之后，需要将文件放到服务器的根目录下，或者是.well-known这个子目录下。

• 确保使用https://yourDomain.com/apple-app-site-association这个链接可以访问到，yourDomain就是你的服务器域名。
• 也可以使用苹果的验证网站（https://search.developer.apple.com/appsearch-validation-tool/），验证文件是否能被苹果请求到。如果是未上线的问题，使用验证网站可能会提示你Error no apps with domain entitlements出现该提示则说明配置正确，出现404则说明配置错误。

三、项目和工程配置

使用Universal Links需要给app IDs配置打开 Association Domain选项，进入开发者网站，找到自己的bundle id，edit，打开Association Domain。

然后就是工程配置。

在工程的Capabilities中开启Association Domain 并且可以添加多个domains，格式为applinks: 服务器域名

接着在AppDelegate中实现代理方法，注意跟url schemes的代理方法不是同一个

-(BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{

    NSLog(@"userActivity : %@",userActivity.webpageURL.description);
    return YES;
}

当app通过Universal Link 唤醒是 就会回调到这个方法，获取信息。

四、验证以上配置

在备忘录中，输入https://yourDomain.com/apple-app-site-association并点击，如果出现在***中打开则说明配置成功。

Universal Links总结

• 服务器必须支持https，且必须是苹果新人的TSL证书，苹果支持的根证书列表；
• apple-app-site-association文件名千万不能写错，没有后缀；
• 只有在初次安装时，才会去请求下载apple-app-site-association文件，所以可能会出现因为网络波动导致下载失败的情况，当工程中修改了Association Domain配置时，也会重新去请求下载apple-app-site-association文件。
• 还有一个问题，配置完成之后，备忘录和Safari都可以成功，但是在其他应用里面不成功，未跨域导致的，如：分享到微信的链接是(https://www.mydomain.com/share.html)，然后该网页中的“在app内打开”按钮配置的通用链接为 (https://www.mydomain.com/index.html)。
  跨域的意思是说，通用链接 和 调用通用链接的网页不要使用同一域名。
  即如果通用链接域名为“www.mydomain.com”，则通用链接所处的网页域名就不能是“www.mydomain.com”。

ps.之前用Universal Links可以在微信中直接唤起app，目前好像也已经被企鹅和微信给屏蔽了。只能说一句太流氓了。现在大多数app的做法又跟url scheme类似了，如果分享到微信，加一层蒙版，引导在Safari中打开。

---

觉得有用，请帮忙点亮红心

---

Better Late Than Never!
努力是为了当机会来临时不会错失机会。
共勉！