iOS 问题排查

验证是否成功下载了 AASA 文件

  • 将测试设备连接到您的 MAC

  • 卸载应用

  • 在 MAC 控制台中查看设备的控制台输出

  • 安装您的应用并启动

  • 通过 "swcd" 筛选控制台输出

  • 如果成功下载 AASA,您将看到以下屏幕截图(如果未下载 AASA,则必须卸载应用,重新启动设备,然后重新安装应用)

图片图片

无法打开应用

应用未传递数据

深度链接是长链

  • 当应用无法与 Branch 服务器建立连接时出现

  • 深度链接长链仍可以打开应用并传递数据

Deferred Deep Linking not Working

  • It is possible that you have not enabled NativeLink™. That will cause deferred deep linking to not work on iOS 15+ devices on Private Relay

  • To implement iOS NativeLink™, follow the instructions in our developer documentation.

Testing Steps:

  1. Click a one-off Branch Link where "$ios_nativelink"=true is set in the link parameters.
  2. Using a device on iOS 15+, uninstall the app from your device.
  3. Click the Branch Link from Apple Notes and have it route through Safari.
  4. Click the call-to-action and ensure that the link is copied to the iOS clipboard.
  5. Install or build the new app version directly from XCode.

Expected Behavior:

  1. Upon link redirect to the App Store, the user sees the new NativeLink experience.
  2. When the app opens, the user should see a notification that the app has pasted from the clipboard
  3. The API call to api2.branch.io/v1/open or v1/install should include a new parameter called "local_url".

追踪内容属性

Key
BNCRegisterViewEvent用户查看了对象
BNCAddToWishlistEvent用户将该对象添加到他们的愿望清单
BNCAddToCartEvent用户将对象添加到购物车
BNCPurchaseInitiatedEvent用户开始签出
BNCPurchasedEvent用户购买了该物品
BNCShareInitiatedEvent用户开始分享对象
BNCShareCompletedEvent用户完成了分享

重新启用 Universal Linking

  • Apple 允许用户在 iOS 9和 iOS 10(iOS 11中已修复)上禁用每个设备上每个应用级别的 universal linking

  • Use Test deep link to re-enable universal linking on the device

使用 BranchViewController 进行深度链接路由

Branch.getInstance().registerDeepLinkController(ViewController(), forKey: "my-key", withPresentation: .optionShow)
[[Branch getInstance] registerDeepLinkController:customViewController forKey:@"my-key"withPresentation:BNCViewControllerOptionShow];

确定深度链接是否在无网络环境下来自 Branch

  • 如果要在无网络请求的情况下从continueUserActivityBranch.getInstance().continue(userActivity)获得true/false响应,则用于 Universal Linking
  • 仅当您有自定义链接域时使用
  • Add branch_universal_link_domains to your info.plist with an array of your link domain from your Branch Dashboard

图片图片


后续步骤推荐
这个页面对您有帮助吗?