Flutter Android端无法打开地图问题求助

已添加url_launcher依赖，但调用打开地图方法时出现component name is null错误，最终抛出Could not open the map.异常。以下是具体排查和解决步骤：

1. 配置AndroidManifest.xml（Android 11+必做） #

Android 11及以上版本需要明确声明要查询的应用包名，否则系统无法识别可处理谷歌地图URL的应用。在项目android/app/src/main/AndroidManifest.xml的<application>标签外添加以下代码：

<queries>
    <!-- 声明允许查询谷歌地图应用 -->
    <package android:name="com.google.android.apps.maps" />
</queries>

2. 优化url_launcher调用逻辑 #

原代码直接使用字符串URL调用，可改为通过Uri构建链接，并指定启动模式，同时增加未安装地图时的网页 fallback：

修改后的MapsUtils类代码：

import 'package:url_launcher/url_launcher.dart';

class MapsUtils {
  MapsUtils._();

  static Future<void> openMapWithPosition(double latitude, double longitude) async {
    // 谷歌地图APP跳转协议
    final mapUri = Uri.parse('google.navigation:q=$latitude,$longitude');
    // 网页版备用链接
    final webUri = Uri.parse('https://www.google.com/maps/search/?api=1&query=$latitude,$longitude');

    if (await canLaunchUrl(mapUri)) {
      await launchUrl(mapUri, mode: LaunchMode.externalApplication);
    } else if (await canLaunchUrl(webUri)) {
      await launchUrl(webUri, mode: LaunchMode.externalApplication);
    } else {
      throw "无法打开地图，请检查是否安装谷歌地图或网络连接";
    }
  }

  static Future<void> openMapWithAddress(String fullAddress) async {
    final encodedAddress = Uri.encodeComponent(fullAddress);
    // 谷歌地图APP跳转协议
    final mapUri = Uri.parse('google.navigation:q=$encodedAddress');
    // 网页版备用链接
    final webUri = Uri.parse('https://www.google.com/maps/search/?api=1&query=$encodedAddress');

    if (await canLaunchUrl(mapUri)) {
      await launchUrl(mapUri, mode: LaunchMode.externalApplication);
    } else if (await canLaunchUrl(webUri)) {
      await launchUrl(webUri, mode: LaunchMode.externalApplication);
    } else {
      throw "无法打开地图，请检查是否安装谷歌地图或网络连接";
    }
  }
}

3. 关键说明 #

• component name is null错误原因：系统找不到能处理目标URL的应用组件，要么是设备未安装谷歌地图，要么是Android 11+未声明queries权限。
• 使用google.navigation:协议可直接唤起谷歌地图APP，比网页链接更可靠；同时保留网页版作为 fallback，提升兼容性。
• LaunchMode.externalApplication确保在外部应用中打开地图，避免在应用内置WebView中加载。

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