Android 4.0 (API 14) 引入 StrictMode 預設禁止在主線程執行網絡 I/O 操作。直接在主線程加載網絡圖片會拋出 NetworkOnMainThreadException。必須在子線程下載圖片,再切回主線程設置到 ImageView。
import android.graphics.Bitmap; import android.graphics.BitmapFactory; import android.os.AsyncTask; import android.util.Log; import android.widget.ImageView; import java.io.InputStream; import java.net.URL; public class DownloadImageTask extends AsyncTask{ private final ImageView imageView; private static final String TAG = "DownloadImageTask"; public DownloadImageTask(ImageView imageView) { this.imageView = imageView; } @Override protected Bitmap doInBackground(String... urls) { String url = urls[0]; Bitmap bitmap = null; try { InputStream inputStream = new URL(url).openStream(); bitmap = BitmapFactory.decodeStream(inputStream); } catch (Exception e) { Log.e(TAG, "圖片下載失敗: " + url, e); } return bitmap; } @Override protected void onPostExecute(Bitmap bitmap) { if (bitmap != null && imageView != null) { imageView.setImageBitmap(bitmap); } } }
String imageUrl = "https://www.baidu.com/img/baidu_logo.gif"; new DownloadImageTask((ImageView) findViewById(R.id.iv_image)).execute(imageUrl);
成熟圖片加載庫,一行代碼解決所有問題:緩存、生命週期、佔位圖、變換、GIF/WebP 支持。
// Glide (Java)
Glide.with(this)
.load("https://example.com/image.jpg")
.placeholder(R.drawable.placeholder)
.error(R.drawable.error)
.into(imageView);
// Coil (Kotlin 協程優先)
imageView.load("https://example.com/image.jpg") {
crossfade(true)
placeholder(R.drawable.placeholder)
error(R.drawable.error)
}
// 在 ViewModel 或 LifecycleScope 中調用
lifecycleScope.launch {
val bitmap = withContext(Dispatchers.IO) {
try {
URL("https://example.com/image.jpg").openStream().use { input ->
BitmapFactory.decodeStream(input)
}
} catch (e: Exception) {
null
}
}
if (bitmap != null) {
withContext(Dispatchers.Main) {
imageView.setImageBitmap(bitmap)
}
}
}
private final ExecutorService executor = Executors.newSingleThreadExecutor();
private final Handler mainHandler = new Handler(Looper.getMainLooper());
public void loadImage(String url, ImageView imageView) {
executor.execute(() -> {
Bitmap bitmap = null;
try (InputStream is = new URL(url).openStream()) {
bitmap = BitmapFactory.decodeStream(is);
} catch (IOException e) {
e.printStackTrace();
}
Bitmap finalBitmap = bitmap;
mainHandler.post(() -> {
if (finalBitmap != null) {
imageView.setImageBitmap(finalBitmap);
}
});
});
}
// Activity 銷毀時關閉線程池
@Override
protected void onDestroy() {
super.onDestroy();
executor.shutdown();
}
class ImageRepository {
fun loadImage(url: String): LiveData = liveData(Dispatchers.IO) {
try {
val bitmap = URL(url).openStream().use { BitmapFactory.decodeStream(it) }
emit(bitmap)
} catch (e: Exception) {
emit(null)
}
}
}
// ViewModel
class MainViewModel(repository: ImageRepository) : ViewModel() {
fun getImage(url: String): LiveData = repository.loadImage(url)
}
// Activity
viewModel.getImage(url).observe(this) { bitmap ->
bitmap?.let { imageView.setImageBitmap(it) }
}
BitmapFactory.Options.inSampleSize 按需縮放,避免 OOM| 項目類型 | 推薦方案 | 理由 |
|---|---|---|
| 新項目 (Kotlin) | Coil / Glide | 協程原生、API 簡潔、功能完整 |
| 新項目 (Java) | Glide / Picasso | 成熟穩定、社區活躍 |
| 極簡項目/不想引入依賴 | 協程 + 原生 / ExecutorService | 零依賴、可控性強 |
| 老項目維護 | 按現狀優化,漸進遷移 | 降低風險 |
核心原則: 生產環境請直接使用成熟圖片加載庫,不要重複造輪子。AsyncTask 僅作為歷史代碼理解和教學參考。