filemanagement_user_file_service/README_zh.md

公共文件服务

简介

公共文件服务提供公共文件访问和管理的服务接口。

公共文件服务中File Manager Service服务向下对接底层文件管理服务，如媒体库、外卡管理。File Manager Service服务向上对接应用提供公共文件查询、创建的能力，如图1。 File Manager Service接口能力当前只对系统应用如文件选择器提供。

支持能力列举如下：

• 查询、创建公共文件路径下媒体文件。媒体文件包括图片、音频、视频。媒体文件通过相册方式呈现。

• 查询、创建公共文件路径下文档文件。文档文件包括其他文件、外部存储卡内的文件。文件以目录树方式呈现。

图 1 公共文件管理架构图

目录

仓目录结构如下:

/foundation/storage/user_file_service
├── figures                                     # 插图文件
├── service                                     # 服务实现
│   ├── etc                                     # 内部接口实现
│   ├── src                                     # 内部接口实现
├── interfaces                                  # 接口代码
│   ├── innerkits                               # 内部 Native 接口
│   └── kits                                    # 外部 JS 接口
├── BUILD.gn                                    # 编译入口
└── bundle.json                                 # 部件描述文件

说明

使用说明

1. 创建文件
   • 提供createFile接口，传入文件名与相册uri进行文件创建。
   • 文件创建成功后，可获得文件uri。应用可通过uri进行文件打开并进行读写操作。
2. 查询文件
   • 提供listFile接口，传入文件类型、相册uri进行文件查询。
   • 获得相册下文件信息的集合，包括文件名、文件类型、文件大小、文件创建时间等信息。