萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 4.0+ 網絡圖片加載:AsyncTask 異步加載實現與現代替代方案

背景:Android 4.0 網絡請求限制

Android 4.0 (API 14) 引入 StrictMode 預設禁止在主線程執行網絡 I/O 操作。直接在主線程加載網絡圖片會拋出 NetworkOnMainThreadException。必須在子線程下載圖片,再切回主線程設置到 ImageView。

AsyncTask 實現方案(經典寫法,API 30 棄用)

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);

AsyncTask 缺陷與棄用原因

  • 內存洩漏風險:非靜態內部類持有 Activity/View 引用,配置變更導致洩漏
  • 並發限制:默認串行執行(THREAD_POOL_EXECUTOR 可並行但管理複雜)
  • 生命週期無感知:Activity 銷毀後任務仍在運行,onPostExecute 更新已銷毀 View
  • API 30 棄用:官方建議遷移至 ExecutorService、RxJava、協程或 Jetpack 組件

現代最佳實踐方案對比

方案一:Glide / Picasso / Coil(強烈推薦)

成熟圖片加載庫,一行代碼解決所有問題:緩存、生命週期、佔位圖、變換、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)
}

方案二:Kotlin 協程 + 原生 API(輕量、無第三方依賴)

// 在 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)
        }
    }
}

方案三:ExecutorService + Handler(Java 現代化寫法)

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();
}

方案四:Jetpack Lifecycle + LiveData(架構組件方式)

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) }
}

圖片加載優化關鍵點(無論用何種方案)

  1. 壓縮采樣:BitmapFactory.Options.inSampleSize 按需縮放,避免 OOM
  2. 內存緩存:LruCache 緩存常用圖片
  3. 磁盤緩存:DiskLruCache 持久化緩存
  4. 生命週期感知:Activity/Fragment 銷毀自動取消請求
  5. 佔位/錯誤圖:提升用戶體驗
  6. 圖片變換:圓角、圓形、模糊、裁剪

總結建議

項目類型推薦方案理由
新項目 (Kotlin)Coil / Glide協程原生、API 簡潔、功能完整
新項目 (Java)Glide / Picasso成熟穩定、社區活躍
極簡項目/不想引入依賴協程 + 原生 / ExecutorService零依賴、可控性強
老項目維護按現狀優化,漸進遷移降低風險

核心原則: 生產環境請直接使用成熟圖片加載庫,不要重複造輪子。AsyncTask 僅作為歷史代碼理解和教學參考。

copyright © 萬盛學電腦網 all rights reserved