Android 從 Assets 讀取圖片檔案完整實作

Assets 目錄適合存放應用打包時固定的資源檔（如預設圖片、設定檔、字型）。讀取方式需透過 AssetManager.open() 取得 InputStream，再經 BitmapFactory.decodeStream() 解碼為 Bitmap。注意資源路徑區分大小寫，且不支援子目錄遞迴列舉。

標準讀取流程

public Bitmap loadBitmapFromAssets(Context context, String fileName) {
    InputStream is = null;
    try {
        // 路徑相對於 assets 根目錄，如 "images/logo.png"
        is = context.getAssets().open(fileName);
        return BitmapFactory.decodeStream(is);
    } catch (IOException e) {
        Log.e("Assets", "Load bitmap failed: " + fileName, e);
        return null;
    } finally {
        if (is != null) {
            try { is.close(); } catch (IOException ignored) {}
        }
    }
}

使用範例

// 佈局檔
<ImageView
    android:id="@+id/ivLogo"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

// Activity/Fragment
ImageView ivLogo = findViewById(R.id.ivLogo);
Bitmap bitmap = loadBitmapFromAssets(this, "brand/logo.png");
if (bitmap != null) {
    ivLogo.setImageBitmap(bitmap);
}

進階優化建議

• 大圖採樣：使用 BitmapFactory.Options.inSampleSize 降低記憶體佔用，避免 OOM。
• 快取策略：常用圖片可載入後存入 LruCache 或磁碟快取，避免重複解碼。
• 非同步載入：大量或大尺寸圖片應在背景執行緒解碼，完成後回主執行緒更新 UI。
• WebP 格式：優先使用 WebP 替代 PNG/JPG，減小 APK 體積並加快解碼。

常見錯誤排查

善用 Assets 機制，能讓應用離線也能呈現豐富視覺資源，且不佔用內部儲存空間。