原生移动开发 / 系统课时
本地与网络图片加载
本地与网络图片加载
Android 图片加载的关键不是“把地址塞给 ImageView”,而是先判断图片来源。本课用一个最小示例区分 drawable 资源、android.resource URI 与 HTTPS 图片,并说明线程、权限、占位图和失败回退各自应该放在哪里。
学习目标
- 能使用资源 ID 与资源 URI 显示本地 drawable
- 能在后台线程下载网络图片并回到主线程更新
ImageView - 能区分教学级网络加载与生产图片库的职责边界
本地 drawable 与资源 URI
放在 res/drawable 的图片会被编译成资源 ID,最直接的加载方式是 setImageResource()。当某个接口必须接收 URI 时,可以把资源写成 android.resource://包名/资源ID,或者 android.resource://包名/类型/名称。
需要特别区分:资源 URI 仍然指向 APK 内的本地资源,它不是文件路径,也不是网络地址。ImageView.setImageURI() 适合本地 URI;它不会替你完成 HTTP 下载。
下面的完整 Activity 使用 Android 自带 drawable,因而不需要额外准备图片文件,同时演示资源 ID 和资源 URI 两种写法。
package com.example.imageloading
import android.graphics.BitmapFactory
import android.net.Uri
import android.os.Bundle
import android.view.Gravity
import android.view.ViewGroup
import android.widget.ImageView
import android.widget.LinearLayout
import androidx.appcompat.app.AppCompatActivity
import java.io.IOException
import java.net.HttpURLConnection
import java.net.URL
import java.util.concurrent.Executors
class MainActivity : AppCompatActivity() {
private val executor = Executors.newSingleThreadExecutor()
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val root = LinearLayout(this).apply {
orientation = LinearLayout.VERTICAL
gravity = Gravity.CENTER
setPadding(32, 32, 32, 32)
}
val localImage = ImageView(this).apply { adjustViewBounds = true }
val networkImage = ImageView(this).apply { adjustViewBounds = true }
root.addView(
localImage,
LinearLayout.LayoutParams(
ViewGroup.LayoutParams.MATCH_PARENT,
360
)
)
root.addView(
networkImage,
LinearLayout.LayoutParams(
ViewGroup.LayoutParams.MATCH_PARENT,
360
)
)
setContentView(root)
// 资源 ID 适合应用自己直接引用 drawable。
localImage.setImageResource(android.R.drawable.ic_menu_gallery)
// 资源 URI 适合必须通过 URI 传递本地资源的接口。
val resourceUri = Uri.parse(
"android.resource://android/${android.R.drawable.ic_menu_gallery}"
)
localImage.setImageURI(resourceUri)
loadNetworkImage("https://httpbin.org/image/png", networkImage)
}
private fun loadNetworkImage(urlString: String, target: ImageView) {
target.setImageResource(android.R.drawable.ic_popup_sync)
executor.execute {
val result = runCatching {
val connection = URL(urlString).openConnection() as HttpURLConnection
try {
connection.connectTimeout = 5_000
connection.readTimeout = 5_000
connection.requestMethod = "GET"
if (connection.responseCode !in 200..299) {
throw IOException("HTTP ${connection.responseCode}")
}
connection.inputStream.use { input ->
BitmapFactory.decodeStream(input)
?: error("无法解码图片")
}
} finally {
connection.disconnect()
}
}
runOnUiThread {
if (isFinishing || isDestroyed) return@runOnUiThread
result.onSuccess { bitmap ->
target.setImageBitmap(bitmap)
}.onFailure {
target.setImageResource(android.R.drawable.stat_notify_error)
}
}
}
}
override fun onDestroy() {
executor.shutdownNow()
super.onDestroy()
}
}预期结果
上方 ImageView 显示本地系统 drawable。
下方 ImageView 先显示加载占位图;网络请求成功后显示 PNG。
断网、超时或返回非 2xx 状态码时,下方 ImageView 显示错误图标。允许应用访问网络
网络加载还需要在 AndroidManifest.xml 中声明联网权限。下面是片段示例,把权限放在 <application> 外层。
<uses-permission android:name="android.permission.INTERNET" />这项权限属于普通权限,不会弹运行时授权框。重新运行应用后,如果网络图片能正常显示,说明权限、HTTPS 请求与图片解码链路都已经生效。
生产项目不要手写完整图片管线
上面的网络代码用于看清“后台下载 → 解码 Bitmap → 主线程更新 View”的最小机制。真实应用通常还需要内存缓存、磁盘缓存、请求去重、生命周期取消、缩略图、变换与大图采样,这些都不应该在业务页面中重复实现。
生产项目应优先使用 Coil、Glide 等成熟图片库,让页面只负责声明 URL、占位图和错误图。无论使用哪种库,都保留同一个判断原则:本地 drawable 用资源机制,资源 URI 用于本地 URI 接口,HTTPS 图片交给具备异步、缓存和生命周期管理能力的网络图片加载器。