Android Widget显示外部存储最新照片失败（疑似Context问题）

我之前碰到过一模一样的情况，核心问题其实出在Widget的跨进程特性和RemoteViews的限制上，不是单纯的Context权限问题，咱们一步步来解决：

问题根源分析 #

1. 跨进程Bitmap传输限制：Widget运行在系统的AppWidgetHost进程（比如Launcher进程），当你用setImageViewBitmap传递Bitmap时，需要通过Binder跨进程传输，但Binder有严格的大小限制（一般在1MB左右），稍微大一点的照片Bitmap就会传输失败，导致ImageView显示空框架。
2. 分区存储的路径访问限制：如果你的应用目标SDK是29（Android 10）及以上，直接通过DATA列的文件路径调用BitmapFactory.decodeFile会被系统限制，即使你申请了存储权限也不行，这也是导致Bitmap加载失败的原因之一。

最优解决方案：用Content Uri替代直接传递Bitmap #

这种方式既规避了跨进程传输的限制，又符合Android的存储规范，步骤如下：

1. 修改PhotosReader类，返回照片的Content Uri

我们不再直接加载Bitmap，而是获取最新照片的MediaStore Content Uri：

import android.content.Context;
import android.database.Cursor;
import android.net.Uri;
import android.provider.MediaStore;
import android.content.ContentUris;

public class PhotosReader {
    public PhotosReader() { }

    public Uri getLatestPhotoUri(Context context) {
        String[] projection = new String[]{
                MediaStore.Images.ImageColumns._ID,
                MediaStore.Images.ImageColumns.DATE_TAKEN
        };

        Cursor cursor = context.getContentResolver().query(
                MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                projection,
                null,
                null,
                MediaStore.Images.ImageColumns.DATE_TAKEN + " DESC"
        );

        Uri photoUri = null;
        if (cursor != null && cursor.moveToFirst()) {
            // 通过照片ID生成Content Uri
            long photoId = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Images.ImageColumns._ID));
            photoUri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, photoId);
            cursor.close(); // 务必关闭Cursor，避免内存泄漏
        }
        return photoUri;
    }
}

2. 在WidgetProvider中使用setImageViewUri设置图片

用Uri替代Bitmap传递给RemoteViews，系统会自动在Widget进程中加载图片：

// 获取RemoteViews实例
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.app_widget);
PhotosReader PR = new PhotosReader();
Uri latestPhotoUri = PR.getLatestPhotoUri(context);

if (latestPhotoUri != null) {
    views.setImageViewUri(R.id.imageView, latestPhotoUri);
}

// 更新Widget
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
appWidgetManager.updateAppWidget(appWidgetId, views);

备选方案：压缩Bitmap后传递（仅适合必须处理Bitmap的场景） #

如果你确实需要先处理Bitmap（比如裁剪、滤镜），可以先压缩Bitmap到Binder允许的大小，再传递：

public Bitmap getCompressedBitmap(Context context, int maxSideSize) {
    String[] projection = new String[]{
            MediaStore.Images.ImageColumns.DATA,
            MediaStore.Images.ImageColumns.DATE_TAKEN
    };

    Cursor cursor = context.getContentResolver().query(
            MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
            projection,
            null,
            null,
            MediaStore.Images.ImageColumns.DATE_TAKEN + " DESC"
    );

    Bitmap compressedBitmap = null;
    if (cursor != null && cursor.moveToFirst()) {
        String filePath = cursor.getString(0);
        BitmapFactory.Options options = new BitmapFactory.Options();
        
        // 先获取图片尺寸，不加载Bitmap到内存
        options.inJustDecodeBounds = true;
        BitmapFactory.decodeFile(filePath, options);
        
        // 计算压缩比例，确保最大边长不超过设定值
        int scale = 1;
        while (options.outWidth / scale >= maxSideSize 
               && options.outHeight / scale >= maxSideSize) {
            scale *= 2;
        }
        
        // 加载并压缩Bitmap
        options.inJustDecodeBounds = false;
        options.inSampleSize = scale;
        compressedBitmap = BitmapFactory.decodeFile(filePath, options);
        
        cursor.close();
    }
    return compressedBitmap;
}

然后在Widget中调用：

Bitmap bitmap = PR.getCompressedBitmap(context, 200); // 压缩到最大边长200px
if (bitmap != null) {
    views.setImageViewBitmap(R.id.imageView, bitmap);
}

额外注意事项 #

• 权限适配：Android 13及以上需要申请READ_MEDIA_IMAGES权限，而不是READ_EXTERNAL_STORAGE。
• Cursor管理：任何时候使用Cursor后都要关闭，避免内存泄漏。

内容的提问来源于stack exchange，提问作者Patroy