文件存储分外部存储和内部存储

内部存储

目录: /data/data

特点

每个应用独占一个以包名命名的私有文件夹

在应用卸载时被删除

对MediaScanner不可见

适用场景: 私密数据

相关API

data/data//

描述

Context#getDir(String name,int mode):File!

内部存储根目录下的文件夹(不存在则新建)

data/data//files/

描述

Context#getFilesDir():File!

files文件夹

Context#fileList():Array!

列举文件和文件夹

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!

多部分cache文件夹(API 18)

Context.getExternalFilesDir(type: String?):File?

files文件夹

Context.getExternalFIlesDirs(type:String?):Array!

多部分files文件夹(API 18)

Context.getExternalMediaDirs():Array!

多部分多媒体文件夹(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()可以避免了并发写入造成空间不足异常