Android 大图片加载解决方案：避免内存溢出，高效显示大图到 ImageView

E/AndroidRuntime: FATAL EXCEPTION: main
    java.lang.IllegalStateException: Could not execute method of activity
    ...
    Caused by: java.lang.OutOfMemoryError: Failed to allocate a ... byte allocation with ... free bytes

<LinearLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center">

    <!-- 用于显示大图片的 ImageView -->
    <ImageView
        android:id="@+id/iv_large_image"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:scaleType="fitCenter" <!-- 图片按比例缩放，居中显示 -->
        android:contentDescription="@string/app_name" />

</LinearLayout>

import android.app.Activity;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.graphics.Point;
import android.os.Bundle;
import android.view.WindowManager;
import android.widget.ImageView;

public class MainActivity extends Activity {
    private ImageView ivLargeImage;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 1. 初始化 ImageView
        ivLargeImage = findViewById(R.id.iv_large_image);

        // 2. 加载大图片（SD 卡中的图片路径，需替换为实际路径）
        String largeImagePath = "/mnt/sdcard/2.jpg"; // 示例路径：SD 卡根目录的 2.jpg
        loadLargeImage(largeImagePath);
    }

    /**
     * 加载大图片的核心方法：按屏幕尺寸缩放图片，避免内存溢出
     * @param imagePath 图片在 SD 卡中的路径
     */
    private void loadLargeImage(String imagePath) {
        // 步骤 1：获取当前屏幕的宽高（替代过时的 getWidth()/getHeight()）
        WindowManager windowManager = getWindowManager();
        Point screenSize = new Point();
        windowManager.getDefaultDisplay().getSize(screenSize);
        int screenWidth = screenSize.x; // 屏幕宽度
        int screenHeight = screenSize.y; // 屏幕高度

        // 步骤 2：仅读取图片头信息，不加载完整图片（避免内存占用）
        BitmapFactory.Options options = new BitmapFactory.Options();
        options.inJustDecodeBounds = true; // 开启“仅读头信息”模式
        // 调用 decodeFile 读取图片信息（此时返回的 bitmap 为 null，仅填充 options）
        BitmapFactory.decodeFile(imagePath, options);

        // 步骤 3：计算图片的缩放比例
        int imageOriginalWidth = options.outWidth; // 图片原始宽度
        int imageOriginalHeight = options.outHeight; // 图片原始高度
        int scaleRatio = 1; // 默认缩放比例（1 表示不缩放）

        // 计算水平和垂直方向的缩放比例（取较大值，确保图片完全适配屏幕）
        int scaleRatioWidth = imageOriginalWidth / screenWidth; // 水平方向缩放比例
        int scaleRatioHeight = imageOriginalHeight / screenHeight; // 垂直方向缩放比例

        // 确定最终缩放比例：若图片宽高均超过屏幕，取较大的缩放比例；若未超过，不缩放
        if (scaleRatioWidth > scaleRatioHeight && scaleRatioHeight > 1) {
            scaleRatio = scaleRatioWidth; // 水平方向超出更多，按水平比例缩放
        } else if (scaleRatioHeight > scaleRatioWidth && scaleRatioWidth > 1) {
            scaleRatio = scaleRatioHeight; // 垂直方向超出更多，按垂直比例缩放
        }

        // 步骤 4：按缩放比例加载图片（此时才真正解析图片）
        options.inJustDecodeBounds = false; // 关闭“仅读头信息”模式
        options.inSampleSize = scaleRatio; // 设置缩放比例
        Bitmap scaledBitmap = BitmapFactory.decodeFile(imagePath, options); // 加载缩放后的图片

        // 步骤 5：将缩放后的图片显示到 ImageView
        ivLargeImage.setImageBitmap(scaledBitmap);
    }

    /**
     * 优化：Activity 销毁时回收 Bitmap 内存，避免内存泄漏
     */
    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 获取 ImageView 中的 Bitmap 并回收
        Bitmap bitmap = ((BitmapDrawable) ivLargeImage.getDrawable()).getBitmap();
        if (bitmap != null && !bitmap.isRecycled()) {
            bitmap.recycle(); // 回收 Bitmap 内存
        }
    }
}

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.loadlargeimage">

    <!-- 读取外部存储权限（加载 SD 卡图片需此权限） -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

    <application
        ...>
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

// 过时方法
int width = wm.getDefaultDisplay().getWidth();
// 推荐方法
Point screenSize = new Point();
wm.getDefaultDisplay().getSize(screenSize);
int screenWidth = screenSize.x;

// 检查并申请读取外部存储权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
        != PackageManager.PERMISSION_GRANTED) {
    // 未授权，发起申请
    ActivityResultContracts.RequestPermission requestPermission = new ActivityResultContracts.RequestPermission();
    registerForActivityResult(requestPermission, isGranted -> {
        if (isGranted) {
            // 权限申请成功，加载图片
            loadLargeImage("/mnt/sdcard/2.jpg");
        } else {
            // 权限被拒绝，提示用户
            Toast.makeText(this, "需开启存储权限才能加载图片", Toast.LENGTH_SHORT).show();
        }
    }).launch(Manifest.permission.READ_EXTERNAL_STORAGE);
} else {
    // 已授权，直接加载图片
    loadLargeImage("/mnt/sdcard/2.jpg");
}