iOS Universal Links配置说明

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

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

4 ·

CC 4.0 BY-SA版权

文章标签：

#xcode #macos #ide

本文详细指导如何在iOS应用中配置AssociatedDomains，包括设置apple-app-site-association文件，更新xcode证书，以及在微信平台的设置。通过实例演示验证配置是否正确，适用于多APP场景和通用路径管理。

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

一、配置步骤

1、在开发者平台开通Associated Domains

在这里插入图片描述
注意：重新设置之后，Profiles文件需要更新

2、更新xcode证书文件以及相关配置

在这里插入图片描述
在 Associated Domains 里面配置的 Universal Links 必须要以 applinks: 开头，后面写上域名，例如：applinks:www.test.com

注意：此处配置 Universal Links不需要填写路径，只需要填写域名即可，其他地方配置 Universal Links都需要带有对应APP的路径。防止APP之间冲突。

3、创建apple-app-site-association文件

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "teamid.bundleid",
                "paths": [ "*","/app/*" ]
            }
        ]
    }
}

参数说明：
apps ：是限制只能在这几个app中使用，基本是不填写，所以是空数组
appID ：为teamId.bundle identifier形式
登陆开发者中心，在Account -> Membership里面可以找到Team ID。
details：数组中可以配置多个APP的信息，如果公司内有多个APP需要支持Universal link，则可以直接添加多个
paths：设定你的app支持的路径列表，只有这些指定路径的链接，才能被app所处理。*的写法代表了可识别域名下所有链接
/app/*是自己定义的路径；

注：建议Universal links 配置path 例如/app/,避免全域名*

4、将apple-app-site-association文件上传至服务器

apple-app-site-association 文件上传至服务器的根目录或者.well-known目录下。
使用https://test.com/apple-app-site-association或者https://test.com/.well-known/apple-app-site-association能够访问到（能够下载或者返回文件内容即可）