iOS配置UniversalLink开发

Univerasl Link的准备工作

  1. 拥有自己的域名,且此域名网站支持https
  2. 能够上传文件apple-app-site-association到自己的域名
  3. 只支持iOS 9以上

集成步骤

1. 开启Associated Domains服务

在苹果开发者平台,identifiers->appIDs

2. 开启Associated Domains服务

如果你是Xcode 11.4 ,需要手动添加Associated Domains

固定格式为 applinks:domain

applinks:link-baidu.baidu.com

注意:

  1. 你的服务器必须支持SSL
  2. Domains可以添加多个
  3. 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": [ "*" ]
            }
        ]
    }
}
  1. apps项必须对应一个空的数组
  2. details项对应一个字典的数组,
  3. appID对应项由前缀和ID两部分组成,可以在developer中的Identifiers→AppIDs中点击对应的App ID查看
  4. paths对应域名中的path,用于过滤可以跳转到App的链接,支持通配符*,?以及NOT进行匹配,匹配的优先级是从左至右依次降低
  5. 建议配置上path,同一公司可能多款app有次需求,不同的path有益于后期的扩展。
  6. 最后,需要把配置好的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> * _Nullable))restorationHandler {
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *url = userActivity.webpageURL;
       // TODO 根据需求进行处理
    }
      // TODO 根据需求进行处理
    return YES;
}
5. 采坑总结
  1. 切记,不要开代理抓包!不要开代理抓包!不要开代理抓包!
  2. apple-app-site-association不需要.json后缀
  3. 在Safari页面中,手指往下拉一下页面,会显示一个“隐藏”的banner,俗称为 smart banner,右侧有一个button,点击它,就开启App跳转功能了
  4. 对apple-app-site-association文件的请求仅在App第一次启动时进行,如果此时网络连接出了问题apple会缓存请求,等有网的时候再去请求,而实际测试抓包并没有请求故通用连接会失效。
  5. 如果没有path路劲可写,则一定要"/*"
  6. 如果需要通过Univerasl Link打开app后需要跳转到某个页面,请在Appdelegate的continueUserActivity方法中获取url,自己整理逻辑
如果你觉得可以添加“洲洲哥”

你可能感兴趣的:(iOS配置UniversalLink开发)