如何为RecyclerView中通过URL加载的图片实现点击下载到本地的功能

步骤1：添加清单权限 #

打开项目的AndroidManifest.xml文件，添加对应权限适配不同安卓版本：

<!-- 已有网络权限可保留，没有就加上 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 安卓12及以下存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- 安卓13及以上媒体图片权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" android:minSdkVersion="33" />

<application
    ...
    <!-- 安卓10兼容配置，必须加 -->
    android:requestLegacyExternalStorage="true">
    ...
</application>

步骤2：添加动态权限申请回调 #

在MainActivity.java中添加权限申请结果处理逻辑：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1001) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            Toast.makeText(this, "权限获取成功，再次点击下载即可保存", Toast.LENGTH_SHORT).show();
        } else {
            Toast.makeText(this, "请授予存储权限后再尝试下载", Toast.LENGTH_SHORT).show();
        }
    }
}

步骤3：实现下载逻辑 #

在Adapter.java中补全下载按钮的点击事件，我们采用系统自带的DownloadManager实现，无需手动处理异步任务，稳定性更高：
首先在onBindViewHolder方法中找到holder.buttonDownload的点击回调，填入以下代码：

holder.buttonDownload.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        // 先检查存储权限
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            // 安卓13+权限校验
            if (ContextCompat.checkSelfPermission(context, Manifest.permission.READ_MEDIA_IMAGES) != PackageManager.PERMISSION_GRANTED) {
                ActivityCompat.requestPermissions((Activity) context, new String[]{Manifest.permission.READ_MEDIA_IMAGES}, 1001);
                return;
            }
        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            // 安卓6.0-12权限校验
            if (ContextCompat.checkSelfPermission(context, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
                ActivityCompat.requestPermissions((Activity) context, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1001);
                return;
            }
        }
        // 权限已获取，执行下载
        downloadMeme(url);
    }
});

然后在Adapter类中添加私有下载方法：

private void downloadMeme(String imageUrl) {
    // 生成唯一文件名，避免重名覆盖
    String fileSuffix = MimeTypeMap.getFileExtensionFromUrl(imageUrl);
    String fileName = "梗图_" + System.currentTimeMillis() + "." + fileSuffix;

    // 构建下载请求
    DownloadManager.Request request = new DownloadManager.Request(Uri.parse(imageUrl));
    request.setTitle("梗图下载中");
    request.setDescription("正在保存到相册");
    // 下载中、下载完成都显示通知
    request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
    // 设置保存路径为公共图片目录下的Meme文件夹，相册可直接识别
    request.setDestinationInExternalPublicDir(Environment.DIRECTORY_PICTURES, "Meme/" + fileName);
    // 设置文件类型
    request.setMimeType(MimeTypeMap.getSingleton().getMimeTypeFromExtension(fileSuffix));

    // 启动下载
    DownloadManager downloadManager = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE);
    downloadManager.enqueue(request);
    Toast.makeText(context, "开始下载", Toast.LENGTH_SHORT).show();
}

注意事项 #

• 所有需要导入的包Android Studio都会自动提示，直接按alt+enter导入即可
• 该实现适配安卓6.0到最新的安卓14版本，符合谷歌应用商店政策
• 下载的图片会自动出现在系统相册的Meme文件夹中，无需手动刷新

内容的提问来源于stack exchange，提问作者archit kumar