iOS 配置通用链接(Universal Link)服务端和开发者后台都配置好了,还是跳转不到App

目录

一、什么是 Universal Link?

1.背景介绍

2.特点

3.运行机制原理&流程图

二、配置教程

1.第一步:开启 Associated Domains 服务

1.1 开通 Associated Domains

2.第二步:服务器配置 apple-app-site-association(AASA) 文件

2.1 创建 apple-app-site-association 文件

2.2 将 apple-app-site-association 文件上传到服务器

2.3 校验 AASA 文件的有效性

2.3.1 三方工具(推荐使用)

2.3.2 官网(不好用)

3.第三步:配置 Associated Domains(域名)

3.1 在 Xcode 中配置

3.2 在 HBuilderX 中配置

4.第四步:验证通用连接(Universal Link)是否配置正确


我按照大佬的操作都完成了,服务端给的地址也都验证通过,我前端配置也都ok,就是不跳转,最后发现是手机缓存问题,重启手机后,再重试就好了。

底部文章是来自一个大佬的博客总结的内容:

瑾瑾的技术分享博客

一、什么是 Universal Link?

1.背景介绍

  • Universal Link 是苹果在 WWDC 2015 上提出的 iOS 9 的新特性之一。此特性类似于深层链接,并能够方便地通过打开一个 Https 链接来直接启动您的客户端应用(手机有安装 App)。对比以往所使用的 URLSheme,这种新特性在实现 web-app 的无缝链接时,能够提供极佳的用户体验。使用前请阅读苹果官方文档 - Support Universal Links

  • 由于苹果 iOS 13 系统版本安全升级,微信 SDK1.8.6 版本要求支持 Universal Links 方式跳转,以便进行合法性校验,提升安全性。详情请参考微信官方文档 - iOS 接入指南

2.特点

  • Universal Link 可以无缝链接到 app 或网页,主要应用场景有内容分享广告投放。它有如下特点:

    • 如果安装了 app,会直接打开 app,并定位到内容页;
    • 如果没有安装 app,使用浏览器打开该链接;

3.运行机制原理&流程图

  • 当 App 初次安装后或者更新版本后的第一次启动(第二次启动就不会),向工程配置的 applinks: 的域名请求 apple-app-site-association 配置文件;
  • App 自动的将 apple-app-site-association 配置文件向 iOS 系统配置;
  • 当任何 WebView 发起 UniversalLink 的 url 的时候,系统遍历注册过的通用链接,如果命中则直接打开 App 触发 Delegate 方法;如果没命中,WebView 继续跳转加载 url。
  • 以上都是系统默默替你做的,我们要做的就是确保配置的正确性。

Universal Links流程

二、配置教程

1.第一步:开启 Associated Domains 服务

1.1 开通 Associated Domains
  • 登录苹果开发者中心,在“Certificates, Identifiers & Profiles(证书、标识符和描述文件)”页面选择“Identifiers(标识符)”

    证书、标识符和描述文件

  • 在“Identifiers(标识符)”选项下,添加或选择对应的 App ID

    添加或选择对应的 App ID

  • 勾选 Associated Domains 并保存,一定要确保开启 Associated Domains 服务

    重要提示:开启 Associated Domains 服务后,需要重新生成 profile 文件

    开启 Associated Domains 服务

2.第二步:服务器配置 apple-app-site-association(AASA) 文件

AASA(apple-app-site-association)文件是一个位于 根目录 或 /.well-known 文件夹下面的 json 文件 (例如: https://your_domain/apple-app-site-association 或 https://your_domain/.well-known/apple-app-site-association),里面描述了目标 app 的信息。AASA 文件和 entitlements 为网站和 app 提供了互相认证的机制。

2.1 创建 apple-app-site-association 文件
  • 需要创建一个 apple-app-site-association 文件,必须命名为 apple-app-site-association,切记没有后缀,有些人的电脑是隐藏文件后缀的,务必把 .json 后缀去掉!

    1
    
    touch apple-app-site-association
    
  • 文件内添加 json 格式数据,内容如下:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    
    {
      "applinks": {
        "apps": [], // apps:是限制只能在这几个app中使用,基本上不填写,所以是空数组
        "details": [
          // 可以配置一个,也可配置多个
          {
            "appID": "9JA89QQLNQ.com.apple.wwdc", // appID:是由TeamId + . + BundleId组成
            "paths": ["*"] // paths:设定你的app支持的路径列表,只有这些指定路径的链接,才能被app所处理。"*"的写法代表了可识别域名下所有链接
          },
          {
            "appID": "ABCD1234.com.apple.wwdc",
            "paths": ["/app/*", "/qq_conn/appid/*"] // "/app/*"是自己定义的路径;"/qq_conn/appid/*"需要根据QQ互联平台设置,appid是QQ互联后台对应应用的APPID
          }
        ]
      }
    }
    
2.2 将 apple-app-site-association 文件上传到服务器
  • 你的服务器必须支持 HTTPS 协议,并且拥有该域名下上传到根目录的权限;

  • 将这个文件上传到你的服务器,可以将这个文件放到服务器的 根目录 下,也可以放到 .well-known 这个子目录下,这是为了苹果能获取到你上传的文件;

  • 该文件的 content-type 需要设置成 application/json,可以直接在 oss 上进行修改;

    修改 Http 头

  • 上传完成后,对应的链接分别为https://xxx/apple-app-site-associationhttps://xxx/.well-known/apple-app-site-association(xxx 为服务端的域名),然后试着访问一下,看看是否能够获取到,当你在浏览器中输入这个文件链接后,出现下图就可以了:

    预览 AASA

2.3 校验 AASA 文件的有效性
  • AASA 文件的格式和命名会直接影响到 iOS 系统能否正常拉取、识别里面的内容,现在有一些工具可以校验 AASA 文件有效性:
2.3.1 三方工具(推荐使用)

aasa-validator 校验

2.3.2 官网(不好用)

3.第三步:配置 Associated Domains(域名)

3.1 在 Xcode 中配置

Xcode 版本:Version 14.2 (14C18)

  • 在 Xcode 中打开项目,选择目录中的 xxx.xcodeproj(xxx 通常为项目名称),在 xxx.xcodeproj -> Signing&Capabilites -> Capability -> Associated Domains 这个路径下进行配置;

    Xcode 配置 Associated Domains 图1

  • 然后双击 Associated Domains,即可在 Xcode 中对 Associated Domains 进行配置,如果 Capability 中已经存在 Associated Domains,那么直接配置即可;

    Xcode 配置 Associated Domains 图2

  • 在 Associated Domains 里面配置的 Universal Links,必须以 applinks: 为前缀,格式为:applinks:+配置的域名,例如:applinks:test.com

    Xcode 配置 Associated Domains 图3

3.2 在 HBuilderX 中配置

HBuilderX 版本:3.8.4

  • 打开 HBuilderX 并选择对应的项目,找到 manifest.json,在 App常用其它设置 中找到“iOS 设置”下的 关联域(Associated Domains)进行配置;

    HBuilderX 配置 Associated Domains

  • 或者打开项目的 manifest.json 文件,切换到“源码视图”项,在 uni-app 项目在 app-plus -> distribute -> ios -> capabilities -> entitlements 节点下添加 com.apple.developer.associated-domains 字段,字段值为字符串数组,每个字符串为要关联的域名;

    1
    2
    3
    4
    5
    6
    7
    
    "capabilities": {
      "entitlements": {
        "com.apple.developer.associated-domains": [
          "applinks:xxx.xxx.com"
        ] // xxx.xxx.com 是应用通用链接的域名(这里不要包含path),请修改为自己应用要使用的域名
      }
    }
    
  • 保存后提交云端打包生效;

注意:在 Associated Domains 里面配置的 Universal Links 必须要以 applinks: 开头,后面写上域名,例如:applinks:test.com

4.第四步:验证通用连接(Universal Link)是否配置正确

注意:测试时,手机上必须安装你需要跳转的应用并配置 Associated Domains

  • 在这个链接的页面顶部能看到“在 xxx APP 中打开”字样,点击“打开”按钮可以打开 app;

Safari 校验

  • 如果输入的 Universal Links 是能识别的链接,那么点击链接看看是否可以直接跳转到 app;
  • 或者长按该链接,看看弹出的菜单中是否有“在 xxx 中打开”,这都代表着成功了;

备忘录校验

注意:服务器上 apple-app-site-association 的更新不会让 iOS 本地的 apple-app-site-association 同步更新,即 iOS 一般只会在 APP 下载完后初次启动才会下载这个文件,所以如果修改了 apple-app-site-association 文件,请删除 APP 后重新下载。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mfbz.cn/a/103711.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

RISC-V架构——中断处理和中断控制器介绍

1、ARM架构中断机制介绍 本文不是从零开始讲解中断,对于中断的基本知识不再赘述,对中断不是很了解可以先学习ARM中断的文章。参考博客:《ARM架构的外部中断介绍(S5PV210芯片)》; 2、RIAC_V架构的中断控制器架构 (1&…

Qt之自定义事件QEvent

在Qt中,自定义事件的步骤大概如下: 1.创建自定义事件,自定义事件需要继承QEvent 2.使用QEvent::registerEventType()注册自定义事件类型,事件的类型需要在 QEvent::User 和 QEvent::MaxUser 范围之间,在QEvent::User之前是预留给系统的事件 3.使用sendEvent() 和 postEv…

【软件安装】Linux系统中安装MySQL数据库服务

这篇文章,主要介绍如何在Linux系统中安装MySQL数据库服务。 目录 一、Linux安装MySQL 1.1、下载MySQL安装包 1.2、解压MySQL安装包 1.3、更改存放目录 1.4、创建用户组和用户 1.5、创建数据目录data 1.6、创建my.cnf配置文件 1.7、初始化数据库 1.8、添加m…

C# 基于腾讯云人脸核身和百度云证件识别技术相结合的 API 实现

目录 腾讯云人脸核身技术 Craneoffice.net 采用的识别方式 1、活体人脸核身(权威库): 2、活体人脸比对: 3、照片人脸核身(权威库): 调用成本 百度云身份证识别 调用成本 相关结合点 核心代码 实现调用人脸核身API的示例 实现调用身…

微信小程序设置 wx.showModal 提示框中 确定和取消按钮的颜色

wx官方提供的 showModal 无疑是个非常优秀的选择提示工具 但是 我们还可以让他的颜色更贴近整体的小程序风格 cancelColor 可以改变取消按钮的颜色 confirmColor 则可以控制确定按钮的颜色 参考代码如下 wx.showModal({cancelColor: #0000FF,confirmColor: #45B250,content:…

行业追踪,2023-10-25

自动复盘 2023-10-25 凡所有相,皆是虚妄。若见诸相非相,即见如来。 k 线图是最好的老师,每天持续发布板块的rps排名,追踪板块,板块来开仓,板块去清仓,丢弃自以为是的想法,板块去留让…

如何构建一个外卖微信小程序

随着外卖行业的不断发展,越来越多的商家开始关注外卖微信小程序的开发。微信小程序具有使用方便、快速上线、用户覆盖广等优势,成为了商家们的首选。 那么,如何快速开发一个外卖微信小程序呢?下面就让我们来看看吧! 首…

Python Opencv实践 - 入门使用Tesseract识别图片中的文字

做车牌识别项目前试一试tesseract识别中文。tesseract的安装使用请参考: Python OCR工具pytesseract详解 - 知乎pytesseract是基于Python的OCR工具, 底层使用的是Google的Tesseract-OCR 引擎,支持识别图片中的文字,支持jpeg, png…

面试题之Vue和React的区别是什么?

一提到前端框架,相信大家都对Vue和React不陌生,这两个前端框架都是比较主流的,用户也都比较多,但是我们在使用这些框架的时候,是否对这两个框架之间的区别有所了解呢?接下来,让我们来一起的系统…

RK3399平台开发中安卓系统去除USB权限弹窗

RK3399平台开发中安卓系统去除USB权限弹窗 问题方法 问题 当我们在访问一个插入到Android系统的USB设备的时候往往是需要权限的,此时系统会弹出询问权限的对话框,而我们此时希望让它默认允许访问USB设备并且不希望用户看到这个对话框。 方法 文件目录&…

Git不常用命令(持续更新)

今日鸡汤:当你最满足的时候,通常也最孤独;当你最愤慨的时候,通常也最可怜。 此博文会列出一些平时不常用,但是能提高效率的git命令,后续会出IDEA对应的操作步骤 快看看你是不是都用过... 分支(…

蓝桥算法赛(铺地板)

问题描述 小蓝家要装修了,小蓝爸爸买来了很多块(你可以理解为数量无限) 23 规格的地砖,小蓝家的地板是 nm 规格的,小蓝想问你,能否用这些 23 的地砖铺满地板。 铺满地板:对于地板的每个区域&…

C语言-面试题实现有序序列合并

要求: a.输入两个升序排列的序列,将两个序列合并为一个有序序列并输出。 数据范围: 1≤n,m≤1000 1≤n,m≤1000 , 序列中的值满足 0≤val≤30000 输入描述: 1.输入包含三行, 2.第一行包含两个正整数n, m&am…

Kubernetes 的有状态和无状态服务

Author:rab 目录 前言一、无状态服务案例1.1 yml 案例1.2 扩容与缩容1.2.1 扩容1.2.2 缩容 1.3 暂停与恢复1.3.1 暂停1.3.2 恢复 1.4 回滚 二、有状态服务案例2.1 yml 案例2.2 扩容与缩容2.2.1 扩容2.2.2 缩容 总结 前言 在 Kubernetes(k8s)…

(Java)中的数据类型和变量

文章目录 一、字面常量二、数据类型三、变量1.变量的概念2.语法的格式3.整型变量4.长整型变量5.短整型变量6.字节型变量 四、浮点型变量1.双精度浮点数2.单精度浮点数 五、字符型常量六、布尔型变量七、类型转换1.自动类型转换(隐式)2.强制类型转换(显式…

SCT52240STDR双路 4A/4A 高速MOSFET/IGBT栅极驱动器, 可并联输出

SCT52240是是一款宽供电电压、双通道、高速、低测栅极驱动器,包括功率MOSFET,IGBT。单个通道能够提供高达4A拉电流和4A灌电流的轨到轨驱动能力,并实现轨到轨输出。高达24V宽电压范围提高功率器件开关瞬间栅极驱动的振铃幅值裕度。13ns输入输出…

Pytorch公共数据集、tensorboard、DataLoader使用

本文将主要介绍torchvision.datasets的使用,并以CIFAR-10为例进行介绍,对可视化工具tensorboard进行介绍,包括安装,使用,可视化过程等,最后介绍DataLoader的使用。希望对你有帮助 Pytorch公共数据集 torc…

如何理解某一个开发框架的意图,从而去写和落代码文件位置不会出错

理解一个开发框架的意图并正确地组织代码和文件位置是一个重要的技能。这不仅需要对框架本身有深入的理解,还需要对框架背后的设计哲学和最佳实践有所了解。以下是一些帮助你达到这一目标的步骤和建议: 1. 学习框架的文档 详细阅读: 开始使用任何框架前…

【数据结构】数组和字符串(四):特殊矩阵的压缩存储:稀疏矩阵——三元组表

文章目录 4.2.1 矩阵的数组表示4.2.2 特殊矩阵的压缩存储a. 对角矩阵的压缩存储b~c. 三角、对称矩阵的压缩存储d. 稀疏矩阵的压缩存储——三元组表结构体初始化元素设置打印矩阵主函数输出结果代码整合 4.2.1 矩阵的数组表示 【数据结构】数组和字符串(一&#xff…

前端请求后台接口失败处理逻辑

前后分离项目,前端为uni-app(vue2),后台为java 后台api设置存在问题,部分公共接口为开放非登录用户访问权限 导致前台打开首页后立即跳转到登录提示页 怀疑是开了uni-app开发代理服务器,导致访问的代理服务…