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

文章目录

    • [1. 案例简介](#1. 案例简介)
      • [1.1 效果演示](#1.1 效果演示)
    • [2. 工程配置](#2. 工程配置)
    • [3. 网络层](#3. 网络层)
      • [3.1 网络接口定义](#3.1 网络接口定义)
      • [3.2 Retrofit工具类](#3.2 Retrofit工具类)
    • [4. 主界面及完整代码](#4. 主界面及完整代码)
      • [4.1 完整主界面代码 ImageDownloadActivity](#4.1 完整主界面代码 ImageDownloadActivity)
      • [4.2 布局文件](#4.2 布局文件)
    • [5. 总结](#5. 总结)

1. 案例简介

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

1.1 效果演示

2. 工程配置

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

groovy 复制代码
// 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,拼接上这里的相对路径就是完整的下载地址。

kotlin 复制代码
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 也由外界传入,可以创建多个不同的实例。

kotlin 复制代码
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

kotlin 复制代码
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 复制代码
<?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 移动文件到系统相册

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

相关推荐
liosen4 分钟前
【安卓笔记】OOM与内存优化
android·oom·内存优化·内存分析命令·内存分析工具
猿小蔡-Cool5 小时前
Android ADB命令之内存统计与分析
android·adb
Monkey-旭5 小时前
Android Handler 完全指南
android·java·handler
從南走到北6 小时前
JAVA东郊到家按摩服务同款同城家政服务按摩私教茶艺师服务系统小程序+公众号+APP+H5
android·java·开发语言·微信小程序·小程序
alexhilton7 小时前
学会用最优雅的姿式在Compose中显示富文本
android·kotlin·android jetpack
阿华的代码王国9 小时前
【Android】卡片式布局 && 滚动容器ScrollView
android·xml·java·前端·后端·卡片布局·滚动容器
风起云涌~9 小时前
【Android】桌面小组件开发
android·gitee
双鱼大猫11 小时前
从传统播放器到AI智能体:Xplayer 2.0的技术革新之路
android
CYRUS_STUDIO11 小时前
动态篡改 so 函数返回值:一篇带你玩转 Android Hook 技术!
android·c++·逆向
xzkyd outpaper11 小时前
Android中主线程、ActivityThread、ApplicationThread的区别
android·面试