Uniapp IOS universallinks以及配置文件apple-app-site-association

最新推荐文章于 2025-08-20 10:13:04 发布

原创最新推荐文章于 2025-08-20 10:13:04 发布 · 6.7k 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#ios #macos

本文详细介绍了如何在iOS应用中启用Universal Links功能，包括配置apple-app-site-association文件、微信支付回调、APP权限设置和HBuilder项目配置，以及注意事项。

1：Universal Link(通用链接)是Apple在iOS9推出的一种能够方便的通过传统HTTPS链接来启动APP的功能，可以使用相同的网址打开网址和APP。当你的应用支持Universal Link(通用链接)，当用户点击一个链接是可以跳转到你的网站并获得无缝重定向到对应的APP，且不需要通过Safari浏览器。如果你的应用不支持的话，则会在Safari中打开该链接。

2：IOS使用微信支付时则需要配置Universal link,进行回调

3：配置指定文件：创建一个内容为json格式的文件，苹果将会在合适的时候，从我们在项目中填入的域名请求这个文件。这个文件名必须为apple-app-site-association，切记没有后缀名，文件内容大概是这样子：

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "团队id.com.yixin.app1",
                "paths": [
                    "/app1/*"
                ]
            },
            {
                "appID": "团队id.com.yixin.app2",
                "paths": [
                    "/app2/*"
                ]
            },
            {
                "appID": "团队id.com.yixin.app3",
                "paths": [
                    "/app3/*"
                ]
            }
        ]
    }
}

团队Id查看

通过paths配置不同的应用links

4：将改配置文件配到域名访问根目录下（具体配置我也部署很清楚，附上后端Nginx配置参数）

5：APP配置

1：配置权限

2：Hbuilder项目配置

 "capabilities" : {
                    "entitlements" : {
                        "com.apple.developer.associated-domains" : [
                            "applinks:www.baidu.com"
                        ]
                    }
                }

         "weixin" : {
                        "__platform__" : [ "ios", "android" ],
                        "appid" : "22333232",
                        "UniversalLinks" : "https://www.baidu.com/app1/"
                    }

6：打包运行测试

如果配置成功在safari里打开路径：https://www.baidu.com/app1/会出现对应的APP（其他浏览器是无效的）