新版本flutter（3.32.7） android 端集成百度地图sdk

新版本flutter（3.32.7） android 端集成百度地图sdk

因为官方文档有很多地方没有说清楚，导致在适配过程中踩了很多坑，本文档基于已经实现集成的flutter安卓端应用编写。

官方文档地址：https://lbs.baidu.com/faq/api?title=flutter/loc/create-project/configure

Flutter是谷歌的移动UI框架，可以快速在iOS和Android上构建高质量的原生用户界面，因其毫秒级热重载能够实现快速开发、具备超强原生性能以及富有表现力和灵活的UI，越来越受开发者喜爱，因此推出百度定位Flutter插件供广大开发者在开发Flutter Application的时候，可以集成本插件实现基本定位需求。

集成后地图长这样：

第一步：打开/创建一个flutter application工程

根据开发者的实际使用情况，打开一个已有的flutter application工程，或新建一个flutter application工程。 这里不再赘述。

第二步申请Android端AK

在百度地图开放平台控制台应用管理中创建Android端AK
如果之前没有认证过需要先登录，再认证开发者。
地址：https://lbs.baidu.com/apiconsole/key

创建这个需要两个东西，一个是packageName，在这获取：

另一个是 SHA1码，网上自行查找获取方法。

创建完后长这样：

第三步：添加依赖

pubspec.yaml 文件添加flutter依赖

  # 百度地图
  flutter_baidu_mapapi_base: ^3.9.5
  flutter_baidu_mapapi_map: ^3.9.5
  flutter_baidu_mapapi_utils: ^3.9.5
  flutter_baidu_mapapi_search: ^3.9.5

  permission_handler: ^12.0.1 # 动态申请权限插件
  geolocator: ^14.0.2 # 获取当前定位插件

百度地图使用只需要前四个即可，后面是我定位还有获取权限使用。不需要的可以不加

dart run pub get 下载依赖

第四步：新建 MyApplication.kt 文件

在 MainActivity 同级目录下创建 MyApplication.kt 文件，内容如下：

package xxx // 这个package要和 MainActivity 里面的一致

import com.baidu.mapapi.base.BmfMapApplication

class MyApplication : BmfMapApplication() {
    override fun onCreate() {
        super.onCreate()
    }
}

创建好了长这样：

第五步：调整 android AndroidManifest.xml 文件

调整 android/app/src/main/AndroidManifest.xml 文件，调整如下：
1、在 manifest 子节点新增如下内容，用于sdk的权限声明

    <!-- 用于访问wifi网络信息，wifi信息会用于进行网络定位 -->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!-- 获取网络状态，根据网络状态切换进行数据请求网络转换 -->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- 写外置存储。如果开发者使用了离线地图，并且数据写在外置存储区域，则需要申请该权限 -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <!-- 读取外置存储。如果开发者使用了so动态加载功能并且把so文件放在了外置存储区域，则需要申请该权限，否则不需要 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <!-- 访问网络，进行地图相关业务数据请求，包括地图数据，路线规划，POI检索等 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <!-- 定位权限 -->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

2、修改 application 节点属性android:name="${applicationName}"，调整为如下：

android:name=".MyApplication"

3、在 application 子节点新增如下内容，用于声明百度地图SDK的 AK：

        <!-- 百度地图AK -->
        <meta-data android:name="com.baidu.lbsapi.API_KEY" android:value="你自己申请的android AK, xxxxxx" />

所有调整完，长这样：

目前百度地图sdk无法在模拟器运行，请至真机调试！！

此时运行可能会报 sdk版本问题，因为最新版本的sdk要求android minSdk在22以上，而flutter创建的默认为21：

调整 android/app/build.gradle.kts 文件，将 minSdk = flutter.minSdkVersion 改为 minSdk = 22

到这一步，用调试模式启动已经没用问题了，已经可以正常调试使用，但是正式打包后，会闪退或者白屏，这是因为flutter高版本打包会默认开启代码混淆代码导致

第六步： android release 正式打包配置调整

1、调整 android/app/build.gradle.kts 文件 buildTypes.release 添加子属性

 ndk {
       // 设置支持的SO库架构（开发者可以根据需要，选择一个或多个平台的so）
       // 如果不指定将默认包含所有架构so包，会导致apk体积较大，这里选择当前主流的
       abiFilters += setOf("armeabi-v7a", "arm64-v8a")
   }
   //代码混淆配置 移除对百度sdk的混淆，否则百度地图无法使用
   proguardFiles(getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro")

2、同时在android/app/目录下新增混淆配置文件（android/app/proguard-rules.pro），用于定义混淆配置，文件内容如下：

-keep class com.baidu.** {*;}
-keep class vi.com.** {*;}
-keep class com.baidu.vi.** {*;}
-dontwarn com.baidu.**

调整完长这样：

地图测试：

写了一个测试页面用于测试百度地图是否正常使用
功能比较简单，只是展示地图，进入页面时请求定位权限，将地图中心点定位至当前位置。

新建一个页面 baidu_map_test.dart 内容如下：

import 'dart:io' show Platform;

import 'package:flutter/material.dart';
import 'package:flutter_baidu_mapapi_base/flutter_baidu_mapapi_base.dart';
import 'package:flutter_baidu_mapapi_map/flutter_baidu_mapapi_map.dart';
import 'package:geolocator/geolocator.dart';

class ChooseLocation extends StatefulWidget {
  const ChooseLocation({super.key});

  @override
  State<StatefulWidget> createState() => ChooseLocationState();
}

class ChooseLocationState extends State<ChooseLocation> {
  late BMFMapController mapController;
  bool enabled = false;
  Future<Position>? positionFuture;

  // Future<>

  @override
  void initState() {
    initMap();
    super.initState();
  }

  void initMap() async {
    /// 动态申请定位权限

    /// 设置用户是否同意SDK隐私协议
    BMFMapSDK.setAgreePrivacy(true);

    // 百度地图sdk初始化鉴权
    if (Platform.isIOS) {
      BMFMapSDK.setApiKeyAndCoordType('申请的AK', BMF_COORD_TYPE.BD09LL);
    } else if (Platform.isAndroid) {
      /// 初始化获取Android 系统版本号，如果低于10使用TextureMapView 等于大于10使用Mapview
      await BMFAndroidVersion.initAndroidVersion();
      // Android 目前不支持接口设置Apikey,
      // 请在主工程的Manifest文件里设置，详细配置方法请参考官网(https://lbsyun.baidu.com/)demo
      BMFMapSDK.setCoordType(BMF_COORD_TYPE.BD09LL);
    }
    await requestPermission();
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('选择地址')),
      body: buildMap(context),
    );
  }

  Widget buildMap(BuildContext context) {
    BMFMapOptions mapOptions = BMFMapOptions(
      center: BMFCoordinate(39.917215, 116.380341),
      zoomLevel: 12,
      mapPadding: BMFEdgeInsets(left: 30, top: 0, right: 30, bottom: 0),
    );

    return SizedBox(
      height: 200,
      width: double.infinity,
      child: BMFTextureMapWidget(onBMFMapCreated: onMapCreated, mapOptions: mapOptions),
    );
  }

  Widget buildEmpty(BuildContext context) {
    return Text('未授权');
  }

  void onMapCreated(BMFMapController controller) async {
    mapController = controller;
    mapController.setMapDidLoadCallback(
      callback: () async {
        positionFuture ??= getPosition();
        var positionData = await positionFuture!;
        setCentByLocation(positionData.latitude, positionData.longitude);
      },
    );
  }

  //获取用户位置并移动地图到人员中心
  Future requestPermission() async {
    /// 单次获取设备当前位置
    //  1. 检查定位服务是否开启
    bool serviceEnabled = await Geolocator.isLocationServiceEnabled();
    if (!serviceEnabled) {
      // 定位服务未开启，返回错误
      return Future.error('请开启定位服务');
    }

    // 2. 检查定位权限
    LocationPermission permission = await Geolocator.checkPermission();
    if (permission == LocationPermission.denied) {
      // 权限被拒绝，请求权限
      permission = await Geolocator.requestPermission();
      if (permission == LocationPermission.denied) {
        return Future.error('定位权限被拒绝');
      }
    }

    if (permission == LocationPermission.deniedForever) {
      // 权限被永久拒绝，引导用户去设置页开启
      return Future.error('定位权限被永久拒绝，请在设置中开启');
    }
    positionFuture ??= getPosition();
  }

  Future<Position> getPosition() async {
    // 3. 配置定位参数（可选）
    final LocationSettings locationSettings = LocationSettings(
      accuracy: LocationAccuracy.best,
      timeLimit: Duration(seconds: 10), // 超时时间（可选）
    );
    return Geolocator.getCurrentPosition(locationSettings: locationSettings);
  }

  void setCentByLocation(double latitude, double longitude) async {
    var mapOptions = BMFMapOptions(center: BMFCoordinate(latitude, longitude), zoomLevel: 16);
    mapController.updateMapOptions(mapOptions);
    getPoiByLocation(latitude, longitude);
  }

  void getPoiByLocation(double latitude, double longitude) {}
}

注意：国内网络原因打包或者运行可能会卡在这一步：

连接梯子即可解决，没有其他好的办法。