一个Android下载网络图片显示并保存到系统相册的完整案例

于 2024-08-08 15:37:45 发布
阅读量1.2k 收藏 32
点赞数 24
分类专栏： Android开发学习 文章标签： android 下载图片 系统相册
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/fxjzzyo/article/details/140770815
版权

文章目录

1. 案例简介

在 Android开发 中，下载图片保存到本地是常见的需求，看似简单但其中包含了一些比较关键的知识点，比如网络请求、文件下载、动态权限申请、文件保存、移动到系统相册等

1.1 效果演示

下载网络图片

2. 工程配置

本案例使用 Android Studio 开发，kotlin语言。 build.gradle 文件中的必要依赖有：

// Retrofit
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

// RxJava
implementation 'io.reactivex.rxjava2:rxjava:2.2.20'
implementation 'io.reactivex.rxjava2:rxandroid:2.1.1'

// Retrofit RxJava Adapter
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.9.0'

// 使用 Gson
implementation 'com.google.code.gson:gson:2.8.9'

3. 网络层

使用 Retrofit 网络请求框架+RxJava 异步数据流处理库。

3.1 网络接口定义

接口层定义了下载文件的方法 downloadFile，接收参数是下载地址的相对路径。因为 Retrofit 在构建的时候会有一个 BaseUrl，拼接上这里的相对路径就是完整的下载地址。

import io.reactivex.Single
import okhttp3.ResponseBody
import retrofit2.http.GET
import retrofit2.http.Url

interface INetApi {
    @GET
    fun downloadFile(@Url relativePath: String?): Single<ResponseBody>
}

3.2 Retrofit工具类

一般都会创建一个 RetrofitUtil 工具类来创建 Retrofit 实例对象供外界调用。这里的BaseUrl 也由外界传入，可以创建多个不同的实例。

import retrofit2.Retrofit
import retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory
import retrofit2.converter.gson.GsonConverterFactory

object RetrofitUtil {

    fun createRetrofit(baseUrl: String): INetApi {
        val retrofit = Retrofit.Builder()
            .baseUrl(baseUrl)
            .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
            .addConverterFactory(GsonConverterFactory.create())
            .build()
        return retrofit.create(INetApi::class.java)
    }
}

4. 主界面及完整代码

这里我们搭建一个简单的下载图片的UI界面。图片的地址是网上随便找的一个网络图片地址：https://i2.hdslb.com/bfs/archive/961b6650675f97b297bb5ec764ce89b314134544.jpg
你也可以随便找一个，替换成你的地址。

  1. 界面中有一个按钮 Button 和一个图片 ImageView，点击按钮，触发 startDownload 方法，通过上面封装好的 RetrofitUtil 工具类，传入 BaseUrl 和 图片的相对地址，进行网络请求。

  2. 使用RxJava 处理网络返回数据，在收到返回的数据流后，用 BitmapFactory.decodeStream 解析成一张
    Bitmap 图片，显示到控件 ImageView 上。至此完成网络图片的显示。

  3. 接下来是将这张图片保存到手机中。在 trySaveImage 方法中，首先进行了动态权限检查/申请 ，得到存储权限后，调用
    saveToFile 方法，从 ImageView 上获取图片，创建一个文件准备接收图片，接着使用bitmap.compress
    结合 FileOutputStream 将图片数据压缩到文件中，至此完成了图片保存到本地文件。

  4. 但是，你会发现在手机的系统相册中找不到这张图片。这是因为上面保存的路径是应用内的目录，我们需要将文件拷贝到系统相册，才能在相册中显示。

  5. 于是，调用 moveToAlbum
    方法，将文件移动到系统相册。这里按系统版本会有不同的操作方式，Android10以下稍微麻烦点。都是使用了Android四大组件之一
    ContentProvider 与系统进行内容通信。

  6. 移动完毕之后，不要忘记删除原文件，防止数据冗余。

4.1 完整主界面代码 ImageDownloadActivity

import android.Manifest
import android.content.ContentResolver
import android.content.ContentValues
import android.content.pm.PackageManager
import android.graphics.Bitmap
import android.graphics.BitmapFactory
import android.os.Build
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.os.Environment
import android.provider.MediaStore
import android.util.Log
import android.view.View
import android.view.ViewGroup
import android.widget.ImageView
import android.widget.Toast
import androidx.core.app.ActivityCompat
import androidx.core.content.ContextCompat
import androidx.core.graphics.drawable.toBitmapOrNull
import com.example.mytest.R
import com.example.mytest.util.FileUtil
import com.example.mytest.util.RetrofitUtil
import io.reactivex.android.schedulers.AndroidSchedulers
import io.reactivex.disposables.Disposable
import io.reactivex.schedulers.Schedulers
import java.io.File
import java.io.FileInputStream
import java.io.FileOutputStream
import java.io.IOException

/**
 * 下载图片保存到相册
 * URL：https://i2.hdslb.com/bfs/archive/961b6650675f97b297bb5ec764ce89b314134544.jpg
 */
class ImageDownloadActivity : AppCompatActivity() {

    private lateinit var container: ViewGroup
    private lateinit var imageView1: ImageView

    private val imageUrl = "bfs/archive/961b6650675f97b297bb5ec764ce89b314134544.jpg"
    private val baseImageUrl = "https://i2.hdslb.com/"

    private var disposable: Disposable? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_image_download)
        container = findViewById(R.id.container)
        imageView1 = findViewById(R.id.imageView1)
    }

    fun startDownload(view: View) {
        disposable = RetrofitUtil.createRetrofit(baseImageUrl).downloadFile(imageUrl)
            .subscribeOn(Schedulers.io())
            .observeOn(AndroidSchedulers.mainThread())
            .subscribe({
                val bitmap = BitmapFactory.decodeStream(it.byteStream())
                imageView1?.setImageBitmap(bitmap)
                trySaveImage()
            }, {
                Log.e(Companion.TAG, "startDownload: ${it.message}")
            })
    }

    private fun trySaveImage() {

        if (ContextCompat.checkSelfPermission(
                this,
                Manifest.permission.WRITE_EXTERNAL_STORAGE
            ) != PackageManager.PERMISSION_GRANTED
        ) {
            ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE),
                0)
        } else {
            saveToFile()
        }
    }

    override fun onRequestPermissionsResult(
        requestCode: Int,
        permissions: Array<out String>,
        grantResults: IntArray
    ) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        if (requestCode == 0) {
            if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                saveToFile()
            } else {
                Toast.makeText(this, "拒绝了存储权限！", Toast.LENGTH_SHORT).show()
            }
        }
    }

    private fun saveToFile() {

        val bitmap = imageView1.drawable.toBitmapOrNull() ?: return
        try {
            val fileSaveDirectory = File(getExternalFilesDir(null), "MyImage")
            if (!fileSaveDirectory.exists()) {
                fileSaveDirectory.mkdirs()
            }
            val fileName = System.currentTimeMillis().toString() + ".jpeg"
            val saveFile = File(fileSaveDirectory, fileName)

            Log.i(TAG, "saveToFile: ${saveFile.absolutePath}")
            val outputStream = FileOutputStream(saveFile)
            bitmap.compress(Bitmap.CompressFormat.JPEG, 100, outputStream)
            outputStream.flush()
            outputStream.close()
            Toast.makeText(this, "保存成功！", Toast.LENGTH_SHORT).show()
            moveToAlbum(saveFile)
            Toast.makeText(this, "移动到相册成功！", Toast.LENGTH_SHORT).show()

        } catch (e: Exception) {
            Log.e(TAG, "saveToFile: ${e.message}", e)
            Toast.makeText(this, "保存失败！", Toast.LENGTH_SHORT).show()
        }
    }

    private fun moveToAlbum(file: File): Boolean {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            val values = ContentValues()
            values.put(MediaStore.MediaColumns.DISPLAY_NAME, file.name)
            values.put(MediaStore.MediaColumns.MIME_TYPE, "image/星") // 这里是 image/*
            values.put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_DCIM + File.separator + "MyTest")
            val contentResolver: ContentResolver = contentResolver
            val uri = contentResolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values) ?: return false
            try {
                val outputStream = contentResolver.openOutputStream(uri)?: return false
                val fileInputStream = FileInputStream(file)
                FileUtil.copyFileStream(fileInputStream, outputStream)
                fileInputStream.close()
                outputStream.close()
                file.delete()
                return true
            } catch (e: IOException) {
                e.printStackTrace()
                return false
            }
        } else {
            val cameraDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM)
            if (!cameraDir.exists()) {
                cameraDir.mkdirs()
            }
            val sicilyDirPath = cameraDir.absolutePath + File.separator + "MyTest"
            val sicilyDir = File(sicilyDirPath)
            if (!sicilyDir.exists()) {
                sicilyDir.mkdirs()
            }
            val finalPath = sicilyDir.absolutePath + File.separator + file.name
            val values = ContentValues()
            values.put(MediaStore.Images.Media.DISPLAY_NAME, file.name)
            values.put(MediaStore.Images.Media.DATA, finalPath)
            Log.i(TAG, "moveToAlbum: $finalPath")
            val uri = contentResolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values) ?: return false
            try {
                val outputStream = contentResolver.openOutputStream(uri)?: return false
                val fileInputStream = FileInputStream(file)
                FileUtil.copyFileStream(fileInputStream, outputStream)
                fileInputStream.close()
                outputStream.close()
                val outputFile = File(finalPath)
                val contentValues = ContentValues()
                contentValues.put(MediaStore.Images.Media.SIZE, outputFile.length())
                contentResolver.update(uri, contentValues, null, null)
                // 通知媒体库更新
                val intent = Intent(@Suppress("DEPRECATION") Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, uri)
                sendBroadcast(intent)
                file.delete()
                return true
            } catch (e: IOException) {
                e.printStackTrace()
                return false
            }
        }
    }

    override fun onDestroy() {
        super.onDestroy()
        disposable?.dispose()
    }

    companion object {
        private const val TAG = "ImageDownloadActivity"
    }
}

4.2 布局文件

对应的布局文件：activity_image_download.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".imagedownload.ImageDownloadActivity">

    <ImageView
        android:id="@+id/imageView1"
        android:layout_width="200dp"
        android:layout_height="200dp"
        android:scaleType="centerCrop"
        android:background="#B3807D7D"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.498"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.077" />

    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:onClick="startDownload"
        android:text="下载"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/imageView1" />

</androidx.constraintlayout.widget.ConstraintLayout>

5. 总结

本文我们介绍了一个下载网络图片显示并保存到系统相册的完整小案例，涉及了网络请求、文件下载、动态权限申请、文件保存、移动到系统相册，包含了一些关键实用的知识点：

  • Retrofit 网络请求
  • RxJava 处理网络数据流
  • 动态权限申请
  • 文件保存IO操作
  • ContentResolver 移动文件到系统相册

希望这篇文章能帮到你，欢迎支持，感谢！

子林Android
关注
专栏目录
Android加载网络图片并保存到系统相册
奥帕斯特李立理与鲤的博客
04-03 1273
加载网络图片并点击保存图片到系统相册 1.首先在清单文件上加入相关权限 <!--网络--> <uses-permission android:name="android.permission.INTERNET" /> <!-- 读写文件 --> <uses-permission android:name="android.pe...
26.Android 下载图片保存到相册
Save you from anything
10-20 1万+
26.Android 下载图片保存到相册Android 下载图片保存到相册 前言 实现思路 自定义Dialog 自定义Handler 自定义AsyncTask AndroidManifest配置权限 DownloadImageToGalleryActivity 效果图 源码传送门前言有遇到没有这样的一种需求：浏览的大图后，点击保存下载高清原图到相册的需求。现在的图片缓存大多都是Universal-I
Android 下载网络图片保存到本地
weixin_34413802的博客
12-30 406
通过网络地址获取网络图片，点击下载将图片显示出来，然后点击图片将图片保存到本地。 首先需要在manifest上添加一些权限： [java] view plain copy &lt;!-- 访问网络的权限 --&gt;   &lt;uses-permission android:name="android.permission.INTERNET" /&gt;   &lt;!-- 文件读...
Android 下载图片保存到相册
10-20
DownLoadImageToGallery: Android 下载图片保存到相册
android 下载图片到相册
北京流年
09-07 524
        识别图片格式      BitmapFactory.Options options = new BitmapFactory.Options(); options.inJustDecodeBounds = true; BitmapFactory.decodeFile(mFile.getAbsolutePath(), options); String type = ...
Android异步下载图片并且缓存图片到本地
weixin_30879833的博客
03-09 99
Android异步下载图片并且缓存图片到本地 在Android开发中我们经常有这样的需求，从服务器上下载xml或者JSON类型的数据，其中包括一些图片资源，本demo模拟了这个需求，从网络上加载XML资源，其中包括图片，我们要做的解析XML里面的数据，并且把图片缓存到本地一个cache目录里面，并且用一个自定义的Adapter去填充到LIstView，demo运行效果见下图： ...
Android保存图片到相册，兼容Android10及以上版本
最新发布
唐诺
06-28 7008
Android共享存储空间操作；Android访问共享存储空间中的媒体文件；
Android 安卓将网络图片保存到相册
01-03
Android 安卓将网络图片保存到相册 封装了一个工具类！ 请先加上读写权限: 如果是Android6.0之后，加上权限后再动态申请权限 if (Build.VERSION.SDK_INT > Build.VERSION_CODES.LOLLIPOP) { if (ActivityCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(th
Android打开相机和相册实例代码
09-01
`OtherUtils.createFile()`是自定义的方法，用于创建一个临时文件，相机拍摄的照片将被保存到这个文件中。 当用户拍摄完照片后，系统会调用`onActivityResult()`方法，我们在这里处理返回的结果： ```java @...
Android拍照-相册图片选择-截图-上传图片案例源码
09-01
在Android应用开发中，用户与图片的交互是常见的功能需求，包括从相册选择图片、拍照获取图片、屏幕截图以及将这些图片上传到服务器。这个案例源码涵盖了这些关键点，下面将详细解释每个环节涉及的技术点。 1. **...
Android开发网络图片保存到本地指定文件夹
03-01
将请求网络图片转换为bitmap,然后保存到指定文件夹，压缩图片代码，使用了Glide来进行图片压缩处理。
Android 下载网络图片并显示到本地
01-06
Android下载网络图片的流程是： 发送网络请求->将图片以流的形式下载下来->将流转换为Bitmap并赋给ImageView控件。 注意点 最新的Android系统不可以在主线程上请求网络，需要使用线程来请求 下载图片属于耗时任务，最优做法是放在一个AsyncTask中操作 设计思路 1.网络请求:该例中需要下载的文件类型是图片类型，可以将网络请求获取的数据类型转换为Bitmap已供ImageView直接使用，但是一个合理的网络请求类的设计是将下载的数据类型转换为最基本的InputStream，这样不管是下载图片，音频，文本还是视频，都可以将结果抛出去让上层的逻辑来处理。 2.异步
android网络下载图片，并且显示在图库
08-13
这里是android开发的demo，从网上下在图片显示在ImageView中，并且在途库中国也显示。
android应用，附带源码和apk，并有详细注释，相册，网络下载
08-16
本资源提供了一个完整的Android应用示例，包含了源代码、apk安装包以及详细的注释，旨在帮助初学者理解和掌握Android应用的基本构建块。下面将详细探讨这个应用的主要功能及其背后的编程原理。 首先，我们关注的是...
AS项目：安卓调用系统相机拍照案例（可打开相册选择相片）
09-15
在安卓应用开发中，调用系统相机拍照是一个常见的功能需求，允许用户拍摄照片并将其集成到应用程序中。本文将深入探讨如何实现这个功能，并提供一个实际案例，即“AS项目：安卓调用系统相机拍照案例（可打开相册选择...
Android 自定义本地相册的功能，可以多选图片用-IT计算机-毕业设计.zip
04-05
在Android应用开发中，自定义本地相册的功能是一项常见的需求，尤其在涉及到用户选择多张图片的场景下，如社交应用、图片编辑应用等。这个毕业设计项目提供了一个实现这一功能的示例代码，帮助开发者深入理解Android...
Android下载网络图片并保存在本地相册中
shenggaofei的博客
11-03 9453
package com.thfund.bigtree.StarCounselor.activity; import android.content.Context; import android.content.Intent; import android.graphics.Bitmap; import android.graphics.BitmapFactory; import a...
Android 保存图片到手机相册
热门推荐
QingSheng的博客
12-07 2万+
有一种很常见的需求，当保存图片的时候，客户需要在相册里面看到那张图片。有时候确实是保存成功了（通过IO流将图片写入了SDCard），但打开相册却看不到那张图片，需要在文件管理软件上才能找到那张图片，在网上找了许多文章，貌似都保存不到相册那里，这应该就是手机品牌的原因，有的品牌的手机能显示在相册里，有的品牌的手机却不能。解决这种问题，最简单粗暴的方法是，用那台手机拍一张照片，然后找到它，查看它的路径详
android 保存网络图片到相册
05-12
Android平台上，我们可以通过代码来实现将网络图片保存到本地相册的功能。具体实现过程如下： 1. 获取需要下载的图片链接。 2. 创建一个异步任务，利用HTTPURLConnection或者OKHttp框架下载图片。 3. 下载完成后，将图片转换成Bitmap对象。 4. 申请写入文件的权限，并判断SD卡是否可用。 5. 使用File对象创建一个图片文件。 6. 利用FileOutputStream将Bitmap对象写入图片文件中。 7. 刷新相册，确保新添加的图片能够被相册所识别。 至此，保存网络图片到相册的功能已经完成。 以下是实现代码： ```java private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> { protected Bitmap doInBackground(String... urls) { String url = urls[0]; Bitmap bitmap = null; try { URL imageURL = new URL(url); HttpURLConnection conn = (HttpURLConnection) imageURL.openConnection(); conn.setDoInput(true); conn.connect(); InputStream is = conn.getInputStream(); bitmap = BitmapFactory.decodeStream(is); is.close(); } catch (IOException e) { e.printStackTrace(); } return bitmap; } protected void onPostExecute(Bitmap result) { if (result != null) { // 申请写入文件的权限 if (ActivityCompat.checkSelfPermission(MainActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1); return; } // 判断sd卡是否可用 if(Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) { // 创建图片文件 File imageFile = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM), "image_test.jpg"); try { // 将Bitmap对象写入图片文件中 FileOutputStream outputStream = new FileOutputStream(imageFile); result.compress(Bitmap.CompressFormat.JPEG, 100, outputStream); // 100表示压缩率，即不压缩 outputStream.flush(); outputStream.close(); // 刷新相册以便查看新添加的图片 Intent intent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE); Uri uri = Uri.fromFile(imageFile); intent.setData(uri); MainActivity.this.sendBroadcast(intent); Toast.makeText(MainActivity.this, "图片已保存到相册", Toast.LENGTH_SHORT).show(); } catch (IOException e) { e.printStackTrace(); } } else { Toast.makeText(MainActivity.this, "sd卡不可用", Toast.LENGTH_SHORT).show(); } } else { Toast.makeText(MainActivity.this, "下载失败", Toast.LENGTH_SHORT).show(); } } } ``` 在使用时，只需创建一个DownloadImageTask对象，调用execute方法即可： ```java DownloadImageTask downloadImageTask = new DownloadImageTask(); downloadImageTask.execute("http://www.example.com/image.jpg"); ```
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

子林Android

感谢老板，老板大气！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值