文件管理

文件管理概述

文件分类（考点）

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

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

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

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

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

文件分类模型示意图

Core File Kit（考点）

• 应用文件访问和文件分享。

• 应用数据备份恢复。

• 选择与保存用户文件。

• 跨设备的文件访问和分享能力。

• 支持对应用文件进行查看、创建、读写、删除、移动、复制、获取属性等访问操作。

• 支持应用文件上传到网络服务器和网络服务器下载网络资源文件到本地应用文件目录。

• 支持获取当前应用的存储空间大小、指定文件系统的剩余空间大小和指定文件系统的总空间大小。

• 支持应用分享文件给其它应用和使用其它应用分享的文件。

• 支持应用接入数据备份恢复，在接入后，应用可通过修改配置文件定制备份恢复框架的行为，包括是否允许备份恢复、备份哪些数据。

• 提供用户文件访问框架，用于开发者访问和管理用户文件。例如选择与保存用户文件。

• 支持跨设备的文件访问和拷贝能力。

@ohos.file.fs (文件管理)（考点）

• 该模块为基础文件操作API，提供基础文件操作能力，包括文件基本管理、文件目录管理、文件信息统计、文件流式读写等常用功能。

• import fs from '@ohos.file.fs';

例题

1. 分布式文件系统提供跨设备的文件访问能力。所谓跨设备，指文件存储在外置存储设备。

1. OpenHarmony 中文件管理功能支持应用接入数据备份恢复，在接入后，应用可通过修改配置文件定制备份恢复框架的行为，包括是否允许备份恢复、备份哪些数据。

应用文件（考点）！！！！！！

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

• 设备上应用所使用及存储的数据，以文件、键值对、数据库等形式保存在一个应用专属的目录内。该专属目录我们称为“应用文件目录”，该目录下所有数据以不同的文件格式存放，这些文件即应用文件。（考点）

• “应用文件目录”与一部分系统文件（应用运行必须使用的系统文件）所在的目录组成了一个集合，该集合称为“应用沙箱目录”，代表应用可见的所有目录范围。因此“应用文件目录”是在“应用沙箱目录”内的。

• 系统文件及其目录对于应用是只读的；应用仅能保存文件到“应用文件目录”下，根据目录的使用规范和注意事项来选择将数据保存到不同的子目录中。

应用沙箱目录（考点）

• 对于每个应用，系统会在内部存储空间映射出一个专属的“应用沙箱目录”，它是“应用文件目录”与一部分系统文件（应用运行必需的少量系统文件）所在的目录组成的集合。

• 应用沙箱限制了应用可见的数据的最小范围。在“应用沙箱目录”中，应用仅能看到自己的应用文件以及少量的系统文件（应用运行必需的少量系统文件）。因此，本应用的文件也不为其他应用可见，从而保护了应用文件的安全。（考点）

• 应用可以在“应用文件目录”下保存和处理自己的应用文件；系统文件及其目录对于应用是只读的；而应用若需访问用户文件，则需要通过特定API同时经过用户的相应授权才能进行。

应用沙箱路径（考点）

• 如下图所示，在普通应用（也称三方应用）视角下，不仅可见的目录与文件数量限制到了最小范围，并且可见的目录与文件路径也与系统进程等其他进程看到的不同。我们将普通应用视角下看到的“应用沙箱目录”下某个文件或某个具体目录的路径，称为“应用沙箱路径”。

• 一般情况下，开发者的hdc shell环境等效于系统进程视角，因此“应用沙箱路径”与开发者使用hdc工具调试时看到的真实物理路径不同，其对应关系详见应用沙箱路径和调试进程视角下的真实物理路径。

• 从实际物理路径推导物理路径与沙箱路径并不是1：1的映射关系，沙箱路径总是少于系统进程视角可见的物理路径。有些调试进程视角下的物理路径在对应的应用沙箱目录是无法找到的，而沙箱路径总是能够找到其对应的物理路径。（考点）

应用文件上传下载（考点）

• 应用可以将应用文件上传到网络服务器，也可以从网络服务器下载网络资源文件到本地应用文件目录。（考点）

• 开发者可以使用上传下载模块（ohos.request）的上传接口将本地文件上传。文件上传过程使用系统服务代理完成。

当前上传应用文件功能，仅支持上传应用缓存文件路径（cacheDir）下的文件。使用上传下载模块接口，需申请相关权限：ohos.permission.INTERNET。（考点）

• 开发者可以使用上传下载模块（ohos.request）的下载接口将网络资源文件下载到应用文件目录。对已下载的网络资源文件，开发者可以使用基础文件IO接口（ohos.file.fs）对其进行访问，使用方式与应用文件访问一致。文件下载过程使用系统服务代理完成。

当前网络资源文件仅支持下载至应用文件目录。使用上传下载模块接口，需申请相关权限：ohos.permission.INTERNET。（考点）

应用文件分享（考点）

• 基于URI分享方式，应用可分享单个文件，通过ohos.app.ability.wantConstant的wantConstant.Flags接口以只读或读写权限授权给其他应用。应用可通过ohos.file.fs的open()接口打开URI，并进行读写操作。当前OpenHarmony API 9仅支持临时授权，分享给其他应用的文件在被分享应用退出时权限被收回。

• 基于FD分享方式，应用可分享单个文件，通过ohos.file.fs的open接口以指定权限授权给其他应用。应用从Want中解析拿到FD后可通过ohos.file.fs的读写接口对文件进行读写。

文件URI格式（考点）

• file：文件URI的标志。

• bundleName：该文件资源的属主。

• path：文件资源在应用沙箱中的路径。

应用文件访问与管理（考点）

• 应用需要对应用文件目录下的应用文件进行查看、创建、读写、删除、移动、复制、获取属性等访问操作。开发者通过基础文件操作接口（ohos.file.fs）实现应用文件访问能力。

例题

用户文件

1. 用户文件存放在用户目录下，归属于该设备上登录的用户。

2. 用户文件存储位置主要分为内置存储、外置存储。

3. 应用对用户文件的创建、访问、删除等行为，需要提前获取用户授权，或由用户操作完成。

内置存储（考点）

• 用户特有的文件：这部分文件归属于登录该设备的用户，不同用户登录后，仅可看到该用户自己的文件。按照这些文件的特征/属性，以及用户/应用的使用习惯，可分为：
• 图片/视频类媒体文件
所具有的特征包括拍摄时间、地点、旋转角度、文件宽高等信息，以媒体文件的形式存储在系统中，通常是以所有文件、相册的形式对外呈现，不会展示其在系统中存储的具体位置。
• 音频类媒体文件
所具有的特征包括所属专辑、音频创作者、持续时间等信息，以媒体文件的形式存储在系统中，通常会以所有文件、专辑、作家等形式对外部呈现，不会展示其在系统中存储的具体位置。
• 其他文件（统称为文档类文件）
以普通文件的形式存储在系统中，该类文件既包括普通的文本文件、压缩文件等，又包括以普通文件形式存储的图片/视频、音频文件，该类文件通常是以目录树的形式对外展示。

• 多用户共享的文件：用户可以通过将文件放在共享文件区，实现多个用户之间文件的共享访问。
共享文件区的文件，也是以普通文件的形式存储在系统中，以目录树的形式对外展示。

外置存储

用户文件访问框架

• FilePicker：系统预置应用，提供文件访问客户端选择和保存文件的能力，且不需要配置任何权限。FilePicker的使用指导请参见选择用户文件。

• FileManager：系统预置应用，终端用户可通过系统文件管理器实现查看文件、修改文件、删除文件（目录）、重命名文件（目录）、移动文件（目录）、创建文件（目录）等操作。

• File Access Helper：提供给文件管理器和文件选择器访问用户文件的API接口，应用不可直接调用。

• File Access ExtensionAbility：提供文件访问框架能力，由内卡文件管理服务UserFileManager和外卡文件管理服务ExternalFileManager组成，实现对应的文件访问功能。

选择用户文件（FilePicker）

• PhotoViewPicker：适用于图片或视频类文件的选择与保存。

• DocumentViewPicker：适用于文档类文件的选择与保存。

• AudioViewPicker：适用于音频类文件的选择与保存。

保护用户文件

例题

1. 外置存储设备上的文件，全部以特殊文件的形式呈现，和内置存储设备上的文档类文件有所区别，采用目录树的形式对外展示。

1. FilePicker 为系统预置应用，提供文件访问客户端选择和保存文件的能力，需要配置文件访问权限。

分布式文件系统

分布式文件系统概述

• 两台设备组网，用户可以利用一台设备上的编辑软件编辑另外一台设备上的文档。

• 平板保存的音乐，车载系统直接可见并可播放。

• 户外拍摄的照片，回家打开平板直接访问原设备拍摄的照片。

分布式文件系统架构

• distributedfile_daemon：主要负责设备上线监听、通过软总线建立链路，并根据分布式的设备安全等级执行不同的数据流转策略。

• hmdfs：实现在内核的网络文件系统，包括缓存管理、文件访问、元数据管理和冲突管理等。
• 缓存管理
• 设备分布式组网后，hmdfs提供文件的互访能力，但不会主动进行文件数据传输和拷贝。如果应用需要将数据保存到本地，需主动拷贝。
• hmdfs保证Close-to-Open的一致性，即一端写关闭后，另外一端可以读取到最新数据，不保证文件内容的实时一致性。
• 数据在远端写入，但是由于网络原因未及时回刷，文件系统会在下次网络接入时回刷本地，但是如果远端已修改则无法回刷。

• 文件访问
• 文件访问接口与本地一致（ohos.file.fs）。
• 如果文件在本地，则堆叠访问本地文件系统。
• 如果文件在其他设备，则同步网络访问远端设备文件。

symlink：不支持。

• 元数据管理
• 分布式组网下，文件一端创建、删除、修改，另一端可以“立即”查看到最新文件，看到速度取决于网络情况。
• 远端设备离线后，该设备数据将不再在本端设备呈现。但由于设备离线的感知具有延迟，可能会造成部分消息4s超时，因此开发者需要考虑接口的网络超时或一些文件虽然可以看到，但实际设备可能已离线的场景。

• 冲突处理
• 本地与远端冲突 ，远端文件被重命名，看到的同名文件是本地同名文件，远端文件被重命名。
• 远端多个设备冲突，以接入本设备ID为顺序，显示设备ID小的同名文件，其他文件被依次重命名。
• 如果组网场景，目录树下已经有远端文件，创建同名文件，提示文件已存在。
• 冲突文件显示_conflict_dev后依次加id，id从1自动递增。
• 同名目录之间仅融合不存在冲突，文件和远端目录同名冲突，远端目录后缀加_remote_directory。

设置分布式文件数据等级

1. 对于不满足安全等级的文件，跨设备仍然可以看到该文件，但是无权限打开访问该文件。

2. 分布式文件系统的数据等级默认为S3，应用可以主动设置文件的安全等级。

跨设备文件访问