安卓原生开发中,文件存储方案的选择直接影响应用的性能、数据安全性与用户体验。内部存储、外部私有存储和外部公共存储三种模式在权限模型、生命周期和访问边界上存在根本差异——内部存储无需申请运行时权限但空间受限,外部私有存储空间充裕且随应用卸载自动清理,外部公共存储则需借助MediaStore或SAF才能安全访问。选错存储路径导致的典型后果包括:Android 10以上设备因分区存储限制而读写失败、敏感数据意外暴露给其他应用,以及用户卸载后残留大量垃圾文件。
内部存储是应用唯一无需任何权限即可完全掌控的存储区域,适合存放敏感配置、小型缓存和数据库文件。
调用context.filesDir获取的路径位于/data/data/<包名>/files/下,应用卸载时该目录连同cacheDir、databases等子目录会被系统一并清除。这一特性决定了内部存储的定位:与用户账号强绑定、不具备跨应用共享价值的私有数据。
具体适用场景包括:
需要注意,内部存储的空间与设备整体可用空间共享,但没有硬性配额保护。如果应用在cacheDir中堆积大量临时文件而不主动清理,用户可能在系统设置中看到该应用占用异常。Android系统在存储空间紧张时会清理cacheDir,但开发者不应依赖这一机制作为唯一保障。
val file = File(context.filesDir, "user_token.dat")
file.outputStream().use { stream ->
stream.write(encryptedBytes)
}
外部私有存储通过context.getExternalFilesDir()访问,空间远大于内部存储且无需运行时权限,但数据并非绝对私有。
在Android 10引入分区存储之前,外部私有目录位于/sdcard/Android/data/<包名>/files/。分区存储实施后,该路径在应用视角下仍可自由读写,无需申请READ_EXTERNAL_STORAGE权限。然而与内部存储不同的是,具备MANAGE_EXTERNAL_STORAGE权限的文件管理器应用或通过ADB调试的开发者仍能访问这些文件。
因此外部私有存储适合存放体积较大、对保密性要求不极端的文件:
外部存储的可移除特性带来一个隐患:当用户弹出SD卡时,应用进程可能因文件句柄失效而崩溃。开发者需要在访问前调用Environment.getExternalStorageState()检查介质状态,并在onPause或onStop中及时关闭文件流。
| 对比维度 | 内部存储 | 外部私有存储 | 外部公共存储 |
|---|---|---|---|
| 访问路径 | filesDir / cacheDir | getExternalFilesDir() | MediaStore / SAF |
| 运行时权限 | 无需 | 无需 | Android 10以下需要 |
| 卸载时清理 | 自动清除 | 自动清除 | 文件保留 |
| 其他应用可见 | 不可见 | 受限可见 | 完全可见 |
外部公共存储是唯一能让文件在应用卸载后依然保留、且可被其他应用读取的区域,但直接使用File API写入已被Android 10以上的分区存储机制禁止。
过去通过Environment.getExternalStorageDirectory()拼接路径写入/sdcard/Download/或/sdcard/Pictures/的方式,在目标版本为Android 10及以上时会在文件创建阶段抛出FileNotFoundException或返回EROFS错误。取而代之的是两条路径:
ContentResolver.insert()向MediaStore.Images.Media.EXTERNAL_CONTENT_URI插入记录,获得Uri后写入字节流。系统自动归类到相册对应目录,无需权限。Intent.ACTION_CREATE_DOCUMENT让用户选择保存位置,应用获得持久化的Uri授权。用户可随时通过系统设置撤销该授权。MediaStore的写入流程如下:
val values = ContentValues().apply {
put(MediaStore.Images.Media.DISPLAY_NAME, "photo.jpg")
put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg")
put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES)
}
val uri = contentResolver.insert(
MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values
)
uri?.let {
contentResolver.openOutputStream(it)?.use { os ->
bitmap.compress(Bitmap.CompressFormat.JPEG, 90, os)
}
}
SAF的核心优势在于用户授权粒度精细,应用只能访问用户明确指定的文件或目录,无法遍历整个外部存储。这对用户隐私保护是显著改进,代价是开发复杂度上升——应用需要在onActivityResult中处理返回的Uri,并通过takePersistableUriPermission()持久化授权以避免重启后失效。
Android 10引入的分区存储是安卓文件存储方案中兼容性问题最集中的环节,requestLegacyExternalStorage标志在Android 11及以上已完全失效。
开发者在适配过程中频繁遇到的几个问题值得单独梳理:
/sdcard/MyApp/data.txt的路径在分区存储下不再合法。应改用MediaStore或SAF,或迁移至外部私有存储。ContentResolver的notifyChange()方法或插入时正确设置IS_PENDING标志。WRITE_EXTERNAL_STORAGE并设置maxSdkVersion为28,却未处理Android 10以上的运行时逻辑分支。针对多版本兼容,推荐采用运行时分支策略:在Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q时走MediaStore/SAF路径,在更低版本上回退到File API并申请传统存储权限。这种显式判断比依赖requestLegacyExternalStorage更可靠,也避免了在Android 11上因标志失效而产生意外行为。
文件存储路径的选择不是单纯的技术偏好问题,而是与数据生命周期、隐私合规和用户体验强绑定的架构决策。在应用设计初期就明确哪些数据属于私有、哪些需要共享、哪些必须持久保留,远比在适配阶段反复打补丁高效。
评论
加载中...