关于 app打包 ios通用链接（Universal Links）配置

由于苹果iOS 13系统版本安全升级，微信SDK1.8.6版本要求支持Universal Links方式跳转，以便进行合法性校验，提升安全性。更多详情请参考微信官方说明

在用hbuild打包app的时候（如果涉及到微信支付和分享）就需要输入 Universal Links，不然在打包的时候就会出现以下错误

 [HBuilder] 16:33:43.907   Manifest.json文件以下节点配置错误，请检查修复

[HBuilder] 16:33:43.907    app-plus.distribute.sdkConfigs.payment.weixin.UniversalLinks 不能为空

在填写错误的Universal Links的时候，微信分享的时候会提示Universal Links不符合要求。

开启Universal Links 配置步骤

1. 在申请苹果证书的时候account-> Certificates, Identifiers & Profiles -> Identifiers 选择对应的App ID，确保开启Associated Domains服务，勾选上以下选项；然后生成profile文件，方便提交云端打包时使用。
   
   

   ios证书申请.png
2. 让后台准备一个 https 的链接
   这个链接最好是指向产品首页，与产品访问地址一致
3. 在使用HBuilderX云端打包时在manifest.json中配置域
   在"plus" -> "distribute" -> "apple" -> "capabilities" -> "entitlements"节点（uni-app项目在"app-plus" -> "distribute" -> "ios" -> "capabilities" -> "entitlements"）下添加"com.apple.developer.associated-domains"字段，字段值为字符串数组，每个字符串为要关联的域名

 "capabilities" : {
                "entitlements" : {
                    "com.apple.developer.associated-domains" : [ 
                        "applinks:demo.example.cn"
                     ]
                }
            },

demo.example.cn 是应用通用链接的域名，保存后提交云端打包生效

4. 服务器配置一个apple-app-site-association json文件
   内容可以像我这样写(文件名不能带后缀)

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID":"7SDE13OCWH.com.demo.ios",
                "paths": [ "*"]
            }
        ]
    }
}

"appID": "证书的App ID Prefix.Bundle ID",
参数可参照 官方文档 修改

appID的值.jpg

把配置好的apple-app-site-association文件上传到服务器根目录或.well-known下面（我是两个地方都放了），确保通过
如果 https://demo.example.cn/.well-known/apple-app-site-association可访问，就表示成功了。
其中demo.example.cn为上面配置的域名(后台配置好的域名）
应用安装后会通过访问上面的url向系统注册应用的通用链接。

5. 打开微信开发平台，在“管理中心”页面的“移动应用”下找到已经申请的应用（没有申请应用请点击“创建移动应用”新建应用），点击“查看”打开应用详情页面。
   在“开发信息”栏后点击修改，在“iOS应用”下的“Universal Links”项中配置应用的通用链接，如下图所示：
   
   

   微信开发平台配置通用链接.png
6. 然后就可以在hbuildx中配置通用链接提交云端打包,
   将上一步在微信开放平台配置的通用链接地址配置到应用manifest.json中，注意通用链接地址必须完全一致，配置SDK,保存后提交云端打包。
   注意事项：

• apple-app-site-association文件不能带后缀
• apple-app-site-association文件最好在域名根目录和.well-known都放一个
• app的访问地址最好适合通用链接地址一样（在此我卡了很久）
  ，因为ios在启动项目的时候是默认访问通用链接下的内容

推荐 iOS平台配置通用链接（Universal Link）
和iOS平台微信SDK更新需要配置通用链接（Universal Links）