Univerasl Link的准备工作
- 拥有自己的域名,且此域名网站支持https
- 能够上传文件apple-app-site-association到自己的域名
- 只支持iOS 9以上
集成步骤
1. 开启Associated Domains
服务
在苹果开发者平台,identifiers->appIDs
2. 开启Associated Domains
服务
如果你是Xcode 11.4 ,需要手动添加Associated Domains
固定格式为 applinks:domain
applinks:link-baidu.baidu.com
注意:
- 你的服务器必须支持SSL
- Domains可以添加多个
- Domains必须以applinks: 开头
3.配置apple-app-site-association文件,官方文档如下:
https://developer.apple.com/library/archive/documentation/General/Conceptual/AppSearch/UniversalLinks.html#//apple_ref/doc/uid/TP40016308-CH12-SW1
配置实例文件
{
"applinks": {
"apps": [],
"details": [
{
"appID": "9JA89QQLNQ.com.apple.wwdc",
"paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
},
{
"appID": "ABCD1234.com.apple.wwdc",
"paths": [ "*" ]
}
]
}
}
- apps项必须对应一个空的数组
- details项对应一个字典的数组,
- appID对应项由前缀和ID两部分组成,可以在developer中的Identifiers→AppIDs中点击对应的App ID查看
- paths对应域名中的path,用于过滤可以跳转到App的链接,支持通配符*,?以及NOT进行匹配,匹配的优先级是
从左至右依次降低
。 - 建议配置上path,同一公司可能多款app有次需求,不同的path有益于后期的扩展。
- 最后,需要把配置好的json文件上传到服务器中该域名的根目录下,也就是说,我们可以用GET请求可以获取到这个apple-app-association文件。
当我们的App在设备上第一次运行时,如果支持Associated Domains功能,那么iOS会自动去GET定义的Domain下的apple-app-site-association文件。
需要留意iOS会先请求 https://domain.com/.well-known/apple-app-site-association
如果此文件请求不到,再去请求 https://domain.com/apple-app-site-association。 所以如果想要避免服务器接收过多GET请求,可以直接把apple-app-site-association放在./well-known/目录下。
4.Appdelegate增加如下代码
#pragma mark Universal Link
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
NSURL *url = userActivity.webpageURL;
// TODO 根据需求进行处理
}
// TODO 根据需求进行处理
return YES;
}
5. 采坑总结
- 切记,不要开代理抓包!不要开代理抓包!不要开代理抓包!
- apple-app-site-association不需要.json后缀
- 在Safari页面中,手指往下拉一下页面,会显示一个“隐藏”的banner,俗称为 smart banner,右侧有一个button,点击它,就开启App跳转功能了
- 对apple-app-site-association文件的请求仅在App第一次启动时进行,如果此时网络连接出了问题apple会缓存请求,等有网的时候再去请求,而实际测试抓包并没有请求故通用连接会失效。
- 如果没有path路劲可写,则一定要"/*"
- 如果需要通过Univerasl Link打开app后需要跳转到某个页面,请在Appdelegate的continueUserActivity方法中获取url,自己整理逻辑