1# 应用及文件系统空间统计
2
3在系统中，可能出现系统空间不够或者cacheDir等目录受系统配额限制等情况，需要应用开发者关注系统剩余空间，同时控制应用自身占用的空间大小。
4
5## 接口说明
6
7API的详细介绍请参见[ohos.file.statvfs](../reference/apis-core-file-kit/js-apis-file-statvfs.md)、[ohos.file.storageStatistics](../reference/apis-core-file-kit/js-apis-file-storage-statistics.md)。
8
9**表1** 文件系统空间和应用空间统计
10
11| 模块 | 接口名 | 功能 |
12| -------- | -------- | -------- |
13| \@ohos.file.storageStatistics | getCurrentBundleStats | 获取当前应用的存储空间大小（单位为Byte）。 |
14| \@ohos.file.statvfs | getFreeSize | 获取指定文件系统的剩余空间大小（单位为Byte）。 |
15| \@ohos.file.statvfs | getTotalSize | 获取指定文件系统的总空间大小（单位为Byte）。 |
16
17**表2** 应用空间统计
18
19| BundleStats属性 | 含义 | 统计路径 |
20| -------- | -------- | -------- |
21| appSize | 应用安装文件大小（单位为Byte） | 应用安装文件保存在以下目录：<br/>/data/storage/el1/bundle |
22| cacheSize | 应用缓存文件大小（单位为Byte） | 应用的缓存文件保存在以下目录：<br/>/data/storage/el1/base/cache<br/>/data/storage/el1/base/haps/entry/cache<br/>/data/storage/el2/base/cache<br/>/data/storage/el2/base/haps/entry/cache |
23| dataSize | 应用文件存储大小（除应用安装文件和缓存文件）（单位为Byte） | 应用文件由本地文件、分布式文件以及数据库文件组成。<br/>本地文件保存在以下目录（注意缓存文件目录为以下目录的子目录）：<br/>/data/storage/el1/base<br/>/data/storage/el2/base<br/>分布式文件保存在以下目录：<br/>/data/storage/el2/distributedfiles<br/>数据库文件保存在以下目录：<br/>/data/storage/el1/database<br/>/data/storage/el2/database |
24
25## 开发示例
26
27- 获取文件系统数据分区剩余空间大小。
28
29  ```ts
30  import { statfs } from '@kit.CoreFileKit';
31  import { BusinessError } from '@kit.BasicServicesKit';
32  import { common } from '@kit.AbilityKit';
33
34  let context = getContext(this) as common.UIAbilityContext;
35  let path = context.filesDir;
36  statfs.getFreeSize(path, (err: BusinessError, number: number) => {
37    if (err) {
38      console.error(`Invoke getFreeSize failed, code is ${err.code}, message is ${err.message}`);
39    } else {
40      console.info(`Invoke getFreeSize succeeded, size is ${number}`);
41    }
42  });
43  ```
44
45- 获取当前应用的存储空间大小。
46
47  ```ts
48  import { storageStatistics } from '@kit.CoreFileKit';
49  import { BusinessError } from '@kit.BasicServicesKit';
50
51  storageStatistics.getCurrentBundleStats((err: BusinessError, bundleStats: storageStatistics.BundleStats) => {
52    if (err) {
53      console.error(`Invoke getCurrentBundleStats failed, code is ${err.code}, message is ${err.message}`);
54    } else {
55      console.info(`Invoke getCurrentBundleStats succeeded, appsize is ${bundleStats.appSize}`);
56    }
57  });
58  ```
59