AppCan iOS 通用连接(Universal Link)配置说明

什么是通用链接?

为什么要突然改用通用链接的配置方式?

如何配置通用链接?

  1. 创建json格式的一个空文件(取名必须为apple-app-site-association,并且没有后缀) 图片1
注:这里的appID是指:TeamID+BundleId的组成(例:9JA89QQLNQ.com.apple.test)(TeamID可以在开发者账号里面查看,BundleId是项目的Bundle Identifier)。
这里的paths是指:是设置允许的路径列表,可以是一个也可以是多个,最简单的方式是使用“*”,通配符,表示允许该域名下的任意路径。(注意:paths中的大小写是敏感的,一定要一一对应)
  1. 上传apple-app-site-association文件(这里就能拿到app中配置需要的域名)
  2. (1)将apple-app-site-association文件发给服务器端的同事,让他上传到域名.well-known的子目录下(这里的域名必须要是可访问的域名,由服务器端的同事给到,ios14最新要求不再支持根目录下,只能在.well-konwn下)。
  3. (2)Web server需要支持https,客户端通过https来访问,并且不支持重定向。 下面是描述文件的配置: 登录苹果开发者账号,选择对应的appid,编辑,勾选Associated Domains 选项,如下图 图片2

  4. 然后正常步骤生成描述文件即可。 以上是原生开发通用部分的配置,文件在附件中已包含,可以自己创建,也可以直接直接修改使用,需要注意以下几点: apple-app-site-association 文件不要带json的后缀,可以让服务端把文件路径发出来,浏览器打开,看是否是下载文件即可验证; 微信开放平台及注册方法传入的Universal Link 要一致,为域名 + path(“/”结束,不带”*”)(如果设置一致但是没有加path,一些老方法(分享等等)调用失败会降级使用schemes 方法返回app,个别新方法会无法返回app(选择发票))

  5. 接下来是AppCan 打包服务器需要进行的配置 需要在config文件中添加配置entitlements配置
<config desc="" platform="iOS" type="ENTITLEMENTS-CUSTOM"> <ENTITLEMENTS platform="iOS" info="" type="ENTITLEMENTS-CUSTOM">  <key>com.apple.developer.associated-domains</key>
    <array>
        <string>applinks:AppCan.cn/</string>
        <string>applinks:域名/</string>
    </array>
</ENTITLEMENTS> </config>

entitlements配置具体格式文档见:http://newdocx.AppCan.cn/dev-guide/config·xml ,config新增配置说明部分。

还需要帮助吗? 联系我们
最新更新 28th Dec 2020