文件存储分外部存储和内部存储
- 内部存储
目录: /data/data
-
特点
- 每个应用独占一个以包名命名的私有文件夹
- 在应用卸载时被删除
- 对MediaScanner不可见
适用场景： 私密数据
相关API
| data/data/<包名>/ | 描述 |
|---|---|
| Context#getDir(String name,int mode):File! | 内部存储根目录下的文件夹(不存在则新建) |
| data/data/<包名>/files/ | 描述 |
|---|---|
| Context#getFilesDir():File! | files文件夹 |
| Context#fileList():Array<String!>! | 列举文件和文件夹 |
| Context#openFileInput(String name):FileInputStream! | 打开文件输入流(不存在则抛出FileNotFoundException) |
| Context#openFileOut(String name,int mode):FileOutputStream! | 打开文件输出流(文件不存在则新建) |
| Context#deleteFile(String name):Boolean! | 删除文件或文件夹 |
| data/data/<包名>/cache/ | 描述 |
|---|---|
| Context#getCacheDir():File! | cache文件夹 |
| data/data/<包名>/code_cache/ | 描述 |
|---|---|
| Context#getCodeCacheDir():File! | 存放优化过的代码(如JIT优化) |
| data/data/<包名>/no_backup/ | 描述 |
|---|---|
| Context#getNoBackUpFIlesDir():File! | 在Backup过程中被忽略的文件 |
-
外部存储
_20190810214356.jpg
-
私有目录：storage/emulated/0/Android/
- 每个应用独占以包名命名的私有文件夹
- 在应用卸载时被删除
- 对MediaScanner不可见（例外：多媒体文件夹 API 21）
- 适用场景：非私密数据，需要随应用卸载删除
-
公共目录：外部存储中除了私有目录外的其他空间
- 所有应用共享
- 在应用卸载时不会被删除
- 对MediaScanner可见
- 适用场景：非私密数据，不需要随应用卸载删除
相关API
公共目录：
| storage/emulated/0/ | 描述 |
|---|---|
| Environment.getExternalStorageDirectory():File? | 外部存储根目录 |
| Environment.getExternalStoragePublicDirectory(name:String?):File? | 外部存储根目录下的文件夹 |
| Environment.getExternalStorageState():String! | 外部存储状态 |
- 私有目录：
| storage/emulated/0/Android/data/<包名>/ | 描述 |
|---|---|
| Context.getExternalCacheDir():File? | cache文件夹 |
| Context.getExternalCacheDirs():Array<File!>! | 多部分cache文件夹(API 18) |
| Context.getExternalFilesDir(type: String?):File? | files文件夹 |
| Context.getExternalFIlesDirs(type:String?):Array<File!>! | 多部分files文件夹(API 18) |
| Context.getExternalMediaDirs():Array<File!>! | 多部分多媒体文件夹(API 21) |
- android:installLocation
- internalOnly（默认）：安装在内部存储，内部存储空间不足时无法安装
- 优先安装在内部存储，内部存储空间不足时，尝试安装在外部存储
- preferExternal：优先安装在外部存储，外部存储空间不足时，尝试安装在内部存储
- 查询
- File
val target = File(context.filesDir,"my-download")
target.freeSpace // 未分配容量（Root用户可用的容量）
target.usableSpace // 可用容量（非Root用户可用的容量）
target.totalSpace // 全部容量（包括已分配容量和未分配容量）
- StatFs（API 18
val target = File(context.filesDir,"my-download")
val stat = StatFs(target)
val blockSize = stat.blockSizeLong
stat.freeBlocksLong * blockSize // 同上
stat.availableBlocksLong * blockSize // 同上
stat.blockCountLong * blockSIze // 同上
- StorageManager（API 26）
val target = File(context.filesDir,"my-download")
val sm = getSystemService(Context.STORAGE_SERVICE) as StorageManager
val uuid = sm.getUuidForPath(target)
sm.getAllocatableBytes(uuid) // 当前应用的可用容量（包括可用容量和全部应用的缓存空间）
- StorageStatsManager（API 26）
val target = File(context.filesDir,"my-download")
val ssm = getSystemService(Context.STORAGE_STATS_SERVICE) as StorageStatsManager
val sm = getSystemService(Context.STORAGE_SERVICE) as StorageManager
val uuid = sm.getUuidForPath(target)
ssm.getFreeBytes(uuid) // 可用容量（非Root用户可用的容量）
ssm.getTotalBytes(uuid) // 完整的物理容量（比如64G）
- 分配
- sdk26以前
val target = File(context.filesDir,"my-download")
if(downloadSize <= target.getAvailableSpace()){
// 磁盘空间充足，可以写入
...
}
注意：即使判断磁盘空间充足，也可能在写入过程中抛出IOException（空间不足），因为无法避免多线程或多进程并发写入。
- 26开始
val target = File(context.filesDir,"my-download")
val sm = getSystemService(Context.STORAGE_SERVICE) as StorageManager
val uuid = sm.getUuidForPath(target)
if(downloadSize <= sm.getAllocatableBytes(uuid){
try(FileOutPutStream os = FileOutPutStream(target)){
// 预分配downloadSize大小的空间给当前应用
sm.allocateBytes(os.getFD(),downloadSize)
// 写入
...
}
}else{
// 空间不足，请求用户自行清理空间
val intent = Intent(StorageManager.ACTION_MANAGE_STORAGE);
intent.putExtra(StorageManager.EXTRA_UUID,uuid);
// 需要的空间
intent.putExtra(StorageManager.EXTRA_REQUESTED_BYTES,downloadSize);
context.tartActivityForResult(intent,REQUEST_CODE);
}
StorageManager#allocateBytes()可以避免了并发写入造成空间不足异常
