一文弄懂iOS应用间跳转的scheme和Universal Links两种方案

Xezun

已于 2024-09-10 10:47:00 修改

阅读量1.2k

点赞数 7

分类专栏： iOS 文章标签： ios

于 2024-09-09 18:26:55 首次发布

本文链接：https://blog.csdn.net/Xezun/article/details/142065426

版权

iOS 专栏收录该内容

3 篇文章 0 订阅

订阅专栏

文章目录

在 iOS 中，应用间的跳转是通过 URL 来实现的，目前有两种跳转方案。

应用协议：注册应用协议，即 scheme 方案。
统一链接：关联通用链接，即 Universal Links 方案。

不论使用哪种方案进行跳转，处理跳转事件的方式是一样的。

一、跳转事件

因为后续的操作，都需要通过接收事件来查看运行效果，因此我们先解一下如何接收应用间跳转事件。

在 iOS 9 之后，通过实现UIApplicationDelegate协议的如下方法，可以接收应用间跳转的事件。

某些应用，设计者可能也会用这个方法里接收应用内跳转。

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    NSLog(@"应用跳转：url = %@, options = %@", url, options);
    return YES;
}

在 iOS 13 之后，如果启用了“UIScene”支持的话，上述方法不会被调用，需要实现UIWindowSceneDelegate协议的如下方法，来接收应用间跳转事件。

- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
    UIOpenURLContext *context = URLContexts.anyObject;
    NSLog(@"应用跳转：url = %@, options = %@", context.URL, context.options);
}

UIScene 是用于支持多窗口（Multiple Windows）的技术，单窗口应用完全可以关闭它。

删除 Info.plist 中“Application Scene Manifest”字段，即对应键名为UIApplicationSceneManifest的字段。
删除UIApplicationDelegate是否实现了包含UISceneSession参数的方法。
删除UIWindowSceneDelegate的实现文件，默认为SceneDelegate.h和SceneDelegate.m方法。

二、应用协议 - scheme

应用协议跳转，是目前最简便、最直接的应用间跳转方式。虽然有明显的缺点，但有不少应用依然还在采用这种方式。

可能与其它应用冲突。
未安装应用时，跳转需求无法落地。
不够安全，不支持动态配置和控制。

1、注册协议

由于是 URL 方案，协议 scheme 命名应符合RFC-3986规范。

1、在Xcode > Targets > Info 选项卡 > URL Types 中配置。
iOS scheme 配置
2、或者，直接在Info.plist中设置。

除非复制粘贴，一般不建议这么做。

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>None</string>
        <key>CFBundleURLName</key>
        <string>demo</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>demo</string>
        </array>
    </dict>
</array>

2、使用协议

在构造NSURL时，需要添加:来表明它是 URL 中的 scheme 部分。

NSURL *url = [NSURL URLWithString:@"demo:"];
[UIApplication.sharedApplication openURL:url options:@{
    UIApplicationOpenURLOptionUniversalLinksOnly: @(NO)
} completionHandler:^(BOOL success) {
    NSLog(@"openURL: %@", success ? @"YES" : @"NO");
}];

参数 url 可以仅包含 scheme 也可以包含其它信息，但需要注意的是，大部分系统对于 URL 的长度都是有限制的（通常为1024字节），为了避免数据丢失，可以通过options参数传递数据（Web中不支持）。

demo:
demo://message
demo://message?id=123

options 参数目前支持提供如下两个键值。

UIApplicationOpenURLOptionUniversalLinksOnly 是否仅使用 Universal Links 且安装了应用时，才执行跳转。
UIApplicationOpenExternalURLOptionsEventAttributionKey 传递给目标应用的事件数据信息。

3、检测协议

通过 -[UIApplication canOpenURL:] 可以检测目标应用是否安装，避免跳转无法落地的问题。

需要注意的是，这个方法只能确定有应用注册了该协议，不能确定注册该协议的应用为目标应用。

NSURL *url = [NSURL URLWithString:@"demo:"];
if ([UIApplication.sharedApplication canOpenURL:url]) {
    NSLog(@"可以打开目标应用");
}

Apple 为了避免该方法被滥用，只有在预置的白名单内的 scheme，该方法才会返回正确的值。

在Info.plist中，添加Queried URL Schemes配置（键为LSApplicationQueriesSchemes的数组），并将要检测的 scheme 添加其中，虽然没有官方说明，但该数组通常被认为有 50 个的数量限制。

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>demo</string>
</array>

三、统一链接 - Universal Link

统一链接 Universal Links 是当前推荐的应用跳转实现方式。

统一链接，本质其实就是以https作为 scheme 的应用协议跳转，因为默认情况下，https就是跳转 Web 应用的应用协议，也因此，通过统一链接跳转，在应用未安装时，可以将对应的网页作为落地页面。

在 iOS 中，统一链接是由系统处理的，而不是浏览器。
系统会将应用与统一链接的域名、路径进行关联，命中了关联会直接打开应用，而不需要经过浏览器中转，与 scheme 效果完全一样。

同样的，统一链接也并不是完美的。

生效可能会延迟。
依赖服务器。
配置相对复杂。

1、准备

域名。
可以通过域名访问且支持 https 的 Web 服务器。
交了保护费的开发者账号。

2、配置服务器

服务器必须实现如下接口，以域名example.com为例，下同。

名称	值
URL	`https://example.com/.well-known/apple-app-site-association`
备用URL	`https://example.com/apple-app-site-association`
Method	GET
Content-Type	`application/json`

接口数据示例：

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "TeamID_1.com.example.app1",
                "paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"]
            },
            {
                "appID": "TeamID_2.com.example.app2",
                "paths": [ "*" ]
            }
        ]
    }
}

通过如下链接来验证服务器配置是否正确，将example.com替换为实际域名。

https://app-site-association.cdn-apple.com/a/v1/example.com

3、配置项目

1、进入 Apple 开发者中心，配置应用的identifier开启Associated Domains能力。
app identifier 开启域名关联
2、在Xcode > Targets > Signing & Capabilities 选项卡中，添加Associated Domains能力，并关联域名。