即学即用- URL Scheme、Universal Links

已于 2022-04-07 14:11:36 修改
阅读量3.9k 收藏 3
点赞数
分类专栏： Swift记录 文章标签： ios universal link swift
于 2022-04-07 14:11:10 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/aaaa99996666/article/details/124015262
版权

首发地址

前言

在实际开发过程中，我们常会遇到微信分享、QQ分享、微博分享、微信支付、支付宝支付等诸如此类的需要唤醒第三方App的需求。但是在接入这些第三方SDK时，常见的两种手段，一种是使用URL Scheme，另外一种是使用Universal Links。

本文主要达到的目的：

  1. 了解 URL Scheme和 Universal Link
  2. 正确配置配置 URL Scheme,并使用 URL Scheme 唤醒第三方App
  3. 正确配置 Universal Links,并使用 Universal Links 唤醒第三方App

正文

URL Scheme

iOS 开发者都清楚一个概念，叫做沙盒机制，所以 APP 不能直接跨越自己的区域去访问别的存储空间的内容，但是在实际开发过程中，我们又不能完全避免去与其他 APP进行通信，所以long long ago，苹果就推出了一种方式叫做 URL Scheme来完成这一通信。

相关术语

CFBundleURLType， 表示当前 App 的 scheme 记录，通过 scheme 可以在其他 App 中打开当前 App。

LSApplicationQueriesSchemes, 这个字段是在iOS 9更细系统策略的时候被引入的，即 App 的白名单，主要用于限制 schemes 协议的访问。

以上两个字段，是使用 URL Scheme 的核心。CFBundleURLType字端用于声明别人唤醒我们自己 App 的 scheme，LSApplicationQueriesSchemes字端用于声明我们想要唤醒的 App 的 scheme。

配置 URL Scheme

  1. 在 Info.plist文件中添加，设置我们自己的URL Scheme，

    image.png

    测试时，我填写的 URL Scheme 为 “iOSKateDev”。

  2. 将我们添加的 URL Scheme 输入到 Safari 中(即在浏览器地址中输入: iOSKateDev:// )，校验我们的URL Scheme是否添加成功，打开如下图，即表示设置成功了。

    image.png

    做到这一步的话，如果我们只是想让第三方 App 打开或访问我们的 App 的话，这时候就可以把我们设置好的 URL Scheme 交给第三方 App了。如果还想打开或者访问别人的 App 的话，就需要继续下一步。

  3. 将我们想要访问的或者打开第三方 App，那么我们就需要在Info.plist中继续添加LSApplicationQueriesSchemes，并设置第三方 App 的 URL Scheme。如下图：

    image.png

    上图中添加的是微信的 URL Scheme。

  4. 既然添加成功了，我们可以使用以下 API 来测试是否能正常打开。

UIApplication.shared.open(URL(string: "wechat://")!, options: [:], completionHandler: **nil**)
  1. 功成

常使用的URL Scheme

<key>LSApplicationQueriesSchemes</key>
<array>
<!--微信 URL Scheme白名单-->
<string>wechat</string>
<string>weixin</string>
<string>weixinULAPI</string>

<!-- QQ、Qzone URL Scheme白名单-->
<string>mqqopensdklaunchminiapp</string>
<string>mqqopensdkminiapp</string>
<string>mqqapi</string>
<string>mqq</string>
<string>mqqOpensdkSSoLogin</string>
<string>mqqconnect</string>
<string>mqqopensdkdataline</string>
<string>mqqopensdkgrouptribeshare</string>
<string>mqqopensdkfriend</string>
<string>mqqopensdkapi</string>
<string>mqqopensdkapiV2</string>
<string>mqqopensdkapiV3</string>
<string>mqqopensdkapiV4</string>
<string>mqzoneopensdk</string>
<string>wtloginmqq</string>
<string>wtloginmqq2</string>
<string>mqqwpa</string>
<string>mqzone</string>
<string>mqzonev2</string>
<string>mqzoneshare</string>
<string>wtloginqzone</string>
<string>mqzonewx</string>
<string>mqzoneopensdkapiV2</string>
<string>mqzoneopensdkapi19</string>
<string>mqzoneopensdkapi</string>
<string>mqqbrowser</string>
<string>mttbrowser</string>
<string>tim</string>
<string>timapi</string>
<string>timopensdkfriend</string>
<string>timwpa</string>
<string>timgamebindinggroup</string>
<string>timapiwallet</string>
<string>timOpensdkSSoLogin</string>
<string>wtlogintim</string>
<string>timopensdkgrouptribeshare</string>
<string>timopensdkapiV4</string>
<string>timgamebindinggroup</string>
<string>timopensdkdataline</string>
<string>wtlogintimV1</string>
<string>timapiV1</string>

<!--新浪微博 URL Scheme白名单-->
<string>sinaweibohd</string>
<string>sinaweibo</string>
<string>sinaweibosso</string>
<string>weibosdk</string>
<string>weibosdk2.5</string>


<!--支付宝 URL Scheme白名单-->
<string>alipay</string>
<string>alipayshare</string>

<!--钉钉 URL Scheme白名单-->
<string>dingtalk</string>
<string>dingtalk-open</string>

<!--企业微信-->
<string>wxwork</string>
<string>wxworkdebug</string>
<string>wxworkrdm</string>
<string>wxworkrelease</string>

<!--抖音-->
<string>douyinopensdk</string>
<string>douyinsharesdk</string>
<string>snssdk1128</string>

<!--Linkedin URL Scheme白名单-->
<string>linkedin</string>
<string>linkedin-sdk2</string>
<string>linkedin-sdk</string>

<!--易信 URL Scheme白名单-->
<string>yixin</string>
<string>yixinopenapi</string>

<!-- instagram URL Scheme白名单-->
<string>instagram</string>

<!-- whatsapp URL Scheme白名单-->
<string>whatsapp</string>

<!-- line URL Scheme白名单-->
<string>line</string>

<!--Facebook URL Scheme白名单-->
<string>fbapi</string>
<string>fb-messenger-api</string>
<string>fb-messenger-share-api</string>
<string>fbauth2</string>
<string>fbshareextension</string>

<!--Kakao URL Scheme白名单-->
<!--注：以下第一个参数需替换为自己的kakao appkey-->
<!--格式为 kakao +"kakao appkey"-->
<string>kakaofa63a0b2356e923f3edd6512d531f546</string>
<string>kakaokompassauth</string>
<string>storykompassauth</string>
<string>kakaolink</string>
<string>kakaotalk-4.5.0</string>
<string>kakaostory-2.9.0</string>

<!-- pinterest URL Scheme白名单-->
<string>pinterestsdk.v1</string>

<!--Tumblr URL Scheme白名单-->
<string>tumblr</string>

<!--印象笔记-->
<string>evernote</string>
<string>en</string>
<string>enx</string>
<string>evernotecid</string>
<string>evernotemsg</string>

<!--有道云笔记-->
<string>youdaonote</string>
<string>ynotedictfav</string>
<string>com.youdao.note.todayViewNote</string>
<string>ynotesharesdk</string>

<!--Google+-->
<string>gplus</string>

<!--Pocket-->
<string>pocket</string>
<string>readitlater</string>
<string>pocket-oauth-v1</string>
<string>fb131450656879143</string>
<string>en-readitlater-5776</string>
<string>com.ideashower.ReadItLaterPro3</string>
<string>com.ideashower.ReadItLaterPro</string>
<string>com.ideashower.ReadItLaterProAlpha</string>
<string>com.ideashower.ReadItLaterProEnterprise</string>

<!--VKontakte-->
<string>vk</string>
<string>vk-share</string>
<string>vkauthorize</string>

<!--Twitter-->
<string>twitter</string>
<string>twitterauth</string>

</array>

常见问题

  1. 控制台报错： error: "This app is not allowed to query for scheme xxxx"

    解决方案：检查 LSApplicationQueriesSchemes中是否正确添加要打开的 App 的 Scheme。

  2. URL Scheme和LSApplicationQueriesSchemes都正确配置了，依旧打不开想要打开的第三方 App？

    解决方案：

    1. 检查两个字端是否真的正确配置了，例如把想打开的第三方 App 的 Scheme 设置到了URL Types中；
    2. 由于URL Scheme是自定义的协议，所以可能有两个或者多个 App 的 Scheme 设置的一样，这时候根据系统的规则，它会打开最先安装的那个；

  3. 当第三方 App 想打开我们的 App，并且向我们 App，传递一些参数时，我们怎么接收这些参数？

    解决方案：常见的 URL Scheme 传值，会这么使用：“scheme://parameter=xxx”。我们在 AppDelegate 的如下方法中获取对应参数。

    optional func application( _ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool

Universal Links

Universal Link 是苹果公司在 WWDC 上提出的iOS 9 的新特性之一。Universal Link类似于深层链接，能够方便的通过打开一个HTTPS链接来直接启动您的客户端应用。

以下是苹果对它介绍：

Seamlessly link to content inside your app, or on your website in iOS 9 or later. With universal links, you can always give users the most integrated mobile experience, even when your app isn’t installed on their device.

配置 Universal Link

  1. 将域名添加SSL证书；

  2. 为需要被打开App添加Associated Domains，如下图：

图一

图二

图三

以上的截图是用 Xcode 自动管理证书的操作流程。

  1. 准备一个apple-app-site-association的文件，文件格式如下：
{
 "applinks": {
 "apps": [],
 "details": [
     {
         "appID": "9JA89QQLNQ.com.apple.wwdc",
         "paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]

     },
     {
         "appID": "ABCD1234.com.apple.wwdc",
         "paths": [ "*" ]
     }
     ]
 }
}

该文件的主要内容在于details字段中，这个字段对应的是一个列表，列表中每个对象都描述了可以使用通用链接的 App (即appID字段)，以及 App 支持的路径列表(paths字段)。

appID字段的规则为：teamID + “.” + Bundle id

path字端的规则为：* 表示 通配符，只要在该文件所在域名之下的所有地址，均可通过通用链接唤醒 App。建议不直接使用域名 + 通配符来设置 App 支持的路径。

注意: 该文件的文件名不要有后缀名。

  1. 将编辑好的apple-app-site-association文件上传到域名的根目录或者 .well-known目录下（苹果建议是 .well-known目录）。

  2. 回到 Xcode 中，使用已在apple-app-site-association文件中注册的路径来填写，操作如下：

image.png

注意： 填写的内容是: “applinks:”+域名+已注册的路径，不需要填写 https。如：

applinks:help.wechat.com/app/

  1. 检验 Universal Link 是否正常

    常见检验方案有如下几种：

    • 将 Universal Link 复制到备忘录中，查看长按的显示内容，如果出现在XX中打开，即正常。如下图，使用微信的 Universal Link，长按会显示【在"微信"中打开】。

    图6.1

    • 在 Safari 中输入 Universal Link，查看显示内容，如出现是否打开XX入口，即正常，如下图，仍是使用微信的 Universal Link举例，会显示【在"微信"应用中打开】

    图6.1

  2. 检验正常了，😄😄😄😄😄😄

常见问题

  1. 已经按照文档配置了，但是还是访问不了，我该肿么办？

    解决方案：

    1. 是否添加了APP 支持 Universal Link，详见步骤2；
    2. 查看域名是否正确配置 SSL 证书，（如果你是阿里云的用户，阿里云提供的免费证书好像就可以正确配置）；
    3. 查看上传的文件是否带有后缀名；
    4. 查看apple-app-site-association的链接是否带端口号；
    5. 检查apple-app-site-association中的数据是否为正确的 JSON 格式；
    6. 查看配置的 Univeral Link 是否与apple-app-site-association中的path具有一致性；
    7. 删除 APP，重装试一试，apple-app-site-association中的设置只在 APP 第一次安装或者更新时才会被苹果拉取；
Katy_Pei
关注
  • 0
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
iOS Universal Links(通用链接)详细教程
huanglinxiao的博客
01-13 1931
iOS9.0推出的用于应用之间跳转的一种机， 通过一个https的链接启动app。如果手机有安装需要启动的app，可实现无缝跳转。如果没有安装，会打开网页。实现场景：微信链接无缝跳转App， 网页链接无缝跳转AppBundle Identifler所在的位置 :Team ID所在的位置：打开页面，登录apple 开发者账号，划到页面下方，找到将以下json文本复制进去，并修改teamID和Bundle Identifler。details：是数组，可以有多个数据，即可支持多个app。
钉钉scheme
一个想写小说的程序员
04-07 4276
dingtalk://dingtalkclient/page/link?url=<UrlEncode后的url>&pc_slide=true
URL Scheme 和 Universal Links的优缺点
gaoya7305的博客
04-11 2963
目录 URL Schemes VS Universal Link 优缺点 URL Schemes VS Universal Link 优缺点 URL Schemes ： 优点：非常有效，能够让 app 之间彼此交流，传递数据。 缺陷： 需要提前加入到白名单，且会询问用户“是否打开‘xxx’应用”。 不会总能映射到正确的 app，两个 app 可能拥有同样的 scheme，而开发者不能明确地表示他们指的是那个 app。app 没有安装的时候不能工作。 不能有效地保护用户隐私。app 需
通用链接-Universal Link
风·之痕的博客
04-24 5942
前言 通用链接与URL Scheme的用途类似，主要是实现从外部唤醒App，并执行某些操作（如：打开指定页面）。 由于使用URL Scheme（wechat://path?quary）从当前App唤醒自己的应用时，需要添加应用的URL Scheme到当前App的白名单中，限制该方法的灵活性，使用Universal link刚好可以解决这样的问题 （https://域名/path）。 应用 链接必须是https协议，且在webView打开链接时为跨域的方式（与当前域名不同），才会被作为通用链接唤起。
LSApplicationQueriesSchemes--关于info.plist 第三方登录 添加URL Schemes白名单
热门推荐
xinxinNoGiveUp的博客
03-08 1万+
近期苹果公司iOS 9系统策略更新，限制了http协议的访问，此外应用需要在“Info.plist”中将要使用的URL Schemes列为白名单，才可正常检查其他应用是否安装。 当你的应用在iOS 9中需要使用 QQ/QQ空间/支付宝/微信SDK 的相关能力（分享、收藏、支付、登录等）时，需要在“Info.plist”里增加如下代码： key>LSApplicationQuerie
uni_links:Flutter插件，用于接受传入链接
05-13
它支持两种主要的链接技术：Universal Links（通用链接）和Custom Schemes（自定义协议），在iOS和Android平台上都能很好地工作。通过使用uni_links，开发者可以方便地集成这两种链接机制，确保用户点击外部链接时...
swift-iOS页面跳转组件-通过URL路由到相关页面可自定义路由表
08-14
在iOS中，我们可以通过URL Scheme或者Universal Links来实现这一功能。URL Scheme允许我们定义一套自定义的URL格式，当用户点击这样的URL时，应用可以捕获并处理这个请求，进而跳转到相应的页面。 接下来，我们来...
swift-网页打开或者推送根据url地址跳转到相应界面
08-14
这涉及到URL Scheme、Deep Linking以及可能的Universal Links等技术。这些技术可以帮助用户从浏览器、邮件、社交媒体等外部来源点击链接后直接进入应用内的特定页面，提升用户体验。 首先，我们来了解一下URL ...
ios-根据URL进行页面跳转导航.zip
07-11
`HZURLManager`是一个开源库，它提供了一种基于URL进行页面跳转的解决方案，使得开发者可以通过自定义URL Scheme或者Universal Links实现更加灵活、方便的页面导航。下面将详细介绍这个库的工作原理和使用方法。 `...
url scheme
01-08
url 里每个 fragment 对应的 名词解析
无效：通用链接测试变得简单
02-04
在iOS开发中，通用链接（Universal Links）是一种技术，它允许开发者将自定义的URL scheme与网站域名关联，使得用户点击这些链接时可以直接在应用程序内打开，而不是在Safari或其他浏览器中。标题“无效：通用链接...
注册URL Scheme
weixin_34019144的博客
11-22 662
2019独角兽企业重金招聘Python工程师标准>>> ...
常用app URL schemes
weixin_40016215的博客
12-16 1万+
最近开发遇到一个问题： 要在一个内嵌的h5页面上唤起“小红书”、“抖音” App 经过研究，原来只需要一个URL schemes就能解决 1、手机系统： 2、小红书：xhsdiscover:// 用户 xhsdiscover://user/id 笔记 xhsdiscover://item/5f34197f000000000101e575 话题 xhsdiscover://topic/v2/xxxxxx 主页 xhsdiscover://home xhsdiscover:/.
关于iOS“白名单”的理解
u013712343的博客
07-30 2235
之前一直误解LSApplicationQueriesSchemes“白名单”的概念：如果App1想要打开App2，必须把App2的URL scheme添加到App1的“白名单”中才能打开，这样理解是错误的。 官方文档： 说的是，在iOS9后，如果想要使用canOpenURL方法检查是否可以打这个URL或可以处理该URL的的App，需要在info.plist里添加LSApplicationQueriesSchemes字段来预设url，否则是否安装都会返回NO。 所以“白名单”的意义是要检查当前.
App分享之微信微博等各个社交平台的分享授权规则和常见问题
dfgwang1202的博客
12-08 480
一、新浪微博分享规则 新浪微博支持分享类型： 应用内分享也就是网页分享支持：文字，文字+图片，要分享链接需要链接添加在text里分享 客户端分享支持：文字，图片，文字+图片，图片+文字+链接 参数说明：text：不能超过140个汉字image：图片最大不超过5M，仅支持JPEG、GIF、PNG格式latitude：有效范围：-90.0到+90.0，+表示北纬longitude：...
FACEBOOK软件Scheme全网最全，startActivity地址更新中
最新发布
weixin_48141487的博客
11-02 484
整理海外FACEBOOK软件APP应用的一些 scheme跳转信息,我们可以在自己的应用内部直接唤起FACEBOOK的指定界面,无论是从H5还是原生界面,包括直接跳转到某用户的主页,直接与某用户发起对话等。都是一些自己在实践实际运用中整理到的Scheme协议地址，分享大家使用，如果没有可以评论@我，我在寻找可以补充协议地址。
URL Schemes 简析(一)
晓森的专栏
11-17 771
URL Schemes 之系统程序交互 URL Scheme 是苹果提供的可以用于 iOS 和 OS X 系统的一种程序交互方式.原生程序和网页程序都可以通过这些 schemes 实现与系统程序的结合,给用户提供无缝的交互体验.例如,如果你的程序显示一些电话号码,你可以通过合适的 URL 实现用户点击这些号码时打开系统电话软件,或者,在用户点击 iTunes 链接时打开 iTunes 并且播
IOS应用跳转URL scheme和Universal Links
shaobing32的博客
06-12 7609
IOS常见的跳转方式有URL scheme和Universal Links。这两个均可以实现App之间的跳转，以及通过网页实现跳转到对应的App内。通过本文章可以了解到两者的区别和具体的使用方法，以及参数的传递。应对常见的几种跳转需求。
url scheme跳转
08-23
总结起来，URL Scheme跳转是通过在浏览器中输入特定的URL Scheme来启动目标App并传递参数，而Universal Links是通过在网页上添加超链接来实现跳转到对应的App内部。两种方式都可以实现App之间的跳转，具体使用哪种...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值