欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

iOS开发配置Universal Links及注意事项

程序员文章站 2022-06-22 08:46:06
iOS开发配置Universal Links及注意事项官方文档配置 https://developer.apple.com/documentation/safariservices/supporting_associated_domains_in_your_app?language=objc#3001215验证 https://search.developer.apple.com/appsearch-validation-tool/集成步骤添加Associated Domains Entitl...

iOS开发配置Universal Links及注意事项

官方文档

配置 https://developer.apple.com/documentation/safariservices/supporting_associated_domains_in_your_app?language=objc#3001215
验证 https://search.developer.apple.com/appsearch-validation-tool/

集成步骤

  • 添加Associated Domains Entitlement

    • 添加Associated Domains:TARGETS -> Signing & Capabilities -> + Capability -> Associated Domains
    • 配置域名:applinks:域名
    • 注意事项:
      • 手动配置证书:需要到证书管理页面,找到对应的IDENTIFIER,并勾选Associated Domains
        iOS开发配置Universal Links及注意事项

      • 自动配置证书:无需手动操作,自动处理

      • 注意:此时,对应的Profiles会状态会变成Invalid,需要重新编辑保存;

  • 添加apple-app-site-association文件

    • 需要服务器开发人员配合,将此文件上传至域名根目录的.well-known文件夹中

    • apple-app-site-association文件内容:

      {
        "applinks": {
            "apps": [],
            "details": [
                 {
                   "appID": "ABCDE12345.com.example.app",
                   "paths": [ "/app/*"]
                 }
             ]
         }
      }
      

      其中,appID为Team ID.Bundle Identifier, paths中的/app/*为自定义路径,需要根据具体需求设置(注意: 如果配置微信平台的Universal Links,则需要在域名的后边加上此处添加的路径,否则微信分享成功后无法返回原App)

    • 服务器配置注意事项:

      • apple-app-site-association文件名固定,不能修改,不能加后缀;
      • 必须支持https且不能重定向
  • 验证

    • 浏览器输入https://<fully qualified domain>/.well-known/apple-app-site-association可以正确显示apple-app-site-association文件内容,或下载文件;

    • 使用验证工具测试:https://search.developer.apple.com/appsearch-validation-tool/

    • 手机浏览器输入域名+路径+其他地址,下拉页面可以显示打开App提示;(注意: 使用这种验证方式,修改配置文件后需要卸载重装App后,配置才会生效)

  • 参考: 上述配置步骤描述的比较简单,可以参考下面几篇文章配置

注意事项(重要!!!)

  • 修改Xcode配置中的域名或更新服务器文件apple-app-site-association内容后,需要卸载App重新安装,然后在浏览器验证才能看到验证效果,否则显示为之前缓存的结果;

  • 如果apple-app-site-association中的path设置了路径:比如/app/*,则微信后台设置的Universal Links需要加上/app/路径,否则分享成功后,无法返回;

本文地址:https://blog.csdn.net/jinrui_w/article/details/107189671