ios url scheme 冷启动获取参数

原创

mob64ca12f8da8d 2024-11-04 06:50:22 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12f8da8d的原创作品，请联系作者获取转载授权，否则将追究法律责任

iOS URL Scheme 冷启动获取参数

在现代移动应用中，深度链接（Deep Link）技术得到了广泛的应用。iOS 的 URL Scheme 是实现深度链接的一种常见方式。通过 URL Scheme，我们可以在冷启动情况下将参数传递给应用。在这篇文章中，我们将探讨如何在 iOS 应用中实现这一功能，并提供相应的代码示例。

什么是 URL Scheme？

URL Scheme 是一种允许外部应用（如 Safari、邮件等）与特定应用之间进行交互的机制。当用户点击特定的链接时，操作系统会检测该链接的 URL Scheme，并如果该 Scheme 已注册，则调用相应的应用。

例如，一个 URL Scheme 可能是 myapp://，当用户点击一个链接 myapp://user?id=123，应用将启动，并可以接收请求中的参数。

如何实现

要在 iOS 应用中实现 URL Scheme 并且获取参数，我们需要经过以下几个步骤：

在 Info.plist 中注册 URL Scheme。
实现相应的处理函数，解析传入的参数。
测试 URL Scheme 是否按预期工作。

第一步：注册 URL Scheme

首先，我们需要在项目的 Info.plist 文件中注册我们的 URL Scheme。可以通过添加一个新的字典项 "URL types" 来实现。具体步骤如下：

打开 Info.plist 文件。
增加一个新的键 "URL types"，键值类型为数组。
在数组中添加一个字典，包含以下键值对：
- URL Schemes：你自定义的 URL Scheme，示例为 myapp。

最终，修改后的 Info.plist 应该看起来像这样：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
    </dict>
</array>

第二步：实现 URL 处理

在应用的 AppDelegate 中实现一个方法来处理传入的 URL。当应用从冷启动状态通过 URL 启动时，这个方法会被调用。

下面是示例代码：

import UIKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?

    func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
        let urlComponents = URLComponents(url: url, resolvingAgainstBaseURL: false)
        let queryItems = urlComponents?.queryItems
        if let userId = queryItems?.first(where: { $0.name == "id" })?.value {
            print("User ID: \(userId)")
            // 此处可以执行导航到具体视图控制器的逻辑
        }
        return true
    }
}

在这段代码中，我们通过 UIApplicationDelegate 的 application(_:open:options:) 方法获取 URL。然后利用 URLComponents 和 queryItems 来解析出用户 ID。

第三步：测试 URL Scheme

可以在 Safari 中输入 myapp://user?id=123 来测试 URL Scheme。点击链接后，您的应用应启动并在控制台输出 User ID: 123。

流程图

下面是一个简单的序列图，描述了用户如何通过 URL 启动应用并传递参数的流程：

sequenceDiagram
    participant User
    participant Safari
    participant AppDelegate

    User->>Safari: 点击链接 myapp://user?id=123
    Safari->>App: 启动应用
    App->>AppDelegate: 调用 application(_:open:options:)
    AppDelegate->>App: 解析 URL 参数
    AppDelegate->>User: 输出 User ID: 123