Universal Links(通用链接)详解

前言

本文介绍Universal Links(通用链接)是什么，有什么作用？以及具体做法。

一：Universal Links(通用链接)是什么，有什么作用？

iOS 9之前，一直使用的是URL Schemes技术来从外部对App进行跳转，但是iOS系统中进行URL Schemes跳转的时候如果没有安装App，会提示无法打开页面的提示。
iOS 9之后起可以使用Universal Links技术进行跳转页面，这是一种体验更加完美的解决方案。

简而言之: Universal Links 是从浏览器或者网页上打开链接跳转到手机上的app。

我们在该链接域名根目录配置过的一个链接(直接跳转到我们app)；也可以在该链接中放置对应的H5页面(点击H5页面按钮跳转到我们app)。

当用户的点击该链接，只要手机中安装了支持该链接的APP就会直接进入到APP中。如果没有安装APP则会跳转到Safari浏览器中，展示H5页面。对用户来说则是一个无缝跳转的过程。

Pasted Graphic 1.png

使用Universal Link(通用链接)跳转的好处？？？

1, 唯一性: 不像自定义的URL Scheme，因为它使用标准的HTTPS协议链接到你的web站点，所以一般不会被其它的APP所声明。另外，URL scheme因为是自定义的协议，所以在没有安装 app 的情况下是无法直接打开的(在Safari中还会出现一个不可打开的弹窗)，而Universal Link(通用链接)本身是一个HTTPS链接，所以有更好的兼容性；
2, 安全: 当用户的手机上安装了你的APP，那么系统会去你配置的网站上去下载你上传上去的说明文件(这个说明文件声明了当前该HTTPS链接可以打开那些APP)。因为只有你自己才能上传文件到你网站的根目录，所以你的网站和你的APP之间的关联是安全的；
3, 可变: 当用户手机上没有安装你的APP的时候，Universal Link(通用链接)也能够工作。如果你愿意，在没有安装你的app的时候，用户点击链接，会在safari中展示你网站的内容；
4, 简单: 一个HTTPS的链接，可以同时作用于网站和APP；
5, 私有: 其它APP可以在不需要知道你的APP是否安装了的情况下和你的APP相互通信。

支持Universal Link（通用链接）
先决条件：必须有一个支持HTTPS的域名，并且拥有该域名下上传到根目录的权限（为了上传Apple指定文件）。

二：项目业务场景两种情况：

1，APP分享出一个链接到微信，微信上点击此链接，直接跳到APP

2，APP分享出一个链接到微信，微信上点击此链接，先打开一个网页，网页上有个按钮，点击按钮跳转到APP。

三：配置步骤

1, 微信开发者平台（比如分享到微信）

2, 配置指定apple-app-site-association文件

3, 苹果开发者账号网站配置和项目配置

4, 需要去第三方平台设置（比如友盟）

一：分享的平台配置(比如微信)
①微信开发者平台
在微信应用配置中就需要填写Universal Link 配置了注意一定是: https:// 作为开头,以/结尾，中间就是在xcode 填写的域名 且不能带参数例:

https://www.Share.com/

Bundle ID c.png

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

  [WXApi registerApp:@"APPID" universalLink:@"https://www.Share.com/"];

二：配置指定apple-app-site-association文件
①apple-app-site-association文件创建编辑其内容
需要创建一个apple-app-site-association文件，必须命名为apple-app-site-association，切记没有后缀。

终端创建：

touch  apple-app-site-association

文件内添加json格式数据，内容如下：

{
 "applinks":{
 "apps":[],
 "details":[
 {
 "appID":"9JA89QQLNQ.com.apple.wwdc",
  "paths": [ "*" ]
 }
 ]
}
}

如果一个域名下面有多端APP，可写作

{
    "applinks":{
        "apps":[],
        "details":[
            {
                "appID":"9JA89QQLNQ.com.apple.wwdc",
 "paths": [ "*" ]
            }
            {
                "appID":"47B89MSKWP.com.apple.xuem",
                 "paths": [ "/app/*", "/qq_conn/2222222/*"]
            }
        ]
    }
}

1，apps：是限制只能在这几个app中使用，基本是不填写，所以是空数组

2，appID ：为teamId.bundle identifier形式，9JA89QQLNQ就是teamId，com.apple.wwdc是项目identifier。
登陆开发者中心，在Account -> Membership里面可以找到Team ID。

3，details：数组中可以配置多个APP的信息，如果公司内有多个APP需要支持Universal link，则可以直接添加多个

4，paths：设定你的app支持的路径列表，只有这些指定路径的链接，才能被app所处理。*的写法代表了可识别域名下所有链接

5，/app/*是自己定义的路径；

/app/*是自己定义的路径；
/qq_conn/22222222/*需要根据QQ互联平台设置，22222222是QQ互联后台对应应用的APPID。
如果上传人员给你的访问路径是：
https://www.baidu.com/.well-known/apple-app-site-association 或
https://www.baidu.com/apple-app-site-association则：
微信开放平台的Universal Link填写是：https://www.baidu.com/app/
QQ互联平台的Universal Link填写是：https://www.baidu.com/qq_conn/22222222/

②上传指定文件
将这个文件上传到你的服务器，可以将这个文件放到服务器的根目录下，也可以放到.well-known这个子目录下。这是为了苹果能获取到你上传的文件。
必须支持HTTPS协议，让我们请求 域名/apple-app-site-association能请求到。因为没指定请求头的类型，所以请求下来的是个文件。

对应连接分别为

//xxx 为服务端的域名
https://xxx/apple-app-site-association
https://xxx/.well-known/apple-app-site-association

上传完后，让上传人员给你一个访问路径，先访问一下，看看是否能够获取到，当你在浏览器中输入这个文件链接后, 出现下图就可以了：

image.png

此外服务器上apple-app-site-association的更新不会让iOS本地的apple-app-site-association同步更新，即iOS只会在App第一次启动时请求一次，以后除非App更新或重新安装，否则不会在每次打开时请求apple-app-site-association。

三：苹果开发者账号网站配置和项目配置
①在开发者中心配置Associated Domains
苹果开发者官网，去配置开启identifiers 在appid中找到需要配置app的appid，copy下来。然后打开Associated Domains功能一定配置新的证书文件。

选择Associated Domains

点击Save

记得最后要更新下载证书，替换原来的证书

image.png

②在Xcode开发工具配置Associated Domains
开发者平台配置完成后，进入Xcode的项目中此处点击+ Capability，添加Associated Domains在其中的Domains中填入你想支持的域名，必须以applinks:为前缀。

配置Domains，一定是applinks:+配置的域名 例如：

applinks:www.Share.com

image.png

举例：如果上传人员给你的访问路径是：

https://www.baidu.com/.well-known/apple-app-site-association 
或
https://www.baidu.com/apple-app-site-association

则Domains中填入如下，配置好后run起来

applinks:www.baidu.com

注意：

Universal link的域名和H5页面URL的域名不可以是同一个，详情请看Universal link同域不能唤起

Universal Link有跨域问题，Universal Link必须要求跨域，如果不跨域，就不会跳转（iOS 9.2之后的改动）
假如当前网页的域名是A，当前网页发起跳转的域名是B，必须要求B和A是不同域名才会触发Universal Link，如果B和A是相同域名，只会继续在当前WebView里面进行跳转，哪怕你的Universal Link一切正常，根本不会打开App
Universal Link请求apple-app-site-association时机

当我们的App在设备上第一次运行时，如果支持Associated Domains功能，那么iOS会自动去GET定义的Domain下的apple-app-site-association文件

③xcode 配置

TARGETS

Info

LSApplicationQueriesSchemes 添加一个元素weixinULAPI

General.png

④appdelegate 里面设置见小码快运
当点击某个链接，直接可以进我们的app了，但是我们的目的是要能够获取到用户进来的链接，根据链接来展示给用户相应的内容。

比如: 我们进来通过点击一个网页上的按钮进入app后，想去某个商品的详情页，怎么做？下面，这里就是通过这种方式，判断商品的详情的请求url然后，截取参数，在跳转到商品详情页的时候传过去。

我们需要在工程里的实现AppDelegate里对应的方法：

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler {
 if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
     NSURL *url = userActivity.webpageURL;
 if (url是我们希望处理的) {
       //进行我们的处理
 } else {
     [[UIApplication sharedApplication] openURL:url];
 }
 }
 return YES;
}

四：需要去第三方平台设置（比如友盟）

Scheme.png

然后工程项目里面的配置，友盟UMSocialGlobal 配置

[UMSocialGlobal shareInstance].universalLinkDic = @{
    @(UMSocialPlatformType_WechatSession):@"https://shufa.fanglige.com/applink/"
};

更改回调

- (void)setupUSharePlatforms {
    /* 设置微信的appKey和appSecret */
    [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_WechatSession appKey:@"wx59530f055084abb7" appSecret:@"795af367a7b85a868ed75c1c921ca4a2" redirectURL:nil];
    /*设置小程序回调app的回调*/
    [[UMSocialManager defaultManager] setLauchFromPlatform:(UMSocialPlatformType_WechatSession) completion:^(id userInfoResponse, NSError *error) {
        Log(@"setLauchFromPlatform:userInfoResponse:%@", userInfoResponse);
    }];
}

其他

支持HTTPS呀，一定要是符合苹果认证的HTTPS证书呀。

系统问题，确保iOS9.0以上

配置文件问题，apple-app-site-association文件中配置的path和测试用的通用链接不一致，注意是区分大小写的。

域名问题，Xcode中配置的域名一不小心写错了。

前端开发经常面临跨域问题，必须要求跨域，如果不跨域，就不行。只有当前webview``的URL域名，与跳转目标URL域名不一致时，Universal Link(通用链接)才生效。

四：Universal Link(通用链接)相关验证

1，苹果为了方便开发者，提供了一个网页来验证我们编写的这个apple-app-site-association是否合法有效，进入验证网址进行验证
注意：手机上必须安装你需要跳转的应用并配置Associated Domains

a) 在Safari输入Universal Links，查看是否弹出跳转链接
b) 在iOS原生备忘录上, 输入Universal Links，点击是否可以跳转app

在iOS设备中的备忘录中输入APP能识别的链接，然后直接点击此链接，就会直接跳转到你的app了。或是长按，在出现的弹出菜单中第二项是在XXX中打开，这也代表着成功：

image.png

2，或是你将要测试的网址在Safari中打开，在出现的网页上方下滑，可以看到有在xxxx应用中打开，出现菜单:

image.png

注意：测试。
一般只会在APP下载完后初次启动才会下载这个文件，所以如果修改了apple-app-site-association文件，请删除APP后重新下载。

五：`Universal Link` 的运行机制原理

当App初次安装后或者更新版本后的第一次启动（第二次启动就不会），向工程配置的applinks:的域名请求apple-app-site-association配置文件。
App自动的将apple-app-site-association配置文件向iOS系统配置。
当任何WebView发起UniversalLink的url的时候，系统遍历注册过的通用链接，如果命中则直接打开App触发Delegate方法。
如果没命中，WebView继续跳转加载url。
以上都是系统默默替你做的，我们要做的就是确保配置的正确性。

六：常见报错与解决方案

在info.plist中添加URL scheme为微信开放平台的AppID。如果不配置的话，微信无法返回App。

问题1：拉起微信后提示“由于应用universal link校验不通过，无法完成微信分享”
原因：很可能是App中注册的AppID同微信开放平台的不一样。
解决：统一AppID后解决。

WXApi.registerApp(kWeixinSocial.app_key, universalLink: kWeChatULUrl)

问题2：拉起微信后进行授权，然后立刻返回App，然后再次调起微信。log中发现类似下面的语句：

wxTest123Test123Test123://resendContextReqByScheme?wechat_auth_context_id=123455678

原因：由于通用链接授权失败，第二次降级为URLScheme方式启动微信。
解决：在微信公众平台注册的通用链接要带路径，App的registerApp的通用链接参数也一定要带路径，保持一致，单纯的域名就会导致二次降级启动。
正确配置后，从微信返回的通用链接形式是:

https://域名/路径/微信平台的AppID

问题3：为毛有的手机成功了，有的手机就不行呢？

上面也提到过，因为网络波动有可能会导致部分用户第一次安装时，无法下载apple-app-site-association文件，这个只能引导用户删除重装或者在迭代时修改Associated Domains配置告诉系统重新下载apple-app-site-association文件。

另外一种可能是苹果抽风导致，笔者今年年初一碰到过一个蛋疼的问题，从中午一直到下午4点发现重复的删除重装，app也不会请求服务器的apple-app-site-association文件，过了4点之后就好了。当时因为时间特殊并没有深究到底是什么原因导致。

问题4：服务器换域名了肿么办？
当Associated Domains添加新的 Domains的之后，在app再次启动的时候抓包发现（不需要删除重装），苹果会给新添加的这个Domains发送一个请求，请求新Domain下的apple-app-site-association文件。也就是说Associated Domains发生改变的话，系统是会知道的，这样就可以在迭代的时候删除旧的域名，添加新的域名了。另外Domains的配置也可以使用通配符，例如：applinks:*.mywebsite.com

问题5：全都配置好了，项目也能唤起来了，web页面到底该怎么弄呀？
通用链接指向的服务器的页面到底应该是哪个？之前iOS和安卓用的是同一个网页，也就是说从APP内分享出去的网页，可以被苹果用户和安卓用户同时查看，在这里需要由web童鞋使用js判断当前所处的平台以及其系统。如果是安卓用户，则显示安卓相关提示页面。如果是苹果用户，那么分两种：

如果是9.0以上的系统，相关的在APP内打开按钮的链接配置的就是我们的Universal Link(通用链接)了，且该通用链接地址指向的是一个APP下载引导页面，那么当用户安装了APP，即可通过通用链接唤醒APP；如果用户没有安装app，那么就会跳转到通用链接指向的APP下载引导页面，达到最大化的客户导流。

如果是9.0以下的系统，则相应的 在APP内打开的按钮就会发一个跳转到我们APP URL Scheme的重定向，以实现在Safari中唤醒我们的APP。

问题6：当使用通用链接唤醒APP之后，手机右上角有一个小按钮？
那个小按钮只有(在iOS10.0以下才有)是可以引导用户跳转到Safari中，名字叫bread crumbs button（面包屑），当然也去不掉;并且当用户点过这个按钮后，再点击Universal Link(通用链接)不会直接打开对应的APP。

问题7：备忘录和safari中都可以打开app，怎么分享到其他app里面就不行了？
未跨域导致的，如：分享到微信的链接是https://www.mydomain.com/share.html，然后该网页中的在app内打开按钮配置的通用链接为https://www.mydomain.com/index.html。跨域的意思是说，通用链接和调用通用链接的网页不要使用同一域名。即如果通用链接域名为www.mydomain.com，则通用链接所处的网页域名就不能是www.mydomain.com。

问题8：iOS13****中在****safari****中可以打开相应****APP****，但是从微信或其他****APP****中点击去****safari****怎么就打开了别的****APP****？
在iOS13之前在其他APP去safari中打开Universal Link(通用链接)系统匹配域名是全匹配，而在iOS13之后规则发生了变化，猜测是包含关系。比如在iOS13之前，如果Universal Link(通用链接)为w.mydomain.com那么在微信或者其他APP访问www.mydomain.com然后点击去safari打开则不会拉起相应APP,而在iOS13则会拉起相应APP。而在safari中输入的链接则依然和iOS之前一样，只有www.mydomain.com才会提示打开相应APP。

Universal Links(通用链接)详解

前言

一：Universal Links(通用链接)是什么，有什么作用？

二：项目业务场景两种情况：

三：配置步骤

四：Universal Link(通用链接)相关验证

五：Universal Link 的运行机制原理

六：常见报错与解决方案

你可能感兴趣的:(Universal Links(通用链接)详解)

五：`Universal Link` 的运行机制原理