iOS 环境所需的深度链接信息如下：

• iOS URI Scheme：根据 iOS URI Scheme，将 Airbridge 深度链接转换为 URI Scheme 深度链接。URI Scheme 深度链接需要此信息。

• iOS App ID：根据 iOS App ID，为 Airbridge 深度链接设置 Universal Link 域名。Universal Link 需要此信息。

请按照以下步骤在 Airbridge 面板注册深度链接信息：

1. 请前往 [追踪链接]>[深度链接]。

2. 请在 [iOS URI Scheme] 中输入 iOS URI Scheme，该 URI Scheme 必须与 :// 一起输入。例如，如果 iOS URI Scheme 是 demo，则输入 demo://。

3. 请在 Apple Developer Dashboard，进入您要设置深度链接的 App 的 [Identifier] 页面，获取 App ID Prefix 和 Bundle ID。

4. iOS App ID 的格式为 App ID Prefix+.+Bundle ID。请在 Airbridge 面板 [追踪链接]>[深度链接]>[iOS App ID] 中输入 iOS App ID。

例如，如果 App ID Prefix 是 prefix，Bundle ID 是 example，则 iOS App ID 为 prefix.example。

Android 环境所需的深度链接信息如下：

• Android URI Scheme：根据 Android URI Scheme，将 Airbridge 深度链接转换为 URI Scheme 深度链接。App Link 和 URI Scheme 需要此信息。

• Android 包名：用于识别 Android 包。App Link 和 URI Scheme 需要此信息。

• Android sha256_cert_fingerprints：用于设置 App Link 域名。App Link 需要此信息。

注意

为确保正确的用户跳转，请为正式版 App 和开发用 App 注册不同的深度链接信息。

请按照以下步骤在 Airbridge 面板注册深度链接信息：

1. 请前往 [追踪链接]>[深度链接]。

2. 请在 [Android URI Scheme] 中输入 Android URI Scheme，该 URI Scheme 必须与 :// 一起输入。例如，如果 Android URI Scheme 是 demo，则输入 demo://。

3. 请在 [Android 包名] 中输入 Android 包名。

4. 为了获取 sha256_cert_fingerprints，请在部署的 keystore 文件中运行以下命令：

keytool -list -v -keystore YOUR_KEYSTORE.keystore

请查看结果中的 SHA256 值。SHA256 值即是 sha256_cert_fingerprints。

Certificate fingerprints:
    MD5:  4C:65:04:52:F0:3F:F8:65:08:D3:71:86:FC:EF:C3:49
    SHA1: C8:BF:B7:B8:94:EA:5D:9D:38:59:FE:99:63:ED:47:B2:D9:5A:4E:CC
    SHA256: B5:EF:4D:F9:DC:95:E6:9B:F3:9A:5E:E9:D6:E0:D8:F6:7B:AB:79:C8:78:67:34:D9:A7:01:AB:6A:86:01:0E:99

5. 请在 [sha256_cert_fingerprints] 中输入在步骤 4. 获取的 SHA256 值。

请按照以下步骤进行设置，以确保用户点击追踪链接后，App 能通过 Airbridge 深度链接启用。

1. 需要在 App 进行 Airbridge 深度链接的 URI Scheme 深度链接设置。请在 Xcode 中导航至 [YOUR_PROJECT]>[Info]>[URL Types]。

2. 请点击 “+”，并在 URL Schemes 中输入已在 Airbridge 面板中注册的 iOS URI Scheme。

注意

必须输入不包括 :// 的 iOS URI Scheme。

3. 需要在 App 进行 Airbridge 深度链接的 Universal Link 设置。请在 Xcode 中导航至 [YOUR_PROJECT]>[Signing & Capabilities]。

4. 请点击 “+ Capability” 以添加 Associated Domains。

5. 请将 applinks:YOUR_APP_NAME.airbridge.io 和 applinks:YOUR_APP_NAME.abr.ge 添加至 Associated Domains。YOUR_APP_NAME 是 Airbridge App 名称。

注意

如果您正在使用或计划使用 Password AutoFill 功能，则必须添加 Webcredentials 域名。否则用户可能会看到通过 Password AutoFill 功能保存的密码域名显示为 airbridge.io 或 abr.ge。

更多信息请参阅 本指南。

1. 需要在 App 进行 Airbridge 深度链接的 URI Scheme 深度链接设置。请在 AndroidManifest.xml 的处理深度链接的 Activity 中添加 Intent Filter。

添加的 Intent Filter 必须使用在 Airbridge 面板中注册的 Android URI Scheme。请输入 Android URI Scheme，不包括 ://。

<activity ...>
    ...
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="YOUR_SCHEME" />
    </intent-filter>
    ...
</activity>

注意

必须输入不包括 :// 的 Android URI Scheme。

2. 为了在 App 设置 Airbridge 深度链接的 App Link，请在 AndroidManifest.xml 的处理深度链接的 Activity 中添加以下 Intent Filter。YOUR_APP_NAME 是 Airbridge App 名称。

<activity ...>
    ...
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="YOUR_APP_NAME.abr.ge" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.abr.ge" />
    </intent-filter>
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data android:scheme="http" android:host="YOUR_APP_NAME.airbridge.io" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.airbridge.io" />
    </intent-filter>
    ...
</activity>

为了收集深度链接事件，必须将深度链接事件传递给 Airbridge SDK。当 App 通过深度链接启用时，请在调用的 OS 回调顶部调用 Airbridge.trackDeeplink 函数。

请将以下代码添加至 ios/YOUR_PROJECT_NAME/AppDelegate.m 文件中：

#import <AirbridgeReactNative/AirbridgeReactNative.h>
...
// when app is opened with scheme deeplink
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    // track deeplink
    [AirbridgeReactNative trackDeeplinkWithUrl:url];

    return YES;
}
...
// when app is opened with universal links
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
    // track deeplink
    [AirbridgeReactNative trackDeeplinkWithUserActivity:userActivity];

    return YES;
}

import AirbridgeReactNative
...
// when app is opened with scheme deeplink
func application(
    _ app: UIApplication,
    open url: URL,
    options: [UIApplication.OpenURLOptionsKey : Any] = [:]
) -> Bool {
    // track deeplink
    AirbridgeReactNative.trackDeeplink(url: url)

    return true
}
...
// when app is opened with universal links
func application(
    _ application: UIApplication,
    continue userActivity: NSUserActivity,
    restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
) -> Bool {
    // track deeplink
    AirbridgeReactNative.trackDeeplink(userActivity: userActivity)

    return true
}

请将以下代码添加至 android/app/src/main/java/.../MainActivity.kt 文件中：

import co.ab180.airbridge.reactnative.AirbridgeReactNative
...
override fun onResume() {
    super.onResume()
    AirbridgeReactNative.trackDeeplink(intent)
}
...
override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    setIntent(intent)
}

import co.ab180.airbridge.reactnative.AirbridgeReactNative;
...
@Override
protected void onResume() {
    super.onResume();
    AirbridgeReactNative.trackDeeplink(getIntent());
}
...
@Override
public void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    setIntent(intent);
}

Airbridge 深度链接被启用后，将被转换为 URI Scheme 深度链接并传递至 OnDeeplinkReceived 回调。非 Airbridge 深度链接则原样传递。

使用接收的深度链接，将用户发送至预设的目标页面。

import { Airbridge } from 'airbridge-react-native-sdk'
...
Airbridge.setOnDeeplinkReceived((url) => {
    // show proper content using url
})

Airbridge SDK 在初始化以后，如果满足以下所有条件，会尝试获取深度链接。如果在获取深度链接的过程中 App 被关闭，Airbridge SDK 会将视为没有保存的深度链接。

• 已设置 Opt-in 时调用 Airbridge.startTracking 函数；或未设置 Opt-in。

• 用户在 ATT 弹窗中做出选择，或 ATT 弹窗中设置的事件收集延迟时间已到期。