安卓API29及以上如何实现类似WhatsApp的内部Media目录文件存储

根因说明 #

你当前代码中使用的getExternalFilesDir返回的是应用私有专属目录，API29及以上系统默认对其他应用（包括系统文件管理器）不可见，所以用户无法直接查看和删除。Android/media/应用包名是系统提供的媒体区应用专属目录，该目录默认对用户可见，无需申请特殊权限即可写入，完全匹配你的需求。

具体实现 #

1. 路径获取代码替换 #

将原有路径获取逻辑替换为如下代码即可：

String path = "";
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    // 直接获取系统分配的 Android/media/应用包名 路径
    File[] mediaDirs = context.getExternalMediaDirs();
    if (mediaDirs != null && mediaDirs.length > 0) {
        // 取内置存储对应的media目录
        path = mediaDirs[0].getAbsolutePath();
    } else {
        // 异常降级，走原有私有目录逻辑
        path = context.getExternalFilesDir(null).getAbsolutePath();
    }
} else {
    // Android 9及以下保持原有逻辑，也可自行拼接 Android/media/包名 路径写入
    path = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).getAbsolutePath();
}

2. 权限配置 #

在AndroidManifest.xml中添加如下权限，仅对Android 9及以下生效，API29及以上无需申请存储权限：

<uses-permission
    android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="28" />
<uses-permission
    android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="28" />

额外说明 #

• 你可以在获取到的media目录下新建子文件夹分类存储不同类型文件（比如Images、Videos、Documents），和WhatsApp的存储结构对齐，方便用户分类管理。
• 应用卸载时，该目录下的内容会被系统自动清除，如果需要文件在应用卸载后保留，可额外将文件插入系统公共媒体库即可。
• 该目录下的媒体文件会默认被系统媒体库扫描，用户可以直接在相册、视频类应用中查看到对应内容，和WhatsApp的表现完全一致。

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