iOS9 Universal Links踩坑之旅，移动应用之de

2017-01-03 本文已影响9655人 kurt_wang

嘿哈.jpg

参考文章：
1.大招之官方文档
2.不错的博文
3.苹果验证通用链接是否可用的网站
4.通用链接文件存放的server需要支持https 苹果支持的https证书列表

简单粗暴，有一个需求:

手机打开我们的网站，点击打开按钮或者收藏按钮，用户如果已经安装app，跳转到app做相应的操作。

如果没有安装app，则跳转到应用商店提示用户下载安装。

方法1: URL Scheme

holy 个 shit 啊，第一时间想到的是url scheme ，然后将参数配置在url scheme后面，唤醒app再进行页面跳转逻辑。

但残酷的现实是企鹅和微信都把url scheme 唤醒app这种方式给禁了。

方法2: meta标签

然后考虑了在网页上对meta 标签做手脚，可以实现类似下图的效果：

meta标签示例.jpeg

meta标签的格式如下：

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

这样添加meta标签后的网页，使用safari打开的时候，就会在顶部显示自己app的导航条。
如果没有安装app点击能够跳转到appstore去下载，如果安装了app就能直接通过顶部的meta标签唤醒app了。

方法3:Why Universal Links？

上面两种方式都能实现某一方面的需求，但无法完美解决。于是就想到了iOS9之后的Universal Links。

什么是Universal Links呢？

Universal Links就是一个通用链接，iOS9以上的用户，可以通过点击这个链接无缝的重定向到一个app应用，而不需要通过safari打开跳转。

如果用户没有安装这个app，则会在safari中打开这个链接指向的网页。

如何支持Universal Links呢？

按照苹果官方文档来说，支持通用链接非常简单哟，只需要三步呢

1.创建一个名字叫做apple-app-site-association，包含固定格式的json文件

2.将这个文件上传到你的服务器，可以将这个文件放到服务器的根目录下，也可以放到.well-known这个子目录下。

3.配置app，然后在app里面添加代理方法

如果已经配置过Universal Links，那么在用户第一次安装app时，苹果会发送一个请求，请求你服务器上的apple-app-site-association文件。

请求apple-app-site-association文件成功之后，用户就可以使用Universal Links唤醒app了。

详细的配置流程如下

（1）关于apple-app-site-association文件的配置

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

创建一个包含上述格式的json文件，文件名字必须为apple-app-site-association，不能带后缀名，有的电脑设置的隐藏后缀名，这点需要注意。

appID

appID 的格式为 teamID.bundleId形式。

如何获取`teamID`呢？

登录开发者网站，找到Membership选项卡。

teamId.png

譬如说我的teamID是xxxxxxxxxxx，bundleId是com.mytest.app
那么我的appID就是：xxxxxxxxxxx.com.mytest.app

paths

paths配置，实际上就是限制哪些路径可以唤醒app，哪些路径不能唤醒app。格式如下：

"paths": [ "/wwdc/news/", "NOT /videos/wwdc/2010/*", "/videos/wwdc/201?/*"]

使用*配置，则整个网站都可以使用
使用特定的URL，例如/wwdc/news/来指定某一个特殊的链接
在特定URL后面添加*，例如 /videos/wwdc/2015/*, 来指定网站的某一部分
除了使用*来匹配任意字符，你也可以使用 ?来匹配单个字符，你可以在路径当中结合这两个字符使用，例如 /foo/*/bar/201?/mypage

需要注意的是：
配置的paths路径，是区分大小写的

验证`apple-app-site-association`文件

文件配置完成之后，将其上传到你的服务器根目录或者.well-known这个子目录下。

确保使用https://yourdomain.com/apple-app-site-association这个链接可以访问到，yourdomain.com为你的服务器域名。
也可以使用苹果的验证网站，验证文件是否能被苹果请求到。如果是未上线的应用，使用验证网站时可能出现如下提示：

Validation Tool.png

出现该提示为apple-app-site-association文件配置正确。
出现404错误码提示，则为apple-app-site-association文件未上传成功，或者使用https://yourdomain.com/apple-app-site-association路径无法访问。

（2）建立web网页和app应用之间的关联 -> `app IDs` 配置和项目配置

app IDs 配置

进入开发者网站，找到你自己的bundleId，可以点击edit按钮，开启associate domains，如下图：

associated domains.png

项目配置

在项目的Capablities中开启Associated domains，如下图：

appLinks.png
注意domains可以添加多个，前缀必须为applinks:，applinks:后为你的服务器的域名。

代码接收Universal Links唤醒

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

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

在appdelegate中实现上面这个方法，当使用Universal Links唤醒app时就执行这个方法。

（3）验证以上配置

快捷验证，在备忘录中输入https://yourdomain.com/apple-app-site-association，长按这个链接，出现下图提示则配置成功。

successful.png

某些坑

服务器必须要支持https，而且需要支持TLS1.2协议以上，不过相信苹果强制支持https之后，这个坑就会慢慢填上了。现在还有很多童鞋的服务器使用的免费的证书，或者证书不被苹果信任，然后就会导致无法下载apple-app-site-association。苹果支持的https根证书列表

只支持iOS9以上

apple-app-site-association文件名千万不能写错啊

使用charles抓包显示，只有初次安装app时才会去请求apple-app-site-association文件，所以测试时有可能因为网络波动导致apple-app-site-association文件获取失败。这种情况，多卸载几次，安装时使用4G。

验证各种配置的还有一个网站，需要打成ipa包丢上去。

小结一下

Universal Links的配置总结起来很简单：

去开发者网站配置appid，找到teamid
创建一个没有后缀名的apple-app-site-association文件，填写相应的配置
配置项目，并编写相应的唤醒处理逻辑

但是为什么要配置这些东西呢？配置他们的目的分别又是什么呢？我们换个角度来考虑一下

先来看一下审核条款中的一项规定

  2.5.6 Apps that browse the web must use the appropriate WebKit framework and WebKit Javascript.

  2.5.6 浏览网页必须要使用恰当的WebKit和WebKit JS，=͟͟͞͞( •̀д•́)app浏览网页使用的都是苹果的`WebKit`哟。

而Universal Links之所以可行，也正是因为这个‘恰当’的WebKit。运行在iOS上的所有app，当他们使用苹果的WebKit打开某一个链接时，WebKit肯定是能拦截到的。

那么，Universal Links相关配置的作用就非常明了了。

Q：appid和项目中为什么要配置支持associate domains呢？
A：为了在app启动的时候告诉系统，我这个app支持Universal Links呀，这样系统才方便根据项目中配置的domain域，去下载apple-app-site-association文件呀。

Q：apple-app-site-association文件配置了一堆是干啥用的呀？
A：作为WebKit加载链接时进行拦截，然后跳转到目标app的配置文件呀。

2017年9月14日更新----评论区问题汇总

按照上面写的配好了，怎么死活打不开呀？？？

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

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

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

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

为毛有的手机成功了，有的手机就不行呢？？？

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

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

服务器换域名了肿么办？？？

笔者做了一个小测试，当Associated Domains添加新的 Domains的之后，在app再次启动的时候抓包发现（不需要删除重装），苹果会给新添加的这个Domains发送一个请求，请求新Domain下的apple-app-site-association文件。

也就是说Associated Domains发生改变的话，系统是会知道的，这样就可以在迭代的时候删除旧的域名，添加新的域名了。
另外Domains的配置也可以使用通配符，例如：applinks:*.mywebsite.com

全都配置好了，项目也能唤起来了，web页面到底该怎么弄呀？？？通用链接指向的服务器的页面到底应该是哪个？

我们之前iOS和安卓用的是同一个网页，也就是说从app内分享出去的网页，可以被苹果用户和安卓用户同时查看，在这里我们是由web童鞋使用js判断当前所处的平台以及其系统。

如果是安卓用户，则显示安卓相关提示页面。

如果是苹果用户，那么分两种：

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

2、如果是9以下的系统，则由web童鞋在当前页面添加一个 “右上角在safari打开”，相应的 “在app内打开”的按钮就会发一个跳转到我们app schema的重定向，以实现在safari中唤醒我们的app。

当使用通用链接唤醒app之后，手机右上角有一个小按钮？

那个小按钮是可以引导用户跳转到safari中，名字叫bread crumbs button（面包屑），当然也去不掉。

备忘录和safari中都可以打开app，怎么分享到其他app里面就不行了？

    未跨域导致的，如：分享到微信的链接是 https://www.mydomain.com/share.html，然后该网页中的“在app内打开”按钮配置的通用链接为 https://www.mydomain.com/index.html。
    跨域的意思是说，通用链接和调用通用链接的网页不要使用同一域名。
    即如果通用链接域名为“www.mydomain.com”，则通用链接所处的网页域名就不能是“www.mydomain.com”。

微信屏蔽Universal Links的猜想

    微信6.6.1中测试中发现，通用链接被微信屏蔽了。微信虽然能打开通用链接指向的网页，但是无法唤醒app。
    ~~特地在本地开了一个服务器跑了一下测试网页，网页内添加了两个a标签，一个加载同域名链接，一个加载不同域名的链接。~~
    ~~测试结果发现，如果是同域名的通用链接微信可以正常打开，如果是不同域名的通用链接，虽然该链接指向的网页可以正常打开，但是无法唤醒app。~~
    ~~考虑到Universal Links要求跨域，微信应该是针对网页内加载不同域名链接时做的拦截。~~

  2.5.6 Apps that browse the web must use the appropriate WebKit framework and WebKit Javascript.

我们通过苹果审核条例2.5.6知道iOS加载网页只允许使用苹果提供的WebKit framework，而这个是Universal Link能够实现的前提条件。

配置无误的话使用WebKit加载Universal Link可以唤醒app，那么微信是怎么绕过WebKit的呢？

猜想微信的浏览器不是直接load request，而是将这个链接先转发给服务器，服务器抓取当前域名根目录或者.wellknow子目录下的 associate文件。

如果能够抓取到，则说明该域名实现了Universal Link，然后通过服务器获取该链接的页面内容，之后转发给客户端，使用其服务器做中转，绕过WebKit的load request唤醒。

太不要face了눈_눈！如果还要做兼容，只能回归到原来的方式了，在需要唤醒app的地方添加蒙版，引导用户微信右上角在safari中打开。

暂时的猜想(ง •̀_•́)ง┻━┻掀桌

欢迎大家在评论区继续互动呀，私信不好一起玩耍呀。

iOS9 Universal Links踩坑之旅，移动应用之de

简单粗暴，有一个需求:

方法1: URL Scheme

方法2: meta标签

方法3:Why Universal Links？

什么是Universal Links呢？

如何支持Universal Links呢？

详细的配置流程如下

（1）关于apple-app-site-association文件的配置

appID

如何获取`teamID`呢？

paths

验证`apple-app-site-association`文件

（2）建立web网页和app应用之间的关联 -> `app IDs` 配置和项目配置

app IDs 配置

项目配置

代码接收Universal Links唤醒

（3）验证以上配置

某些坑

小结一下

但是为什么要配置这些东西呢？配置他们的目的分别又是什么呢？我们换个角度来考虑一下

2017年9月14日更新----评论区问题汇总

按照上面写的配好了，怎么死活打不开呀？？？

为毛有的手机成功了，有的手机就不行呢？？？

服务器换域名了肿么办？？？

全都配置好了，项目也能唤起来了，web页面到底该怎么弄呀？？？通用链接指向的服务器的页面到底应该是哪个？

当使用通用链接唤醒app之后，手机右上角有一个小按钮？

备忘录和safari中都可以打开app，怎么分享到其他app里面就不行了？

微信屏蔽Universal Links的猜想

欢迎大家在评论区继续互动呀，私信不好一起玩耍呀。

猜你喜欢

热点阅读

iOS9 Universal Links踩坑之旅，移动应用之de

简单粗暴，有一个需求:

方法1: URL Scheme

方法2: meta标签

方法3:Why Universal Links？

什么是Universal Links呢？

如何支持Universal Links呢？

详细的配置流程如下

（1） 关于apple-app-site-association文件的配置

appID

如何获取teamID呢？

paths

验证apple-app-site-association文件

（2） 建立web网页和app应用之间的关联 -> app IDs 配置 和 项目配置

app IDs 配置

项目配置

代码接收Universal Links唤醒

（3）验证以上配置

某些坑

小结一下

但是为什么要配置这些东西呢？配置他们的目的分别又是什么呢？我们换个角度来考虑一下

2017年9月14日更新----评论区问题汇总

按照上面写的配好了，怎么死活打不开呀？？？

为毛有的手机成功了，有的手机就不行呢？？？

服务器换域名了肿么办？？？

全都配置好了，项目也能唤起来了，web页面到底该怎么弄呀？？？通用链接指向的服务器的页面到底应该是哪个？

当使用通用链接唤醒app之后，手机右上角有一个小按钮？

备忘录和safari中都可以打开app，怎么分享到其他app里面就不行了？

微信屏蔽Universal Links的猜想

欢迎大家在评论区继续互动呀，私信不好一起玩耍呀。

猜你喜欢

热点阅读

（1）关于apple-app-site-association文件的配置

如何获取`teamID`呢？

验证`apple-app-site-association`文件

（2）建立web网页和app应用之间的关联 -> `app IDs` 配置和项目配置