Flutter嵌入原生代码加载Google Map KML图层报错求助

你在迁移纯Android的KML图层功能到Flutter时遇到的两个错误，其实是两个独立的核心问题：缺少KML工具库依赖和未正确获取GoogleMap实例。下面是具体的解决步骤：

1. 修复「找不到KmlLayer」的错误 #

步骤1：添加Google Maps Utils依赖 #

KmlLayer类不在核心Google Maps SDK中，属于官方提供的Maps Utils扩展库。打开安卓模块下的app/build.gradle（Module级，不是Project级），在dependencies块中添加：

dependencies {
    // 保留你已有的其他依赖
    implementation 'com.google.maps.android:android-maps-utils:2.2.0'
}

同步gradle后，这个库会被自动引入，KmlLayer类就能被识别。

步骤2：导入KmlLayer类 #

在MainActivity.java的顶部添加导入语句：

import com.google.maps.android.kml.KmlLayer;

2. 修复「找不到mMap变量」的错误 #

在纯Android项目中，你可能通过MapFragment直接获取GoogleMap实例，但Flutter的google_maps_flutter插件封装了原生MapView，需要通过插件API来获取GoogleMap对象：

步骤1：获取GoogleMap实例 #

修改MainActivity，实现OnMapReadyCallback接口，通过插件获取MapView并监听Map就绪事件：

public class MainActivity extends FlutterActivity implements OnMapReadyCallback {
    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        GeneratedPluginRegistrant.registerWith(this);

        // 获取google_maps_flutter插件实例
        GoogleMapPlugin googleMapPlugin = (GoogleMapPlugin) getPluginRegistry()
                .registrarFor("io.flutter.plugins.googlemaps.GoogleMapPlugin");
        
        if (googleMapPlugin != null) {
            // 遍历插件管理的MapView（假设你的应用只有一个地图实例）
            for (MapView mapView : googleMapPlugin.getMapViews()) {
                mapView.getMapAsync(this); // 当Map就绪时回调onMapReady
            }
        }

        // 初始化MethodChannel
        new MethodChannel(getFlutterView(), "uk.ac.manchestermaps/kmlLayer")
                .setMethodCallHandler((call, result) -> {
                    if (call.method.equals("retrieveFileFromUrl")) {
                        if (mMap == null) {
                            result.error("MAP_NOT_READY", "GoogleMap还没初始化好，请稍后再试", null);
                            return;
                        }
                        retrieveFileFromUrl();
                        result.success("KMLLayer Retrieved");
                    } else {
                        result.notImplemented();
                    }
                });
    }

    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap;
        // 这里可以添加地图初始化逻辑，比如设置地图类型、缩放级别等
    }

    // 你的retrieveFileFromUrl方法...
}

步骤2：处理Map未就绪的情况 #

在MethodChannel的回调中先判断mMap是否为null，如果是就返回错误，避免空指针异常。

3. 完善DownloadKmlFile的逻辑 #

确保你的AsyncTask能正确下载KML文件，这里是完整的实现：

private class DownloadKmlFile extends AsyncTask<String, Void, byte[]> {
    private final String kmlUrl;

    public DownloadKmlFile(String kmlUrl) {
        this.kmlUrl = kmlUrl;
    }

    @Override
    protected byte[] doInBackground(String... unused) {
        try {
            URL url = new URL(kmlUrl);
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
            connection.setRequestMethod("GET");
            connection.connect();

            InputStream inputStream = connection.getInputStream();
            ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
            byte[] buffer = new byte[1024];
            int bytesRead;
            while ((bytesRead = inputStream.read(buffer)) != -1) {
                outputStream.write(buffer, 0, bytesRead);
            }
            outputStream.close();
            inputStream.close();
            return outputStream.toByteArray();
        } catch (IOException e) {
            e.printStackTrace();
            return null;
        }
    }

    @Override
    protected void onPostExecute(byte[] byteArr) {
        if (byteArr == null || mMap == null) {
            return;
        }
        try {
            KmlLayer kmlLayer = new KmlLayer(mMap, new ByteArrayInputStream(byteArr), getApplicationContext());
            kmlLayer.addLayerToMap();
            // 如果需要处理KML的样式或交互，可以在这里添加逻辑
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

额外注意点 #

• 确保你的AndroidManifest.xml已经配置了Google Maps API密钥和必要权限：

  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  
  <application>
      <meta-data
          android:name="com.google.android.geo.API_KEY"
          android:value="你的API密钥" />
  </application>
  

• 在Flutter层，建议等GoogleMapController初始化完成后再调用_showCampusMap方法，避免过早触发原生调用导致Map未就绪。

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