故障排除 - Expo SDK (v4)

使用 Password AutoFill 功能时，存储的密码域名可能会向 App 用户显示为 airbridge.io 或 abr.ge。

在 Airbridge SDK 设置深度链接后，如果使用 Password AutoFill 功能，密码域名将被存储为 Airbridge 深度链接的 App Link 域名，即 airbridge.io 或 abr.ge。

可通过设置 Password AutoFill 使用的 Webcredentials 域名来解决该问题：

1. 请准备用于存储密码的域名（YOUR_DOMAIN）。

2. 请将以下 JSON 托管至 https://YOUR_DOMAIN/.well-known/apple-app-site-association，并确保 Content-Type: application/json。

App ID Prefix 和 Bundle ID 可在 Apple Developer 的 [Identifiers]>[YOUR_APP] 获取。

{
    "webcredentials": {
        "apps": ["YOUR_APP_ID_PREFIX.YOUR_BUNDLE_ID"]
    }
}

3. 请在 Xcode 导航至 [YOUR_PROJECT]>[Signing & Capabilities]。

4. 请点击 “+ Capability” 以添加 Associated Domains。请将 webcredentials:YOUR_DOMAIN 输入至 Associated Domains。

在上传至 AppStore 时，出现关于 Airbridge framework 的 dSYM 被排除的警告。

Airbridge iOS SDK 目前不支持 dSYM。

dSYM 支持正在开发中，将在后续版本提供。请忽略该警告。

如果已使用 expo-route，SDK 安装后 expo-route 功能可能无法运行。

通过 Airbridge 追踪链接进入 App 时，需先将该链接通过 Airbridge 转换为 URI Scheme 深度链接后再进行 route 处理。但由于 expo-router 的影响，可能会导致 route 处理重复或错误跳转等问题。

因此，Airbridge Expo SDK 设计为 route 处理深度链接。

通过以下设置，使 route 处理在 Airbridge.setOnDeeplinkReceived 内进行。

import { Airbridge } from 'airbridge-react-native-sdk';
import * as Router from 'expo-router';

const router = Router.useRouter();

Airbridge.setOnDeeplinkReceived((result) => {
  // route deeplink
  router.push(...);
});