# storage_user_file_manger

#### Description
{**When you're done, you can delete the content in this README and update the file with details for others getting started with your repository**}

#### Software Architecture
Software architecture description

#### Installation

1.  xxxx
2.  xxxx
3.  xxxx

#### Instructions

1.  xxxx
2.  xxxx
3.  xxxx

#### Contribution

1.  Fork the repository
2.  Create Feat_xxx branch
3.  Commit your code
4.  Create Pull Request


#### Gitee Feature

1.  You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md
2.  Gitee blog [blog.gitee.com](https://blog.gitee.com)
3.  Explore open source project [https://gitee.com/explore](https://gitee.com/explore)
4.  The most valuable open source project [GVP](https://gitee.com/gvp)
5.  The manual of Gitee [https://gitee.com/help](https://gitee.com/help)
6.  The most popular members  [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)

# 公共文件访问框架

## 简介

公共文件访问框架(FileAccessFramework)提供了一套公共文件访问和管理的接口。

公共文件访问框架中FileAccessFramework向下对接底层文件管理服务，如medialibrary、externalFileManager。FileAccessFramework向上对接应用，提供对公共文件操作的基础能力，如图1。

支持能力列举如下：
- 查询、创建、删除、打开、移动、重命名用户公共文件路径下媒体文件和文档文件。媒体文件包括图片、音频、视频, 通过相册方式呈现。文档文件则以目录树方式呈现。

- 查询、创建、删除、打开、移动、重命名共享盘设备上的文件。文件以目录树方式呈现。

- 查询、创建、删除、打开、移动、重命名外置存储设备上的文件。文件以目录树方式呈现。

**图 1**  公共文件访问框架架构图
![](figures/file_access_framework.png "公共文件访问框架架构图")

## 目录

仓目录结构如下:
```
/foundation/storage/user_file_service
├── figures                                     # 插图文件
├── frameworks                                  # 部件无独立进程的实现
│   └──js                                       # JS API的实现
│      └── napi                                 # 通过napi封装的JS接口代码实现
├── interfaces                                  # 接口
│   ├── inner_api                               # 系统内部件间接口
│   └── kits                                    # 应用接口
├── service                                     # 服务实现
├── test                                        # 测试代码
├── BUILD.gn                                    # 编译入口
└── bundle.json                                 # 部件描述文件
```

## 约束
接口支持情况：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)