diff --git a/README.md b/README.md index 520b34b1391da4d7bce2dda8a024aaf6de6dd899..d907625f3a79e949865022cc931fa0fd4a8e34e5 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# File Mangaer Service公共文件管理服务 +# User_File_Manager公共文件管理 - [简介](#section1158716411637) - [目录](#section161941989596) @@ -9,18 +9,18 @@ ## 简介 -**File Mangaer Service**公共文件管理服务仓库提供了公共文件管理接口。File Mangaer Service接口暂不对外部应用开放, 仅内部使用。 +**User_File_Manager**公共文件管理提供了公共文件管理接口。 + +公共文件的管理由File Manager Service服务对接底层能力,如媒体库,外卡管理, +并为应用提供公共文件查询,创建的能力。 File Manager Service接口能力当前只对系统应用如文件选择器提供。 支持能力列举如下: -- 公共文件路径下媒体文件查询,创建 - 媒体文件包括图片,音频,视频。媒体文件通过相册方式呈现 - -- 公共文件路径下文档文件查询、创建 +- 公共文件路径下媒体文件查询,创建媒体文件包括图片,音频,视频。媒体文件通过相册方式呈现 - 文档文件包括其他文件,外部存储卡内的文件,文件以目录树方式呈现 +- 公共文件路径下文档文件查询、创建文档文件包括其他文件,外部存储卡内的文件,文件以目录树方式呈现 **图 1** 公共文件管理架构图 -![](figures/file manager service.png "公共文件管理架构图") +![](figures/user_file_manager.png "公共文件管理架构图") ## 目录 @@ -28,7 +28,7 @@ ``` /foundation/storage/user_file_manger # fms组件代码 ├── figures # 插图文件 -├── serivce # 框架代码 +├── serivce # 服务实现 │   ├── etc # 内部接口实现 │   ├── src # 内部接口实现 ├── interfaces # 接口代码 @@ -36,29 +36,17 @@ │   └── kits # 外部 JS 接口 ├── LICENSE # 证书文件 ├── ohos.build # 编译文件 -├── sa_profile # 服务配置文件 -└── services # 服务实现 +└── sa_profile # 服务配置文件 ``` ## 使用说明 ### 创建文件 -1. - 接口流程 - 应用通过接口让媒体库创建文件,返回文件uri, 应用自己通过openfile打开uri,获取fd进行文件操作。 - - // file picker 流程 - // media_path通过filepicker获取待保存目录uri - import filemanager from '@ohos.filemanager' - let media_path = "xxxx" - let name = "xxxx" - filemanager.createFile(name,media_path) - .then((uri) => { - // success - }) - .catch(function(err) { - //类型错误,重名... - // fail - }) - ``` - -## 相关仓 +1. 创建文件 + - 提供createFile接口,传入文件名与相册uri进行文件创建。 + - 文件创建成功后,可获得文件uri。应用可通过uri进行文件打开并进行读写操作。 +2. 查询文件 + - 提供listFile接口,传入文件类型,相册uri进行文件查询。 + - 获得相册下文件信息的集合,包括文件名,文件类型,文件大小,文件创建时间等信息 + +### 接口详细介绍请参考接口文档 + - [FMS接口介绍(待提供)](#接口详细介绍请参考接口文档) diff --git a/figures/file manager service.png b/figures/user_file_manager.png similarity index 100% rename from figures/file manager service.png rename to figures/user_file_manager.png