配置Apple Universal Links

Thu, 21 May 2026 10:23:10 +0800

配置网站

创建 apple-app-site-association

在网站根目录或者 .well-known目录下创建 apple-app-site-association 文件。注意，文件没有后缀名。文件是一个json文件，内容如下：

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "团队ID.应用BundleID"
                "paths": ["/路径/*"] 
            }
        ]
    }
}

团队ID，和应用签名证书上的TeamId保存一致
路径，遵循url对应的规范，建议每一个App应用都使用独立的路径，便于管理

配置MIME

因为apple-app-site-association 的数据格式是json，所有对应MIME类型：application/json。

在对应的站点配置文件里设置，以nginx为例:

# 如果文件在根目录
location /apple-app-site-association {
    default_type application/json;
}

# 如果文件在.well-known目录
location /.well-known/apple-app-site-association {
    default_type application/json;
}

验证网站配置

打开 https://branch.io/resources/aasa-validator/ , 输入网站域名并验证配置是否正确。

关于缓存

Apple会缓存apple-app-site-association文件内容，缓存未必及时更新（一般不超过48小时），所以有时候通过Universal Links打开App会失败。

打开 https://app-site-association.cdn-apple.com/a/v1/你的网站域名可以查看缓存内容

创建 Universal Links网页

还需要在网站部署一个 Universal Links网页。网页的访问路径需要和apple-app-site-association文件中配置的路径一致。当使用 Safari 浏览器打开Universal Links网页时，可唤起App。