React Native Linking url事件未触发问题求助

可能的原因及修复步骤 #

1. 检查AppDelegate中的深度链接处理代码 #

React Native 0.70中，iOS端需要确保AppDelegate正确实现深度链接处理方法，将事件传递给RN的Linking模块。

打开ios/[你的项目名]/AppDelegate.m（或.mm），确认以下代码是否存在：

Objective-C版本：

#import <React/RCTLinkingManager.h>

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
  return [RCTLinkingManager application:app openURL:url options:options];
}

// 适配Universal Links（若使用）
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler
{
  return [RCTLinkingManager application:application continueUserActivity:userActivity restorationHandler:restorationHandler];
}

Swift版本：

import React

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
  return RCTLinkingManager.application(app, open: url, options: options)
}

func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  return RCTLinkingManager.application(application, continue: userActivity, restorationHandler: restorationHandler)
}

如果缺失上述方法，添加后重新编译运行再测试。

2. 确认Linking事件监听时机 #

确保在组件挂载阶段就添加事件监听，避免错过触发时机：

函数组件示例：

import { Linking, useEffect } from 'react-native';

useEffect(() => {
  const handleUrl = (event) => {
    console.log('收到深度链接:', event.url);
    // 此处添加你的链接处理逻辑
  };

  Linking.addEventListener('url', handleUrl);

  return () => {
    Linking.removeEventListener('url', handleUrl);
  };
}, []);

类组件示例：

import { Linking, Component } from 'react-native';

class MyComponent extends Component {
  componentDidMount() {
    Linking.addEventListener('url', this.handleUrl);
  }

  componentWillUnmount() {
    Linking.removeEventListener('url', this.handleUrl);
  }

  handleUrl = (event) => {
    console.log('收到深度链接:', event.url);
    // 此处添加你的链接处理逻辑
  };

  // 其他组件代码
}

3. 验证深度链接触发方式 #

• 先手动将应用切换到模拟器前台，再执行npx uri-scheme open "mychat://bar" --ios测试
• 也可尝试在模拟器Safari中直接输入mychat://bar触发链接，排除命令行工具的问题

4. 清除缓存重新编译 #

React Native 0.70版本更新较大，缓存可能导致异常，执行以下命令清理后重新构建：

# 清除RN缓存
npx react-native start --reset-cache

# 清除iOS构建缓存
cd ios && pod deintegrate && pod install && cd ..

内容的提问来源于stack exchange，提问作者Lev