Expo React Native应用Deep Linking实现遇阻求助

一、基础配置校验 #

• 核对app.json中的scheme配置，确保iOS/Android端均正确设置：

  {
    "expo": {
      "scheme": ["mycustomapp"], // 用独特名称，避免与其他应用冲突
      "ios": {
        "bundleIdentifier": "com.yourname.yourapp"
      },
      "android": {
        "package": "com.yourname.yourapp",
        "intentFilters": [
          {
            "action": "android.intent.action.VIEW",
            "data": [
              {
                "scheme": "mycustomapp",
                "host": "*"
              }
            ],
            "category": ["android.intent.category.DEFAULT", "android.intent.category.BROWSABLE"]
          }
        ]
      }
    }
  }
  

  注意：scheme不要用app这类通用词，避免系统内冲突；Android的intentFilters必须包含BROWSABLE类别，否则无法从浏览器唤起应用。

二、本地测试方式修正 #

不要直接在浏览器输入链接测试，用以下可靠方式验证：

• Expo CLI命令：

  # iOS模拟器/真机
  expo url-scheme open mycustomapp://test --ios
  # Android模拟器/真机
  expo url-scheme open mycustomapp://test --android
  

• 安卓ADB命令（需连接设备/模拟器）：

  adb shell am start -W -a android.intent.action.VIEW -d "mycustomapp://test" com.yourname.yourapp
  

• iOS模拟器命令：

  xcrun simctl openurl booted mycustomapp://test
  

三、导航层处理检查 #

如果使用React Navigation，确保链接配置与导航结构完全匹配：

1. 定义linking配置：

   import { Linking } from 'expo';
   import { NavigationContainer } from '@react-navigation/native';
   
   const linking = {
     prefixes: ['mycustomapp://', 'https://yourdomain.com'], // 包含所有可能的前缀
     config: {
       screens: {
         Home: 'home',
         Profile: 'profile/:userId', // 动态参数要与路由定义对应
       },
     },
   };
   

2. 处理冷启动与后台唤起：

   useEffect(() => {
     // 处理冷启动时的初始URL
     const initDeepLink = async () => {
       const initialUrl = await Linking.getInitialURL();
       if (initialUrl) {
         navigation.navigate(getRouteFromUrl(initialUrl)); // 自行实现路由解析逻辑
       }
     };
     initDeepLink();
   
     // 处理后台唤起的URL
     const subscription = Linking.addEventListener('url', (event) => {
       navigation.navigate(getRouteFromUrl(event.url));
     });
   
     return () => subscription.remove();
   }, [navigation]);
   

   注：如果使用Expo Router，需在_layout.tsx中配置linking，并通过useSegments或usePathname处理路由跳转。

四、运行环境与缓存清理 #

• 更新Expo Go到最新版本，旧版本可能存在deep link兼容性问题。
• 清除项目缓存：执行expo r -c重启项目。
• 安卓端：卸载重装应用（系统可能缓存旧的intent filter配置）。
• iOS端：在模拟器中「重置内容和设置」，或卸载重装应用。

五、进阶调试手段 #

• 用Linking.canOpenURL('mycustomapp://test')测试系统是否识别你的scheme，返回false则说明配置未生效。
• 安卓查看日志：执行adb logcat | grep IntentFilter，检查是否有接收URL的日志记录。
• iOS查看日志：在Xcode控制台搜索openURL，确认应用是否收到链接请求。
• 排查scheme冲突：如果测试时跳转到其他应用，说明你的scheme被占用，换一个独特名称重试。

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