iOS 通用链接（Universal Link）配置详解

iOS 通用链接（Universal Link）配置

什么是通用链接？

通用链接是iOS9推出的一项新功能，如果你的应用（app）支持通用链接（Universal Link）之后，iOS用户能够在点击网页的链接的时候无缝的重定向到已经安装的app，不需要额外的任何操作。如果没有安装对应的app，那么点击链接会使用Safari打开网页。在iOS9以前，对于各种浏览器，Safari中唤醒app的需求，我们通常是只能使用scheme的方式。

为什么要突然改用通用链接的配置方式？

我们的项目中唤起第三方app一般是通过配置对应的URL Scheme的方式使用的，微信SDK的最新版本openSDK1.8.6 由于苹果iOS 13系统版本安全升级，为此openSDK在1.8.6版本进行了适配。 1.8.6版本支持Universal Links方式跳转，对openSDK分享进行合法性校验，提升使用过程中的安全性。

要求在注册微信appid时，必须要传入universalLink，以前的方法在旧版本仍然可使用。所以就开始研究通用链接（Universal Link）的配置

@interface WXApi : NSObject

/*! @brief WXApi的成员函数，向微信终端程序注册第三方应用。
 *
 * 需要在每次启动第三方应用程序时调用。
 * @attention 请保证在主线程中调用此函数
 * @param appid 微信开发者ID
 * @param universalLink 微信开发者Universal Link
 * @return 成功返回YES，失败返回NO。
 */
+ (BOOL)registerApp:(NSString *)appid universalLink:(NSString *)universalLin

如何配置通用链接？

1、创建json格式的一个空文件（取名必须为apple-app-site-association，并且没有后缀）

• 这里的appID是指：TeamID+BundleId的组成（例：9JA89QQLNQ.com.apple.test）（TeamID可以在开发者账号里面查看，BundleId是项目的Bundle Identifier）。
• 这里的paths是指：是设置允许的路径列表，可以是一个也可以是多个，最简单的方式是使用“*”，通配符，表示允许该域名下的任意路径。（注意：paths中的大小写是敏感的，一定要一一对应）

2、上传apple-app-site-association文件（这里就能拿到app中配置需要的域名）

（1）将apple-app-site-association文件发给服务器端的同事，让他上传到域名的根目录下或者.well-known的子目录下（这里的域名必须要是可访问的域名，由服务器端的同事给到）。

（2）Web server需要支持https，客户端通过https来访问，并且不支持重定向。

3、在app中处理通用链接

（1）添加对应的域名（上面知道的域名）到Capabilities

在项目里面定位到Capabilities，找到Associated Domains，点击允许按钮，在Domains中添加对应的域名。（Domains中的域名必须是使用applinks开头，然后输入自己的域名即可。注意：当app第一次启动之后，会自动从你自己的域名目录下下载这个apple-app-site-association文件。）

注：这里可能会遇到一个错误就是你的App ID中并没有允许使用Associated Domains，所以需要进入开发者中心，编辑App ID允许Associated Domains，并且重新生成对应的签证文件并下载安装。在最新xcode11，添加了该项，开发者账号该appId下自动打开

（2）实现AppDelegate里支持通用链接的实现方法

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
	//自己的实现代码
	
  return [WXApi handleOpenUniversalLink:userActivity delegate:self];
}

这里如果是从旧版更新WechatOpenSDK1.8.6版本的话，需要在这个里面调用微信里的这个方法，并且在Xcode中，选择你的工程设置项，选中“TARGETS”一栏，在 “info”标签栏的“LSApplicationQueriesSchemes“添加weixin和weixinULAPI，可通过微信开放平台的接入文档步骤一步步进行修改或添加。

注：这里的weixinULAPI注意大小写，我之前是添加了一个weixinulapi小写的进去，结果都注册失败，一直没找到原因，直到我调用微信打印log的方法，才知道是没添加到weixinULAPI这个schemes，大小写没区分