Flutter DeepLink 在 iOS 上失效？排查思路及解决方案

2024-10-17 02:20:20

Flutter DeepLink 在 Android 上运行正常，但在 iOS 上却失效了？

不少开发者在 Flutter 开发中都遇到过 DeepLink 在 iOS 上无法正常工作的情况。明明 Android 端运行良好，iOS 端却毫无反应，这确实让人摸不着头脑。本文将深入探讨这个问题，并提供一些排查思路和解决方案，希望能帮你解决这个令人头疼的 bug。

问题分析

我们先来了解一下 DeepLink 在 Flutter 中的工作原理。简单来说，DeepLink 是通过 URL scheme 或 Universal Links 将用户引导到应用程序特定页面的技术。在 Android 上，我们主要依靠 Intent-Filter 来处理 DeepLink；而在 iOS 上，则需要配置 Associated Domains 和 Universal Links。

根据你的，你应该已经完成了 iOS 端的相关配置，包括 apple-app-site-association 文件、Associated Domains 和 EnableFlutterLink 设置。既然配置完成了，那问题可能出在代码逻辑或者 Flutter 与原生代码的交互上。

排查思路

我们可以按照以下步骤进行排查：

检查 apple-app-site-association 文件 :
- 首先要确保文件内容格式正确，尤其是 paths 字段的配置是否与你的 DeepLink 路径匹配。
- 文件必须放在你的域名根目录下，并且可以通过 HTTPS 访问，且不能有任何重定向。
- 你可以使用 curl 命令或者浏览器开发者工具验证文件是否可以正常访问。
确认 Associated Domains 配置 :
- 在 Xcode 中，检查你的 App Target -> Signing & Capabilities -> Associated Domains 是否已正确添加你的域名，格式为 applinks:yourdomain.com。
检查 AppDelegate 代码 :
- 确保 application(_:open:options:) 方法能够正确接收 DeepLink URL，并将其传递给 Flutter 端。
- 检查你在 application(_:open:options:) 方法中使用的方法调用是否能够成功触发 Flutter 端的 DeepLink 处理逻辑。
- 你可以通过添加日志输出或者断点调试来验证代码执行流程。
检查 Flutter 端代码 :
- 确保 Flutter 端能够正确接收来自原生端的 DeepLink URL。
- 检查 Flutter 端的 URL 解析逻辑是否正确，是否能够正确识别 DeepLink 路径并触发相应的页面跳转。
- 你也可以通过添加日志输出或者断点调试来验证代码执行流程。
模拟器和真机测试 :
- 有时模拟器和真机的行为可能会有差异。建议在模拟器和真机上都进行测试，看看是否都能正常工作。

解决方案

根据上述排查思路，我们可以尝试以下解决方案：

修正 apple-app-site-association 文件 : 如果文件内容格式错误或者无法访问，需要进行修正。
重新配置 Associated Domains : 如果 Associated Domains 配置错误，需要重新配置。
修改 AppDelegate 代码 :
- 确保 application(_:open:options:) 方法能够正确处理 DeepLink URL。
- 你可以尝试使用 FlutterMethodChannel 将 DeepLink URL 传递给 Flutter 端。
修改 Flutter 端代码 :
- 确保 Flutter 端能够正确接收并处理来自原生端的 DeepLink URL。
- 你可以尝试使用 uni_links 插件来简化 DeepLink 的处理流程。
重启设备 : 有时候，重启设备可以解决一些奇怪的问题，不妨一试。

示例代码

以下是一个简单的示例，演示了如何在 iOS 上处理 DeepLink：

AppDelegate.swift

override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    let flutterViewController = window?.rootViewController as? FlutterViewController
    let methodChannel = FlutterMethodChannel(name: "your_channel_name", binaryMessenger: flutterViewController!.binaryMessenger)
    methodChannel.invokeMethod("handleDeepLink", arguments: url.absoluteString)
    return true
}

Flutter 端代码

MethodChannel('your_channel_name').setMethodCallHandler((call) async {
  if (call.method == 'handleDeepLink') {
    String deepLink = call.arguments;
    // 处理 DeepLink
  }
});

常见问题及解答

问题：apple-app-site-association 文件必须放在 HTTPS 服务器上吗？

解答： 是的，apple-app-site-association 文件必须可以通过 HTTPS 访问，这是为了保证文件的安全性。
问题：Associated Domains 配置中的域名必须和我的网站域名一致吗？

解答： 是的，Associated Domains 配置中的域名必须和你的网站域名一致，因为 Universal Links 需要验证域名 ownership。
问题：如何在 Flutter 端接收 DeepLink URL？

解答： 你可以使用 uni_links 插件或者 MethodChannel 来接收 DeepLink URL。
问题：如何在 Flutter 端处理 DeepLink URL？

解答： 你可以在 Flutter 端解析 DeepLink URL，并根据 URL 的路径跳转到相应的页面。
问题：为什么我的 DeepLink 在模拟器上可以正常工作，但在真机上却不行？

解答： 这可能是因为你的真机没有连接到互联网，或者你的 Associated Domains 配置不正确。