如何在无网络环境下集成Android离线地图功能？

• 离线地图核心逻辑为「离线资源下载→本地按规则存储→无网环境下优先加载本地资源」，你当前编写的AsyncTask下载逻辑是下载环节的基础实现，可基于此扩展适配离线地图场景。
• 现有代码的优化方向：
  你当前的DownloadTask仅实现了基础的网络数据拉取能力，适配离线地图需要补充3个核心逻辑：
  1. 下载前先校验本地是否已存在对应层级、坐标的瓦片/离线包资源，避免重复下载消耗用户流量
  2. 下载完成后将返回的地图数据（瓦片多为png/webp格式，厂商SDK离线包为专有格式）按规则写入本地指定目录存储
  3. 补充下载失败重试、断点续传逻辑，避免大体积离线包下载中断后需要重新下载
• 完整实现步骤：
  1. 先在你使用的地图SDK中开启离线缓存开关，配置本地离线资源的存储路径，让SDK在无网络时优先检索本地存储的地图资源加载
  2. 完善ParserTask解析逻辑：如果下载的是离线包索引数据，需解析出每个瓦片的下载地址、层级、坐标信息，依次加入下载队列；如果使用OSM开源瓦片，可直接按层级、行列号拼接下载地址
  3. 适配系统权限：Android 6.0以上需要动态申请存储权限，Android 10以上适配分区存储规则，避免下载的地图文件无法被SDK读取

适配离线地图场景的代码示例 #

private class DownloadTask extends AsyncTask<String, Void, Bitmap> { // 下载瓦片时返回类型改为Bitmap更便于存储和加载
    // 存储当前下载瓦片的层级、行列号，用于本地文件命名
    private int z, x, y;

    public DownloadTask(int z, int x, int y) {
        this.z = z;
        this.x = x;
        this.y = y;
    }

    @Override
    protected Bitmap doInBackground(String... url) {
        // 先判断本地是否已有该瓦片，存在则直接返回无需重复下载
        File tileFile = new File(getExternalFilesDir("map_tiles") + File.separator + z + File.separator + x + File.separator + y + ".png");
        if (tileFile.exists()) {
            return BitmapFactory.decodeFile(tileFile.getAbsolutePath());
        }
        Bitmap tileBitmap = null;
        try {
            // 拉取网络瓦片数据
            InputStream inputStream = new URL(url[0]).openStream();
            tileBitmap = BitmapFactory.decodeStream(inputStream);
            // 下载完成后写入本地存储
            saveTileToLocal(tileBitmap, z, x, y);
        } catch (Exception e) {
            Log.d("Background Task", e.toString());
        }
        return tileBitmap;
    }

    @Override
    protected void onPostExecute(Bitmap result) {
        super.onPostExecute(result);
        // 下载完成后直接加载到地图图层即可，无需额外解析的场景可省略ParserTask
        if (result != null) {
            mapView.addTile(z, x, y, result);
        }
    }

    // 瓦片写入本地存储的工具方法
    private void saveTileToLocal(Bitmap bitmap, int z, int x, int y) {
        File dir = new File(getExternalFilesDir("map_tiles") + File.separator + z + File.separator + x);
        if (!dir.exists()) {
            dir.mkdirs();
        }
        File tileFile = new File(dir, y + ".png");
        try {
            FileOutputStream fos = new FileOutputStream(tileFile);
            bitmap.compress(Bitmap.CompressFormat.PNG, 100, fos);
            fos.flush();
            fos.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

注意：AsyncTask在Android 11中已被官方标记为废弃，如果你适配的是高版本系统，建议替换为Kotlin协程或者WorkManager实现后台下载任务，避免内存泄漏、后台任务被系统回收的问题。

内容的提问来源于stack exchange，提问作者zumi application 2021