diff --git a/README_zh.md b/README_zh.md index a2c6dafb..32175e39 100644 --- a/README_zh.md +++ b/README_zh.md @@ -1,20 +1,22 @@ -# 公共文件服务 +# 公共文件访问框架 -## 简介 +## 简介 -公共文件服务提供公共文件访问和管理的服务接口。 +公共文件访问框架(FileAccessFramework)提供了一套公共文件访问和管理的接口。 -公共文件服务中File Manager Service服务向下对接底层文件管理服务,如媒体库、外卡管理。File Manager Service服务向上对接应用提供公共文件查询、创建的能力,如图1。 File Manager Service接口能力当前只对系统应用如文件选择器提供。 +公共文件访问框架中FileAccessFramework向下对接底层文件管理服务,如medialibrary、externalFileManager。FileAccessFramework向上对接应用,提供对公共文件操作的基础能力,如图1。 支持能力列举如下: -- 查询、创建公共文件路径下媒体文件。媒体文件包括图片、音频、视频。媒体文件通过相册方式呈现。 +- 查询、创建、删除、打开、移动、重命名用户公共文件路径下媒体文件和文档文件。媒体文件包括图片、音频、视频, 通过相册方式呈现。文档文件则以目录树方式呈现。 -- 查询、创建公共文件路径下文档文件。文档文件包括其他文件、外部存储卡内的文件。文件以目录树方式呈现。 +- 查询、创建、删除、打开、移动、重命名共享盘设备上的文件。文件以目录树方式呈现。 -**图 1** 公共文件管理架构图 -![](figures/user_file_manager.png "公共文件管理架构图") +- 查询、创建、删除、打开、移动、重命名外置存储设备上的文件。文件以目录树方式呈现。 -## 目录 +**图 1** 公共文件访问框架架构图 +![](figures/file_access_framework.png "公共文件访问框架架构图") + +## 目录 仓目录结构如下: ``` @@ -29,11 +31,18 @@ ├── BUILD.gn # 编译入口 └── bundle.json # 部件描述文件 ``` -## 说明 -### 使用说明 -1. 创建文件 - - 提供createFile接口,传入文件名与相册uri进行文件创建。 - - 文件创建成功后,可获得文件uri。应用可通过uri进行文件打开并进行读写操作。 -2. 查询文件 - - 提供listFile接口,传入文件类型、相册uri进行文件查询。 - - 获得相册下文件信息的集合,包括文件名、文件类型、文件大小、文件创建时间等信息。 + +## 约束 +接口支持情况:FileAccessFramework 所有接口目前仅支持文件管理器和文件选择器,且需要基于stage模型。 + +## 相关仓 +[媒体库服务](https://gitee.com/openharmony/multimedia_medialibrary_standard) +[存储管理服务](https://gitee.com/openharmony/filemanagement_storage_service) +[文件访问接口](https://gitee.com/openharmony/filemanagement_file_api) +[多用户管理](http:////gitee.com/openharmony/account_os_account) +[**公共文件访问框架**](https://gitee.com/openharmony/filemanagement_user_file_service) + + + + + diff --git a/figures/file_access_framework.png b/figures/file_access_framework.png new file mode 100644 index 00000000..c026a9ec Binary files /dev/null and b/figures/file_access_framework.png differ diff --git a/figures/user_file_manager.png b/figures/user_file_manager.png deleted file mode 100644 index 597ec2aa..00000000 Binary files a/figures/user_file_manager.png and /dev/null differ