如何开发可携带文件并支持提取至内部存储的Android应用？

核心思路 #

把assets或raw目录下的文件复制到外部公共存储目录（比如Download、Documents），这些目录属于用户可自由访问的区域，应用卸载后文件不会被删除。

具体实现步骤 #

1. 申请存储权限 #

• Android 10及以上：无需申请READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE，但写入公共目录需在AndroidManifest.xml中添加：

  <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
                   android:minSdkVersion="30"
                   tools:ignore="ScopedStorage" />
  

  注意：该权限需引导用户手动前往应用设置页面开启。
• Android 9及以下：需动态申请WRITE_EXTERNAL_STORAGE权限。

2. 复制文件的工具方法 #

从Assets目录复制

fun copyAssetToExternalStorage(context: Context, assetFileName: String, destPath: String) {
    try {
        context.assets.open(assetFileName).use { inputStream ->
            FileOutputStream(destPath).use { outputStream ->
                val buffer = ByteArray(1024)
                var length: Int
                while (inputStream.read(buffer).also { length = it } > 0) {
                    outputStream.write(buffer, 0, length)
                }
            }
        }
    } catch (e: IOException) {
        e.printStackTrace()
    }
}

从Raw目录复制

fun copyRawToExternalStorage(context: Context, rawResId: Int, destPath: String) {
    try {
        context.resources.openRawResource(rawResId).use { inputStream ->
            FileOutputStream(destPath).use { outputStream ->
                val buffer = ByteArray(1024)
                var length: Int
                while (inputStream.read(buffer).also { length = it } > 0) {
                    outputStream.write(buffer, 0, length)
                }
            }
        }
    } catch (e: IOException) {
        e.printStackTrace()
    }
}

3. 确定目标存储路径 #

获取公共存储的Download目录路径：

val destDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)
val destFile = File(destDir, "your_target_file.txt")
val destPath = destFile.absolutePath

4. 触发复制操作 #

• 自动复制：在应用首次启动时执行，先判断目标文件是否存在，避免重复复制：

  override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      setContentView(R.layout.activity_main)
  
      val destFile = File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS), "sample.txt")
      if (!destFile.exists()) {
          copyAssetToExternalStorage(this, "sample.txt", destFile.absolutePath)
          // 若从raw复制：copyRawToExternalStorage(this, R.raw.sample, destFile.absolutePath)
      }
  }
  

• 手动复制：添加按钮，点击时执行复制逻辑，同时给用户提示复制结果。

5. 用户访问文件 #

复制完成后，用户可通过系统文件管理器在对应公共目录（如Download）找到文件，直接进行打开、分享或编辑操作。

注意事项 #

• 复制前检查目标文件是否已存在，避免重复操作浪费资源。
• 处理复制过程中的异常（如存储空间不足、权限被拒），给出友好提示。
• Android 10+建议优先使用公共目录，避免应用私有外部存储（卸载时会被删除）。

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