iOS 通用链接(Universal Link)唤起APP

最新推荐文章于 2025-06-10 10:19:17 发布

原创最新推荐文章于 2025-06-10 10:19:17 发布 · 1.3k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#ios #Universal Link #唤起APP

iOS 专栏收录该内容

30 篇文章

订阅专栏

本文详细介绍了如何在Xcode中配置通用链接，包括不同版本Xcode的配置方法，开发者账号的设置，以及服务端apple-app-site-association文件的生成与上传。讲解了APP如何通过AppDelegate处理通用链接，并强调了HTTPS、真机测试及iOS版本的要求。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

APP端的配置

Xcode 11.0以下的在Target ->Capabilities中，打开Associated Domains配置
在Associated Domains中配置，支持的域名，在配置时，必须是applinks: 开头,比如:支持的域名是meilikongjian.resolr.com，需要配置的写法:applinks:meilikongjian.resolr.com

Xcode 11.0以上的，工程配置中相应功能：targets->Signing&Capabilites->Capability->Associated Domains，在其中的Domains中填入你想支持的域名，也必须必须以applinks:为前缀。

在APPdelegate中的处理判断，

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
    
    if ([userActivity.activityType isEqual:NSUserActivityTypeBrowsingWeb]){
        //浏览器的网页跳转
        

    }if ([[userActivity activityType] isEqualToString:CSSearchableItemActionType]) {
         NSString *identify  = userActivity.userInfo[CSSearchableItemActivityIdentifier];
        
        //spotlight 搜索
        
    }else{

       
    }
    return YES;
}

开发者账号配置

在创建的bundleID 中，打开Associated Domains功能，

重新配置Provisioning Profiles运行文件，下载之后安装：

服务端的支持

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "9JA89QQLNQ.com.apple.wwdc",
                "paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
            },
            {
                "appID": "ABCD1234.com.apple.wwdc",
                "paths": [ "*" ]
            }
        ]
    }
}

支持的域名必须是HTTPS的
必须生成名字为 apple-app-site-association 的文件，没有后缀没有后缀没有后缀，其实就是一个JSON文件
apple-app-site-association文件的格式为图片内容中的格式，只可以修改details 数组中的内容，其他不能修改
APPID的配置:TeamId +BundleID ,而且bundleID 必须是你使用的APP的bundleID
apple-app-site-association 文件需要上传到网站根目录或者.well-known目录下
需要真机测试, 模拟器不支持通用链接
iPhone 至少 iOS 9.2 以上
设置路径：假设我们的链接为meilikongjian.resolr.com,我们在这里设置为/admin/*, 则只有以 https://meilikongjian.resolr.com/admin/才可以打开我们的app。若我们设置为 /或 *，则以 https://meilikongjian.resolr.com/为前缀的Universal Link都可以打开我们的app。若我们设置paths为*,则这个域名下的路径都可以打开这个APP。
服务端配置的apple-app-site-association 文件是否有效检验，检验地址

基本原理

在你第一个启动APP或者更新APP时，苹果会自动的根据你在Associated Domains中配置的域名下，拉取apple-app-site-association文件，根据你配置的APPID，和paths路径跳转打开对应的APP，如果不是第一次安装，只是修改apple-app-site-association文件，更新到服务器，是不奏效的，除非你重新安装了APP。