Flutter中launchUrl无法唤起外部Google/Apple地图的问题求助

核心原因 #

launchUrl 默认使用 LaunchMode.platformDefault，部分设备会优先用应用内WebView打开链接，而非唤起外部原生地图应用；另外如果URL参数存在空值，也会导致路线解析异常。

解决方案 #

1. 强制指定外部应用启动模式

调用launchUrl时，通过mode参数指定LaunchMode.externalApplication，强制系统唤起外部应用：

static Future<void> openMapDirections(String? startLatitude,
    String? startLongitude, String? endLatitude, String? endLongitude) async {
  // 处理空值，避免URL格式错误
  if (startLatitude == null || startLongitude == null || endLatitude == null || endLongitude == null) {
    throw 'Missing location coordinates';
  }

  final googleUrl = Uri.parse(
    'https://www.google.com/maps/dir/?api=1&origin=$startLatitude,$startLongitude&destination=$endLatitude,$endLongitude&travelmode=driving&dir_action=navigate'
  );

  if (await canLaunchUrl(googleUrl)) {
    // 指定唤起外部应用
    await launchUrl(
      googleUrl,
      mode: LaunchMode.externalApplication,
    );
  } else {
    throw 'Could not open the map.';
  }
}

2. 完善AndroidManifest配置

确保intent-filter放在<activity>标签内部，并添加必要的category：

<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="https" />
  </intent-filter>
</activity>

3. iOS端额外配置（如需支持）

在Info.plist中添加允许查询地图应用的配置：

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>googlemaps</string>
  <string>comgooglemaps</string>
  <string>maps</string> <!-- Apple Maps -->
</array>

进阶优化：优先唤起原生Google Maps #

如果想优先唤起Google Maps原生应用，可使用其专属URL Scheme，失败后再 fallback 到网页版：

static Future<void> openMapDirections(String? startLatitude,
    String? startLongitude, String? endLatitude, String? endLongitude) async {
  if (startLatitude == null || startLongitude == null || endLatitude == null || endLongitude == null) {
    throw 'Missing location coordinates';
  }

  // 原生Google Maps URL
  final nativeGoogleMapsUrl = Uri.parse(
    'comgooglemaps://?saddr=$startLatitude,$startLongitude&daddr=$endLatitude,$endLongitude&directionsmode=driving'
  );
  // 网页版 fallback
  final webGoogleMapsUrl = Uri.parse(
    'https://www.google.com/maps/dir/?api=1&origin=$startLatitude,$startLongitude&destination=$endLatitude,$endLongitude&travelmode=driving&dir_action=navigate'
  );

  if (await canLaunchUrl(nativeGoogleMapsUrl)) {
    await launchUrl(nativeGoogleMapsUrl, mode: LaunchMode.externalApplication);
  } else if (await canLaunchUrl(webGoogleMapsUrl)) {
    await launchUrl(webGoogleMapsUrl, mode: LaunchMode.externalApplication);
  } else {
    throw 'Could not open the map.';
  }
}

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