如何在Android 13（API 33）上通过Flutter(Dart)保存各类文件？

针对Android 13（API 33）中无法通过传统外部存储路径保存.pdf、.zip、.xls等非媒体文件的问题，以下是符合Google Play政策且兼容多版本的两种核心解决方案：

一、应用专属外部存储（无需权限，优先推荐） #

如果文件仅用于你的应用自身使用（卸载后可删除），这是最优选择——不需要申请任何存储权限，Android 10及以上版本都支持：

• 获取应用专属目录并写入文件的示例代码（Kotlin）：

  // 获取应用专属外部存储的Documents子目录，也可换成DIRECTORY_DOWNLOADS等其他目录
  val appSpecificDir = context.getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS)
  val targetFile = File(appSpecificDir, "sample.pdf")
  // 写入文件字节流
  targetFile.writeAsBytes(fileBytes)
  

• 优势：无需权限申请，代码简单，完全符合系统权限规则

二、存储访问框架(SAF)（用户自主选择保存位置） #

如果需要让用户指定文件保存位置，或文件需要被其他应用访问，使用SAF是唯一合规的方式：

实现步骤： #

1. 构造文件保存选择器Intent：

   val saveIntent = Intent(Intent.ACTION_CREATE_DOCUMENT).apply {
       addCategory(Intent.CATEGORY_OPENABLE)
       // 根据文件类型设置对应MIME：
       // PDF: "application/pdf"，ZIP: "application/zip"，XLS: "application/vnd.ms-excel"
       type = "application/pdf"
       // 设置默认文件名
       putExtra(Intent.EXTRA_TITLE, "my_document.pdf")
   }
   

2. 使用Activity Result API处理返回结果（AndroidX推荐方式）：

   // 注册结果回调
   val saveFileLauncher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
       if (result.resultCode == Activity.RESULT_OK) {
           result.data?.data?.let { uri ->
               // 通过ContentResolver写入文件
               context.contentResolver.openOutputStream(uri)?.use { outputStream ->
                   outputStream.write(fileBytes)
               }
           }
       }
   }
   
   // 启动文件选择器
   saveFileLauncher.launch(saveIntent)
   

• 优势：完全符合Google Play权限政策，用户自主控制文件位置，支持跨应用访问文件

关键注意事项 #

• 绝对不要使用MANAGE_EXTERNAL_STORAGE权限：该权限仅开放给文件管理器、备份工具等特定类应用，普通应用提交Google Play会被拒绝上架
• 放弃传统外部存储根目录路径：Android 10及以上已经限制了对外部存储根目录的直接读写，API 33彻底移除了WRITE_EXTERNAL_STORAGE权限的作用
• 匹配正确的MIME类型：在SAF Intent中设置准确的MIME类型，能帮助系统过滤合适的保存位置和关联应用

内容的提问来源于stack exchange，提问作者Nring Cham Aung