如何在Android 10及以上版本中删除指定的截图文件？

核心问题根因 #

当应用 targetSdk 升级到30及以上时，分区存储规则完全生效，旧的WRITE_EXTERNAL_STORAGE权限不再能获得外部存储的写入/删除权限，同时requestLegacyExternalStorage属性会被系统直接忽略，无法回退到旧的存储访问模式。
截图文件属于系统媒体库统一管理的公共媒体资源，这类文件的删除操作不需要申请全量外部存储权限，通过系统提供的MediaStore接口即可完成全版本兼容的删除逻辑。

适配调整要点 #

• 权限配置层面：Android 9及以下版本保留原有WRITE_EXTERNAL_STORAGE申请逻辑即可；Android 10版本可保留requestLegacyExternalStorage="true"配置兼容旧逻辑；Android 11及以上版本无需申请全量存储权限，也无需开启旧存储模式。
• 文件操作层面：替换原有直接调用File.delete()的逻辑，通过MediaStore完成媒体文件的匹配、删除操作，系统会自动同步媒体库索引，无需手动发送媒体扫描广播。

改造后的删除代码 #

// 替换原有 new File(path) 直接执行删除的逻辑
ContentResolver resolver = getApplicationContext().getContentResolver();
Uri mediaUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;

// 通过文件绝对路径匹配MediaStore中对应的媒体记录
String selectionClause = MediaStore.Images.Media.DATA + " = ?";
String[] selectionArgs = new String[]{ path };

Cursor matchCursor = resolver.query(
        mediaUri,
        new String[]{MediaStore.Images.Media._ID},
        selectionClause,
        selectionArgs,
        null
);

if (matchCursor != null && matchCursor.moveToFirst()) {
    long mediaId = matchCursor.getLong(matchCursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
    matchCursor.close();

    // 构造对应媒体文件的可操作Uri
    Uri targetFileUri = ContentUris.withAppendedId(mediaUri, mediaId);
    // 执行删除
    int deleteResult = resolver.delete(targetFileUri, null, null);

    if (deleteResult > 0) {
        Log.i(TAG, "deleteTheFile: file deleted");
    } else {
        Log.i(TAG, "deleteTheFile: file not deleted");
    }
}

补充说明 #

• 针对非本应用创建的公共媒体文件（比如系统生成的截图），通过MediaStore发起删除操作时，系统会自动弹出一次性的用户授权弹窗，用户确认后即可完成删除，无需申请MANAGE_EXTERNAL_STORAGE这类高危全存储权限。
• 原有代码中手动发送的ACTION_MEDIA_SCANNER_SCAN_FILE广播在高版本系统上已失效，MediaStore的操作会自动完成媒体库的索引更新，不需要额外发送广播同步。

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