React Native中Linking.canOpenURL检测Google Maps失效问题排查

问题根源 #

1. URL Scheme不匹配
   你当前使用的是Google Maps的Web版HTTPS链接，Google Maps更新后，可能不再优先注册处理这类普通HTTPS链接的唤起请求，导致Linking.canOpenURL()检测不到对应的处理应用，误判为未安装。

2. Android包可见性限制（Android 11+）
   Android 11及以上系统引入了包可见性机制，如果你的应用没有在AndroidManifest.xml中声明对Google Maps应用的访问权限，canOpenURL()会直接返回false，即使设备上已经安装了Google Maps。

修复方案 #

1. 改用Google Maps专属URL Scheme唤起 #

将原Web链接替换为Google Maps原生应用的专属Scheme格式，确保直接唤起原生应用：

// 替换原Google Maps URL为scheme格式
let url = `googlemaps://dir/?api=1&origin=${sourceLat},${sourceLng}&destination=${encodedAddress}&travelmode=driving`;
if (googlePlaceId) {
    url += `&destination_place_id=${googlePlaceId}`;
}

2. 添加Android包可见性配置 #

在android/app/src/main/AndroidManifest.xml中添加以下配置，让系统允许你的应用检测到Google Maps：

<manifest ...>
    <!-- 其他原有配置 -->
    <queries>
        <!-- 声明允许访问Google Maps应用 -->
        <package android:name="com.google.android.apps.maps" />
        <!-- 声明允许处理googlemaps scheme的Intent -->
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="googlemaps" />
        </intent>
    </queries>
</manifest>

3. 优化唤起逻辑（可选） #

如果想兼容“未安装Google Maps时打开网页版”的场景，可以去掉canOpenURL()检测逻辑，直接尝试唤起原生应用，失败后自动降级到Web版：

Linking.openURL(url)
  .catch(() => {
      // 原生唤起失败，打开Web版地图
      let webUrl = `https://www.google.com/maps/dir/?api=1&origin=${sourceLat},${sourceLng}&destination=${encodedAddress}&travelmode=driving`;
      if (googlePlaceId) {
          webUrl += `&destination_place_id=${googlePlaceId}`;
      }
      return Linking.openURL(webUrl);
  })
  .catch(() => {
      Toast.show({
          type: "error",
          text1: "Failed to open map",
      });
  });

这种方式可以避免canOpenURL()的误判问题，同时保证用户总能打开地图服务。

内容的提问来源于stack exchange，提问作者D-Sibu