Universal Links最新使用教程及体会

我一个小菜鸟又开始分享最近做的东西啦,不足之处请大家多多指教.

最近公司要求做一个功能,将 app 中分享出去的文章,在微信打开相应app的 h5链接后,点击页面顶部一按钮可跳转到自己的 app 应用.如下图所示:

Universal Links最新使用教程及体会_第1张图片

点击打开按钮之后将跳转自己的 app.

经过多方的查找资料,最终确定了使用 ios9出的Universal Links,下面我为大家讲解一下使用的方法.

1.服务器需要做的处理:

第一,网站必须要有SSL证书(也就是支持https).(大家注意一下, SSL 证书必须要是机构认证的证书,比如腾讯云,阿里云,我推荐用阿里云免费得证书,我们也是用的这个证书.开始的时候我们用的自己公司个人认证的证书,在 app 启动时不会自动下载在服务器存放的 json 文件,这点大家一定要注意)

第二,在网站根目录下放一个名为“apple-app-site-association”的json文件,去除后缀“.json”,换句话说可以通过https://www.test.com/apple-app-site-association访问到该文件。

"apple-app-site-association"文件内容如下:

{

"applinks":

{

"apps": [],

"details": [

{"appID":"teamID.bundleId”,

"paths": ["/deaplink","/wwdc/news/","*"]

},

{"appID":"ABCD1234.com.apple.wwdc","paths": ["*"]

}

]

}

}

appID 的 格式为teamID.bundleId形式。

如何获取teamID呢?

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

Universal Links最新使用教程及体会_第2张图片

teamId.png

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为你的服务器域名。

也可以使用苹果的验证网站,验证文件是否能被苹果请求到。如果是未上线的应用,使用验证网站时可能出现如下提示:

Universal Links最新使用教程及体会_第3张图片

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,如下图:

Universal Links最新使用教程及体会_第4张图片

associated domains.png

项目配置

在项目的Capablities中开启Associated domains,如下图:

Universal Links最新使用教程及体会_第5张图片

appLinks.png

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

代码接收Universal Links唤醒

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

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

returnYES;

}

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

3.验证配置

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

Universal Links最新使用教程及体会_第6张图片

有的需求需要跳转相应的界面可以通过 paths 这个字段设置其是否进行跳转,还可设置不跳转app 的路径前面要加 NOT ,例如"NOT www.test.com/*",星号代表所有,还可以使用?等.

再向大家推荐一个方法测试是否从服务器请求到了 json 文件

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

希望这篇文章对大家有所帮助,有什么不足之处请大家多多指教.有什么问题也可以留言询问我.再向大家推荐一个基于Universal Links的第三方框架,LinkedMe,大家也可以用这个第三方,也比较简单.

最后与大家分享一句话,"不积跬步,无以至千里;不积小流,无以成江海".加油!!

你可能感兴趣的:(Universal Links最新使用教程及体会)