Android如何不依赖文件扩展名筛选静态/动态图片

核心约束对齐 #

实现设备最新图片展示、支持按动/静态类型筛选，判断逻辑不依赖文件扩展名，覆盖以下异常场景：

• 图片文件缺失扩展名
• webp格式同扩展名下存在动/静态两种类型
• 文件扩展名标注错误
  优先选择无第三方依赖、低耗时的实现路径，避免增大安装包体积。

现有参考代码的问题 #

你贴的实现存在两处基础错误：

• 查询列混用MediaStore.Video与MediaStore.Images常量，会触发列索引匹配异常
• 仅通过MIME类型筛选webp，完全无法区分同格式下的动/静态类型，也无法覆盖扩展名异常的文件

分版本最优实现方案 #

1. 高版本系统零成本实现（Android 10/API 29及以上） #

系统媒体扫描阶段已经完成了所有图片的动/静态识别，直接使用MediaStore.Images.Media.IS_ANIMATED字段即可：

• 字段值为1：匹配所有动图格式，包括GIF、动态webp、APNG
• 字段值为0：匹配所有静态图片格式，包括JPG、PNG、静态webp
  查询时直接把该字段加入查询列、作为筛选条件即可，完全不需要自行做文件检测，零额外耗时，判断结果和系统相册保持一致。

2. 低版本系统优化检测方案（API 29以下） #

不要直接全量读文件头检测，先做粗筛把待检测文件量压缩到最小：

• 第一轮通过MIME_TYPE粗筛：image/gif、image/apng直接归为动图；image/jpeg直接归为静态图；仅剩下image/webp、MIME类型为空/异常的文件需要进入二次检测
• 二次检测仅读文件前64字节即可完成判断，不需要加载完整文件，单文件检测耗时<1ms：
  • webp格式：偏移12字节位置查找ANIM标识，存在即为动态webp
  • PNG格式：文件头匹配PNG固定标识89 50 4E 47 0D 0A 1A 0A后，查找acTL块标识，存在即为APNG动图
  • 其他格式：结合MIME类型判断即可，不存在同扩展名混杂动/静态的情况
    如果不想自行写文件头匹配逻辑，可以用系统自带的BitmapFactory实现：给BitmapFactory.Options设置inJustDecodeBounds = true，仅读取图片元数据不加载位图内容，无额外内存占用，API 28及以上可直接读取outAnimated字段获取动图标记，兼容性比自行匹配文件头更好，无额外依赖。

耗时优化技巧 #

• 分页检测：按DATE_ADDED倒序分页加载，仅检测当前页面需要展示的图片，用户滑动到下一页时再做对应检测，避免启动时全量扫描
• 结果缓存：把已检测的图片uri、对应动/静态类型做本地持久化缓存，下次启动直接读取缓存，仅对新增的媒体文件做检测，完全消除重复检测耗时
• 线程调度：所有检测逻辑放到IO线程池执行，配合列表预加载机制，用户完全感知不到检测过程

修正后的基础实现代码 #

private static final String[] IMAGE_QUERY_COLUMNS;
static {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        IMAGE_QUERY_COLUMNS = new String[]{
                MediaStore.Images.Media._ID,
                MediaStore.Images.Media.DATA,
                MediaStore.Images.Media.DISPLAY_NAME,
                MediaStore.Images.Media.SIZE,
                MediaStore.Images.Media.WIDTH,
                MediaStore.Images.Media.HEIGHT,
                MediaStore.Images.Media.DATE_ADDED,
                MediaStore.Images.Media.IS_ANIMATED
        };
    } else {
        IMAGE_QUERY_COLUMNS = new String[]{
                MediaStore.Images.Media._ID,
                MediaStore.Images.Media.DATA,
                MediaStore.Images.Media.DISPLAY_NAME,
                MediaStore.Images.Media.SIZE,
                MediaStore.Images.Media.WIDTH,
                MediaStore.Images.Media.HEIGHT,
                MediaStore.Images.Media.DATE_ADDED
        };
    }
}

public void queryImages(Context context, boolean showAnimatedOnly) {
    ContentResolver contentResolver = context.getContentResolver();
    String sortOrder = MediaStore.Images.Media.DATE_ADDED + " DESC";
    Cursor imageCursor = null;

    try {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            // 高版本直接通过系统字段筛选
            String selection = MediaStore.Images.Media.IS_ANIMATED + "=?";
            String[] selectionArgs = new String[]{showAnimatedOnly ? "1" : "0"};
            imageCursor = contentResolver.query(
                    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                    IMAGE_QUERY_COLUMNS,
                    selection,
                    selectionArgs,
                    sortOrder
            );
        } else {
            // 低版本先查询全部，后续配合粗筛+轻量检测+分页逻辑过滤
            imageCursor = contentResolver.query(
                    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                    IMAGE_QUERY_COLUMNS,
                    null,
                    null,
                    sortOrder
            );
        }

        if (imageCursor == null) return;
        int pathColumnIndex = imageCursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA);
        while (imageCursor.moveToNext()) {
            String imagePath = imageCursor.getString(pathColumnIndex);
            Log.d("loaded image path: ", imagePath);
            // 低版本场景此处补充轻量检测逻辑，结合缓存、分页处理即可
        }
    } finally {
        if (imageCursor != null) {
            imageCursor.close();
        }
    }
}

轻量依赖推荐 #

如果需要兼容更多特殊格式、不想自行维护文件头匹配逻辑，可以引入AndroidX官方的exifinterface库，该库体积仅几十KB，不会明显增大包体积，内置了全格式图片的元数据解析能力，可以直接读取动图标记。

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