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下编写自己的代码。
@Overridepublic 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 权限即可。
