HarmonyOS Next开发学习手册——Core File Kit（文件基础服务）

Core File Kit（文件基础服务）为开发者提供一套访问和管理应用文件和用户文件的能力。帮助用户更高效地管理、查找和备份各类文件，使用户能够轻松应对各种文件管理的需求。

Core File Kit概述

在Core File Kit套件中，按文件所有者的不同，有如下文件分类模型，其示意图如下面文件分类模型示意图：

• 应用文件 ：文件所有者为应用，包括应用安装文件、应用资源文件、应用缓存文件等。

• 用户文件 ：文件所有者为登录到该终端设备的用户，包括用户私有的图片、视频、音频、文档等。

• 系统文件：与应用和用户无关的其它文件，包括公共库、设备文件、系统资源文件等。这类文件不需要开发者进行文件管理，本文不展开介绍。

按文件系统管理的文件存储位置（数据源位置）的不同，有如下文件系统分类模型：

• 本地文件系统：提供本地设备或外置存储设备（如U盘、移动硬盘）的文件访问能力。本地文件系统是最基本的文件系统，本文不展开介绍。

• 分布式文件系统 ：提供跨设备的文件访问能力。所谓跨设备，指文件不一定存储在本地设备或外置存储设备，而是通过计算机网络与其它分布式设备相连。

图1 文件分类模型示意图

Kit使用场景

Core File Kit常见的使用场景：

• 应用文件访问和文件分享。
• 应用数据备份恢复。
• 选择与保存用户文件。
• 跨设备的文件访问和分享能力。

能力范围

• 支持对应用文件进行查看、创建、读写、删除、移动、复制、获取属性等访问操作。
• 支持应用文件上传到网络服务器和网络服务器下载网络资源文件到本地应用文件目录。
• 支持获取当前应用的存储空间大小、指定文件系统的剩余空间大小和指定文件系统的总空间大小。
• 支持应用分享文件给其它应用和使用其它应用分享的文件。
• 支持应用接入数据备份恢复，在接入后，应用可通过修改配置文件定制备份恢复框架的行为，包括是否允许备份恢复、备份哪些数据。
• 提供 用户文件访问框架 ，用于开发者访问和管理用户文件。例如选择与保存用户文件。
• 支持跨设备的文件访问和拷贝能力。

亮点/特征

• 沙箱隔离：
  访问和管理应用文件，对于每个应用，系统会在内部存储空间映射出一个专属的“ 应用沙箱目录 ”，它是“ 应用文件目录 ”与一部分