Android 百度离线地图及存储权限申请

前言

  项目需要在无网络环境下访问百度地图，于是想到了使用百度的离线地图，特将使用过程中遇到的问题记录下来。安卓设备为华为平板，版本Android12.0 API31.

离线地图的使用

  参考官方的离线地图使用说明，主要使用MKOfflineMap 进行离线地图的下载及维护，首先初始化离线地图，注意init函数中需要传入listener方法，需要自定义实现MKOfflineMapListener，我是在MainActivity声明时直接implements MKOfflineMapListener了，所以填this就行。

 MKOfflineMap  mkOfflineMap = new MKOfflineMap();
 mkOfflineMap.init(this);

  根据城市编码调用MKOfflineMap的start方法下载离线地图，可以通过MKOfflineMap类的searchCity方法根据城市名查找cityId，如下所示，我是在下载该城市地图前，判断了下是否已下载过该城市地图

ArrayList<MKOLUpdateElement> localMapList = mkOfflineMap.getAllUpdateInfo();     //存储已下载的离线地图列表
        if (localMapList != null)
        {
            String[] hasDownLoad = new String[localMapList.size()];
            for (int i = 0; i < localMapList.size(); i++)
            {
                hasDownLoad[i] = localMapList.get(i).cityName;
            }
            for (int j = 0; j < cityNames.length; j++)
            {
                if (containsCity(hasDownLoad, cityNames[j]))
                    Log.i("OfflineMap", cityNames[j]);
                else
                {
                    ArrayList<MKOLSearchRecord> records = mkOfflineMap.searchCity(cityNames[j]);
                    if (records != null && records.size() == 1) {
                        cityId = records.get(0).cityID;
                    }
                    mkOfflineMap.start(cityId);
                    Toast.makeText(this, "开始下载离线地图. cityid: " + cityId, Toast.LENGTH_SHORT).show();
                }
            }
        }

  可以通过onGetOfflineMapState的回调信息，查看更新进度、新离线地图安装、版本更新提示，在implements MKOfflineMapListener后，该函数会自动生成，可以在相应的case下编写自己的代码。

@Override
    public void onGetOfflineMapState(int type, int state) {
        switch (type) {
            case MKOfflineMap.TYPE_DOWNLOAD_UPDATE:
                MKOLUpdateElement update = mkOfflineMap.getUpdateInfo(state);
                // 处理下载进度更新提示
                if (update != null) {
                    Log.i("offlineDownLoad", String.format("%s : %d%%", update.cityName, update.ratio));
                }
                break;
            case MKOfflineMap.TYPE_NEW_OFFLINE:
                // 有新离线地图安装
                Log.d("OfflineDemo", String.format("add offlinemap num:%d", state));
                break;
            case MKOfflineMap.TYPE_VER_UPDATE:
                // 版本更新提示
                // MKOLUpdateElement e = mOffline.getUpdateInfo(state);
                break;
            default:
                break;
        }
    }

  至此已完成了离线地图的下载，但是在测试过程中发现离线地图并没被加载，同时回调函数中也没有下载进度的更新提示，一开始是怀疑自己的离线地图加载有问题，怀疑并不是自动加载的，而是需要调用什么set之类的函数才能加载离线地图，后来找了半天，也没发现什么解决方法，而且官方文档上的说明是在有离线地图的情况下，地图SDK会优先加载离线地图，于是换了个思路，突然想到是不是离线地图根本没下载成功，这也是回调函数中没有提示的原因，运行过程中APP有网络连接，所以可能是存储访问权限的问题，于是检查自己的存储权限申请，尝试随便在外部存储中创建个文件夹，显示not permit，果然问题出现在这了。

存储权限的申请

  之前不知道在哪看的是要申请MANAGE_EXTERNAL_STORAGE权限，但是没申请成功，不过我在在应用管理上手动打开了所有权限，就以为授权OK了，其实不然，对于Android12应该按照如下申请存储的权限：
  1、在 AndroidManifest.xml 文件中添加存储权限声明：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

  2、在Activity中检查是否已获得存储权限，若未获得则进行申请。注意下方的MY_PERMISSIONS_REQUEST_STORAGE请替换为自己的request code，以方便在回调函数中进行区分处理。

if (ContextCompat.checkSelfPermission(this,
                Manifest.permission.WRITE_EXTERNAL_STORAGE)
                != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
                    MY_PERMISSIONS_REQUEST_STORAGE);
        }

  3、在请求权限之前，也可以使用 ActivityCompat.shouldShowRequestPermissionRationale() 方法检查是否需要向用户解释为什么需要该权限。如果需要解释，可以向用户显示一个对话框或提示，以便说明权限的用途。我这里就不需要了。
  4、在Activity中重写onRequestPermissionsResult方法，以接收权限请求的结果：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    if (requestCode == requestCode) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限已授予，执行访问存储的操作
        } else {
            // 权限被拒绝
        }
    }
}

  在正确请求存储权限后，离线地图得以正常显示了，这里也额外说明下MANAGE_EXTERNAL_STORAGE权限：MANAGE_EXTERNAL_STORAGE 权限是一项特殊权限，需要在应用的 AndroidManifest.xml 文件中声明，并且还需要进行特殊的审核和授予过程，通常适用于需要管理存储空间的系统级应用程序。对于大多数常规应用程序来说，并不需要直接申请 MANAGE_EXTERNAL_STORAGE 权限。如果只需要在应用中访问应用专属目录、公共存储目录或使用 Android 官方 API 访问存储，通常只需申请 WRITE_EXTERNAL_STORAGE 权限即可。