Universal Link 配置说明 - 网页配置与校验

3,617 阅读2分钟

#Universal Link 配置说明

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

官方文档

配置apple-app-site-association文件

  1. apple-app-site-association文件创建编辑其内容 需要创建一个apple-app-site-association文件,必须命名为apple-app-site-association,切记没有后缀 文件内添加json格式数据,内容如下:
{
 "applinks":{
  "apps":[],
  "details":[
 	{
 	 "appID":"9JA89QQLNQ.com.apple.wwdc",
    "paths": [ "/wxapi/*" ]
 	}
  ]
 }
}
参数说明:

1.1. 9JA89QQLNQ 账号的teamId,去官网查看即可
1.2. com.apple.wwdc 应用的bundleId
1.3. paths:设定你的app支持的路径列表,只有这些指定路径的链接,才能被app所处理。*的写法代表了可识别域名下所有链接,咱们项目一般写死`/wxapi/*`
1.4. apps:放空数组即可

2. 上传指定文件 将这个文件上传到你的服务器,可以将这个文件放到服务器的根目录下,也可以放到.well-known这个子目录下。这是为了苹果能获取到你上传的文件。 我们项目中一般放到.well-known这个子目录下。

上传完毕后,浏览器输入https://xxx/.well-known/apple-app-site-association可以直接下载apple-app-site-association即为配置成功

按上面步骤配置成功后,Universal Link即为:https://xxx/wxapi/

校验方式

官方文档校验Universal Link

测试方法:

  1. iphone备忘录输入Universal Link,点击链接可以跳转对应app
  2. 在safari浏览器中输入Universal Link,样式如下:

image.png

点击打开可跳转对应app

  1. 项目中检测Universal Link
//调用自检函数
    [WXApi checkUniversalLinkReady:^(WXULCheckStep step, WXCheckULStepResult* result) {
        NSLog(@"wxtest : %@, %u, %@, %@", @(step), result.success, result.errorInfo, result.suggestion);
    }];

使用上面代码校验,控制台输出:

wxtest : 0, 1, check passed, 
wxtest : 1, 1, check passed, 
wxtest : 2, 1, check passed, 
wxtest : 3, 1, check passed, 
wxtest : 4, 1, check passed, 
wxtest : 5, 1, Universal Link check passed. The application is launched by WeChat via Universal Link, 
wxtest : 6, 1, All Check Passed!, 

校验通过!!!