iOS通用链接Universal Link典型场景介绍及使用

需求：

用户从qq/微信分享出去的H5页面，当点击H5页面的某个按钮时，要实现如下功能：

1.当用户未安装App时，跳转到AppStore页面引导用户下载

2.当用户已安装App时，唤醒App并跳转到App里面的某一个指定页面

传统的url schema实现方式存在两个弊端，一是跳转的时候会有一个提示框：“是否打开XXX”，用户体验不好，二是微信屏蔽了URL Scheme，必须是在微信的白名单里面才可跳转，也就意味着用户在微信里面是无法一键直达App的。这对于大多数公司来讲，是难以承受的。而通用链接Universal Link正是可以解决上述问题的技术手段。

一、通用链接介绍及优点 :

iOS 9 Universal Links 通用链接可参考这篇博文

二、通用链接具体实施步骤

     这里可以分两种实现方式，第一种是自己去配置通用链接，第二种是通过一些第三方sdk来实现此功能，笔者在这里强烈推荐第二种，我自己有尝试第一种配置，坑多，而且配置半天后发现得到的链接始终通不过测试，怀疑是服务器那边不支持。而第二种配置的话，坑少，而且还会节省大量的开发时间，保证该功能的迅速上线。

①自己配置通用链接 

iOS的UniversalLink开发总结  不建议 坑太多。

②用第三方sdk去集成配置（魔窗，LinkedME等）

下面以魔窗为例，讲解如何配置。魔窗iOS集成文档

用魔窗的话iOS端只需要做三部分操作，分别是魔窗后台配置部分，Xcode配置部分，代码实现部分。下面将详细描述步骤。

魔窗后台配置部分

①注册一个魔窗账号 魔窗注册 

②账号注册完毕后，登录魔窗点击右上角新增产品然后选择App。

③要填写的信息分为三部分，分别是产品信息，App信息，魔窗位信息。产品信息没什么可讲的，魔窗位信息可以不填 无视。App信息页面如下图

应用宝下载地址，基本大多数公司都会有，直接填上即可。

应用名称和Bundle ID不用解释 直接填上

URL Scheme：这个LiveRoom名称可以自己随便起，但要保证跟Xcode里面URL Scheme 保持一致（后面会讲解Xcode中的配置）。

下载地址就是应用程序在App Store里面的下载地址。

Team ID ：如何获取Team ID 按照教程得到填写即可。

将这些都填写完毕后，魔窗会给你分配一个域名，这个域名会在后面Xcode中配置使用到。

魔窗分配的域名

魔窗位信息无视，下一步，然后注册完毕后，会得到一个App key，这个是魔窗App key

魔窗App key

④想要使用深度链接，还需要配置魔窗的mlink服务，如下图

点击添加mLink服务

点击添加mLink服务后，如下图

mLikn服务配置页面

mLink服务名称可自己配置  mLink服务key也可自己配置 这个key后面代码里面需要使用。

然后就是URL如何拼接了。比如你app中有用户的个人中心，且可以用参数决定是否显示用户的详细信息，那么您需要输入的页面URI如下：mw://www.mycompany.com/user/:userId?containsDetail=:containsDetail。这里mw://为URI Scheme，可从外部唤醒App，在“App管理”中设置。www.mycompany.com是hostname，user是path。url不懂得如何配置的可参考魔窗上面的点击查看如何配置URL，简言之，就是服务器地址后面拼参数。

这些填完以后，会得到一个短连接。

至此，魔窗的所有配置均已做完。

小结：魔窗的配置是为了获得五个关键参数，以供后面配置使用。分别是URL Scheme，魔窗App key，魔窗mLink key  魔窗域名 魔窗短连接。

Xcode配置部分

Xcode这边配置非常容易，就两步即可。

①配置URL Scheme 这里的identifier可填可不填没影响，URL Schemes这里填在魔窗后台配置时，你写的URL Scheme，魔窗跟Xcode这里二者必须保持一致

Xcode URL Scheme配置

②applinks配置 这里的Domains一定要填你之前在魔窗配置后获得的那个魔窗域名，这里要保证不能出差错，否则无法完成跳转

Xcode applinks配置

Xcode的配置到这里就完成了。

代码实现部分

①集成魔窗sdk，手动和cocopods两种方式，手动请参考魔窗文档，下面只讲cocopods集成

pod 'MagicWindowSDK'

pod install

记住不要pod update，因为魔窗sdk自己集成了微信分享，非常容易跟shareSDK 友盟分享SDK冲突。

②Appdelegate中实现注册魔窗

在didFinishLaunchingWithOptions这个app初始化方法里面， 其中MWKey就是魔窗key， liveRoomKey需要你替换成之前配置的魔窗mLink key。回调代码里面，不同的项目有不同需求，灵活应变即可。

注册并实现通用连接的回调

下图是官网推荐的回调代码内容：

魔窗推荐的回调代码

③Appdelegate中实现必要的方法，在.m中 实现以下这三个方法即可。这里我的openUrl有做判断，因为项目里面集成了友盟分享，如果不做判断的话，会很容易冲突。大家根据自己的项目，灵活处理即可。

至此，iOS端就完成了所有的配置，看着文章内容很多，其实配置起来还是很快很简单的。将你之前获得的魔窗短链，交给你们的web开发小伙伴，让他参考这篇文章，进行web端的配置即可魔窗JS API。（超简单）

小提示：如果你按教程配置完事了，发现qq分享出去的链接，可以正常跳到自家的App某个页面，而微信的不行，那么可以先排除是不是h5链接的原因。测试方法，直接用短连接+参数 https://ab9e1n.mlinks.cc/AcJF?roomId=0849170 如果类似这样的链接在微信里面正常，那么可推断是web端原因，如果这样的链接也不正常，那么则是App端没配置好，可检测下AppDelegate.m需要实现的那三个方法有没有实现，是不是写错了。