美文网首页IOS开发
iOS配置UniversalLink开发

iOS配置UniversalLink开发

作者: 洲洲哥 | 来源:发表于2020-05-25 16:08 被阅读0次

    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<id<UIUserActivityRestoring>> * _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开发

        本文链接:https://www.haomeiwen.com/subject/vqwyahtx.html