將任意 View (含 ListView、RecyclerView、自定義繪圖 View) 截圖並儲存為 JPEG/PNG,且可控制輸出畫質,是分享生成圖、長圖拼接、離線快取的常見需求。本文提供完整、可生產環境使用的截圖工具方法。
public class ViewScreenshotUtils {
/**
* 將 View 繪製到 Bitmap 並儲存為檔案
* @param view 目標 View (需已完成 layout,寬高 > 0)
* @param filePath 輸出檔案完整路徑
* @param format CompressFormat.JPEG 或 PNG
* @param quality JPEG 品質 0-100 (PNG 忽略此參數)
* @return true 成功,false 失敗
*/
public static boolean saveViewAsImage(View view, String filePath,
Bitmap.CompressFormat format, int quality) {
if (view == null || view.getWidth() == 0 || view.getHeight() == 0) {
Log.e("Screenshot", "View 未佈局完成或尺寸為 0");
return false;
}
// 1. 建立對應尺寸的 Bitmap (ARGB_8888 保留透明通道)
Bitmap bitmap = Bitmap.createBitmap(view.getWidth(), view.getHeight(), Bitmap.Config.ARGB_8888);
Canvas canvas = new Canvas(bitmap);
// 2. 將 View 繪製到 Canvas (包含背景、子 View、滾動位置)
view.draw(canvas);
// 3. 儲存檔案
File file = new File(filePath);
try {
File parent = file.getParentFile();
if (parent != null && !parent.exists()) parent.mkdirs();
FileOutputStream fos = new FileOutputStream(file);
bitmap.compress(format, quality, fos);
fos.flush();
fos.close();
return true;
} catch (IOException e) {
Log.e("Screenshot", "儲存失敗", e);
return false;
} finally {
if (!bitmap.isRecycled()) bitmap.recycle(); // 及時釋放原生記憶體
}
}
/**
* 截取可滾動 View (ScrollView, RecyclerView, ListView) 完整內容長圖
* 原理:暫時關閉滾動、測量完整高度、建立大 Bitmap、手動 dispatchDraw
*/
public static Bitmap captureScrollView(View scrollView) {
// 僅示意核心邏輯,完整版需處理滾動位置還原、硬體加速關閉等細節
// 生產環境建議使用成熟庫:https://github.com/Blankj/AndroidUtilCode/blob/master/lib/utilcode/src/main/java/com/blankj/utilcode/util/ScreenUtils.java
return null;
}
}
// 在按鈕點擊或分享動作中呼叫
Button btnSave = findViewById(R.id.btn_save);
btnSave.setOnClickListener(v -> {
View targetView = findViewById(R.id.content_container); // 任意容器 View
String path = getExternalFilesDir(Environment.DIRECTORY_PICTURES) + "/share_" + System.currentTimeMillis() + ".jpg";
// 背景執行緒執行,避免主執行緒卡頓
Executors.newSingleThreadExecutor().execute(() -> {
boolean success = ViewScreenshotUtils.saveViewAsImage(targetView, path, Bitmap.CompressFormat.JPEG, 90);
runOnUiThread(() -> {
if (success) {
Toast.makeText(this, "已儲存至相簿", Toast.LENGTH_SHORT).show();
// 發送媒體掃描廣播讓相簿立即顯示
MediaScannerConnection.scanFile(this, new String[]{path}, null, null);
} else {
Toast.makeText(this, "截圖失敗", Toast.LENGTH_SHORT).show();
}
});
});
});
| 問題 | 原因 | 解決方案 |
|---|---|---|
| 截圖為空白/黑屏 | View 開啟硬體加速,Canvas 無法正確繪製 | view.setLayerType(View.LAYER_TYPE_SOFTWARE, null) 截圖前關閉,截圖後恢復 |
| RecyclerView/ListView 僅截可見區域 | View 實際寬高僅為螢幕可見範圍 | 使用 captureScrollView 邏輯:測量完整高度、建立大 Bitmap、手動 dispatchDraw |
| Bitmap OOM | 長圖過大超過記憶體限制 | 分塊截圖拼接、降低採樣率、使用 inBitmap 重用、或改用 Picture 錄製繪圖指令 |
| 儲存無權限 | Android 10+ 分區儲存限制 | 使用 getExternalFilesDir() (應用專屬目錄,無需權限) 或 MediaStore 插入媒體庫 |
| 透明背景變黑 | JPEG 不支援透明,預設填黑 | 需透明背景請用 PNG;或預先在 Canvas 繪製白色底色 |
手寫截圖工具易踩坑,正式專案建議直接引用成熟庫:
implementation 'com.blankj:utilcodex:1.30.9',一鍵 ScreenUtils.captureView(view)、ScreenUtils.captureScrollView(recyclerView)。