Xamarin.Forms Android 12及以上版本字节图片存图库不显示的问题

问题根源分析 #

• 第一次尝试的问题：你写入的/Android/data/...路径属于应用的私有外部存储目录，从Android 10（API 29）开始，系统限制媒体库索引该目录下的文件，就算调用MediaScannerConnection.ScanFile也无法让图库识别这些文件。
• 第二次尝试的问题：GetExternalStoragePublicDirectory在Android Q+已被废弃，且在分区存储机制下，直接写入公共Pictures目录需要额外的MANAGE_EXTERNAL_STORAGE权限，仅靠广播扫描无法触发媒体库正确索引。

正确解决方案（适配Android 10+） #

方法1：使用MediaStore插入图片（推荐，无需特殊权限） #

通过MediaStore将图片信息插入系统媒体库，图库会直接识别到文件：

using Android.Content;
using Android.OS;
using Android.Provider;
using System;
using System.IO;

public void SaveImageToGallery(byte[] imageBytes, string fileName)
{
    ContentValues values = new ContentValues();
    values.Put(MediaStore.Images.ImageColumns.DisplayName, fileName);
    values.Put(MediaStore.Images.ImageColumns.MimeType, "image/jpeg");
    
    // 适配Android Q及以上的分区存储
    if (Build.VERSION.SdkInt >= BuildVersionCodes.Q)
    {
        values.Put(MediaStore.Images.ImageColumns.RelativePath, "Pictures/MyAlbum");
        values.Put(MediaStore.Images.ImageColumns.IsPending, 1);
    }
    else
    {
        // 低版本直接指定公共目录路径
        string directoryPath = Path.Combine(Environment.GetExternalStoragePublicDirectory(Environment.DirectoryPictures).AbsolutePath, "MyAlbum");
        Directory.CreateDirectory(directoryPath);
        string filePath = Path.Combine(directoryPath, fileName);
        values.Put(MediaStore.Images.ImageColumns.Data, filePath);
    }

    // 插入媒体库记录
    Uri uri = Application.Context.ContentResolver.Insert(MediaStore.Images.Media.ExternalContentUri, values);
    
    // 写入图片字节数据
    using (Stream outputStream = Application.Context.ContentResolver.OpenOutputStream(uri))
    {
        outputStream.Write(imageBytes, 0, imageBytes.Length);
    }

    // Android Q+标记文件为已完成
    if (Build.VERSION.SdkInt >= BuildVersionCodes.Q)
    {
        values.Clear();
        values.Put(MediaStore.Images.ImageColumns.IsPending, 0);
        Application.Context.ContentResolver.Update(uri, values, null, null);
    }
}

方法2：兼容Android 9及以下（仅旧版本可用） #

如果你的应用只需要兼容Android 9（API 28）及更低版本，可以保留私有存储路径写法，但要确保权限齐全且扫描路径正确：

string filePath = "/storage/emulated/0/Android/data/com.companyname.appname/files/Pictures/MyAlbum/downloaded_image_223213a3as.jpg";
File.WriteAllBytes(filePath, imageBytes);
// 必须传入正确的文件路径和MIME类型
MediaScannerConnection.ScanFile(Application.Context, new string[] { filePath }, new string[] { "image/jpeg" }, null);

注意：该方法在Android 10+完全无效，因为私有存储目录无法被媒体库索引。

关键注意事项 #

• Android 10及以上必须遵守分区存储规则，优先使用MediaStore API，不要直接写入公共目录。
• 避免使用已废弃的GetExternalStoragePublicDirectory方法，防止高版本系统出现兼容性问题。

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