Flutter开发Android 30+应用无需MANAGE_EXTERNAL_STORAGE解压文件方案问询

核心原因 #

Android 11（API 30）开始强制启用分区存储机制，普通应用默认只能访问自身私有沙箱目录和公共存储的授权区域，直接读写外部存储根路径会触发权限拒绝，无需申请权限范围过大的android.permission.MANAGE_EXTERNAL_STORAGE即可实现需求。

可行解决方案 #

方案1：全链路使用应用私有目录（无需申请任何存储权限） #

将下载的压缩包、临时解压目录、最终存储目录全部放在应用私有沙箱内，是兼容性最高、权限要求最低的方案。

• Flutter端可通过path_provider包获取合法私有路径：
  • 持久化私有文件目录：调用getApplicationDocumentsDirectory()获取
  • 临时缓存目录：调用getTemporaryDirectory()获取
• 解压逻辑推荐使用纯Dart实现的archive包，不依赖原生平台权限，只要持有文件合法路径或字节流即可正常解压。

注意：私有目录内的文件仅当前应用可访问，应用卸载时会同步删除，适合不需要用户主动在系统文件管理器中查看的文件存储。

方案 2：公共目录存储（仅需申请最小必要权限） #

如果解压后的文件需要对用户可见、可在其他应用中打开，可写入公共存储的对应分类目录（下载、文档、相册等），仅需申请最小必要权限即可：

• Android 12及以下：仅申请android.permission.READ_EXTERNAL_STORAGE权限
• Android 13及以上：仅按需申请对应媒体权限（照片/视频/音频），写入下载、文档类公共目录无需额外申请写权限
• 写入公共目录时调用系统MediaStore API或存储访问框架（SAF）获取合法写入URI，不要直接使用旧版外部存储绝对路径。

常见适配失败原因排查 #

• 路径调用错误：确认实际操作的文件路径是否在合法可写区域，部分旧插件会默认硬编码外部存储根路径，需要手动替换为上述合法路径。
• 原生插件未适配分区存储：优先使用纯Dart实现的文件处理插件，避免依赖未适配API 30+规则的原生插件。

AndroidManifest.xml 权限配置参考 #

<!-- Android 12及以下读外部存储权限，不需要访问公共存储可删除 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- Android 13及以上按需申请对应媒体权限，不需要访问公共媒体可删除 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />

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